roasOS
API referenceCapabilities

List platform capabilities

Returns the canonical public-API capability manifest. By default only currently available operations are returned.

GET
/v1/capabilities

Returns the canonical public-API capability manifest. By default only currently available operations are returned.

Authorization

bearerAuth
AuthorizationBearer <token>

API key authentication. Use your API key as the bearer token: Authorization: Bearer roasos_sk_...

In: header

Query Parameters

include?string

Public returns launch-ready operations. Available includes runtime-callable internal operations. All also includes planned, blocked, and unavailable operations.

Default"public"

Value in

  • "public"
  • "available"
  • "all"

Response Body

application/json

application/json

curl -X GET "https://example.com/v1/capabilities"
{  "data": {    "schema_version": "roasos.capability-manifest@1",    "manifest_version": "platform-capabilities@2026-11-09.v24",    "boundary": "public_api",    "pricing_version": "string",    "capabilities": [      {        "id": "string",        "title": "string",        "description": "string",        "domain": "platform",        "availability": "available",        "release": {          "runtimeStatus": "available",          "launchReadiness": "ready",          "exposure": "public"        },        "execution": "sync",        "requiredScopes": [          "api:read"        ],        "risk": {          "readOnly": true,          "paid": true,          "destructive": true,          "humanApprovalRecommended": true        },        "billing": {          "behavior": "included",          "authority": "string",          "pricingVersion": "string"        },        "rest": [          {            "method": "GET",            "path": "string",            "operationId": "string",            "status": "available"          }        ],        "mcp": {          "tool": "string",          "status": "available"        },        "models": [          "string"        ],        "constraints": {          "property1": "string",          "property2": "string"        },        "policies": {          "catalogVersion": "string",          "mediaPolicyId": "string",          "trustPolicyId": "string",          "lifecyclePolicyId": "string",          "financePolicyId": "string"        },        "contracts": {          "inputSchema": "string",          "outputSchema": "string",          "errorSchema": "error_response"        },        "unavailableReason": "string"      }    ],    "contracts": {      "contract_version": "string",      "intent_fingerprint_version": "string",      "schemas": {        "property1": {          "property1": null,          "property2": null        },        "property2": {          "property1": null,          "property2": null        }      },      "examples": {        "property1": null,        "property2": null      }    }  }}