Guest Machines
API referenceCapabilities

Retrieve platform capabilities

GET/api/v1/capabilities

Retrieve the compact feature-negotiation document for the supported public API. Use it to disable integration features the platform does not currently expose rather than discovering that limitation during a run.

Required access

Credentials: service principal, delegated token, user session

Authorization

AuthorizationBearer <token>

An organization-owned automation key, prefixed gsmc_sk_. Already bound to one organization, so it needs no X-Org-Id header. It carries no user identity: it never reaches a private resource however it is scoped, and a run it starts has no user for an interactive tool to reach.

In: header

Header Parameters

X-Org-Id?|

Selects the active organization for a credential that belongs to more than one. Service-principal keys are bound to a single organization and ignore it.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/api/v1/capabilities" \  -H "Authorization: Bearer $GUEST_MACHINES_API_KEY"
{  "models": {    "catalog": true,    "per_model_capabilities": true,    "lifecycle_status": true,    "hosted_mcp_available": true  },  "tools": {    "catalog": true,    "search": true,    "namespaces": true,    "caller_visible_assignments": true  },  "runs": {    "event_stream": true,    "replayable_events": true,    "progress_snapshot": true,    "plan_controls": true,    "response_deltas": false,    "api_interactions": true,    "api_user_input": true,    "api_tool_approval": true,    "live_steering": false  },  "artifacts": {    "output_access": true,    "input_handoff": true,    "upload": false  },  "configuration": {    "delegated_agent_create_update": true,    "delegated_team_create_update": true,    "delegated_team_member_replace": true,    "delegated_pipeline_create_update": true,    "delete": false,    "agent_revision_restore": false  },  "workforces": {    "saved_teams": true,    "ad_hoc_members": false  },  "webhook_delivery": {    "contract_version": 1,    "hmac_sha256": true,    "max_delivery_attempts": 1,    "max_payload_bytes": 1,    "subscribable_events": [      "pipeline.completed"    ],    "test_event": "string"  }}
{  "detail": "string",  "error_code": "string",  "request_id": "string"}
{  "detail": "string",  "error_code": "string",  "request_id": "string"}
{  "detail": "string",  "error_code": "string",  "request_id": "string"}
{  "detail": "string",  "error_code": "string",  "request_id": "string"}
{  "detail": "string",  "error_code": "string",  "request_id": "string"}