Context Engine overview

Returns Context Engine availability, package and provider counts, freshness posture, supported read capabilities, and recent governed packages.

GET/api/v1/context-engine

Authorization

context-engine:readapi key scoperequired

Required scope when calling with an API key.

Query parameters

project_idstringoptional

Limit counts and recent packages to this project UUID.

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

engagement_idstringoptional

Limit counts and recent packages to this commercial engagement UUID.

Request

GET /api/v1/context-engine

curl -X GET "https://www.digitalstack360.com/api/v1/context-engine?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": {
    "status": "available",
    "packageCount": 12,
    "providerCount": 5,
    "freshness": {
      "ready": 10,
      "stale": 1,
      "superseded": 1
    },
    "capabilities": [
      "natural_language_query",
      "structured_search",
      "packages",
      "evidence",
      "provenance",
      "coverage",
      "providers"
    ],
    "recentPackages": []
  }
}

Errors

401

missing_auth

No credentials provided

401

invalid_api_key

API key is invalid or revoked

403

scope_insufficient

Key lacks context-engine:read scope