Search structured context

Searches governed persisted context by term, summary, contribution type, and proposal key. This is deterministic retrieval, not arbitrary model execution.

GET/api/v1/context-engine/search

Authorization

context-engine:readapi key scoperequired

Required scope when calling with an API key.

Query parameters

querystringrequired

Search text

Example: rollout terminology

limitnumberoptional

Maximum results, 1–100

Example: 25

contribution_typestringoptional

Exact contribution-type filter

providerstringoptional

Exact provider/promoter filter

statusstringoptional

Package status filter

project_idstringoptional

Only packages linked through adoption workspace to this project UUID.

Example: 24ea6df2-7f4c-4c32-9fc1-6c8a0cb5b4b2

engagement_idstringoptional

Only packages linked through project to this commercial engagement UUID.

Request

GET /api/v1/context-engine/search

curl -X GET "https://www.digitalstack360.com/api/v1/context-engine/search?query=rollout terminology&project_id=24ea6df2-7f4c-4c32-9fc1-6c8a0cb5b4b2" \
  -H "Authorization: Bearer $DS_API_KEY"

Examples use a placeholder key from your environment. Store your key in $DS_API_KEY — never commit it.

Response

200 OK

{
  "data": [
    {
      "score": 2,
      "package": {
        "id": "9c9f22ac-8b6a-4a72-8145-9d1714f8af52",
        "status": "ready",
        "term": "Retail rollout"
      }
    }
  ],
  "meta": {
    "query": "rollout terminology",
    "total_count": 1,
    "truncated": false
  }
}

Errors

401

missing_auth

No credentials provided

401

invalid_api_key

API key is invalid or revoked

400

invalid_request

query is empty or limit is invalid

403

scope_insufficient

Key lacks context-engine:read scope