Skip to content
roasOS API
Esc
↑↓navigate↵open⌘Jpreview

List platform capabilities

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

GET/v1/capabilities
Query parameters
includestring
Public returns launch-ready operations. Available includes runtime-callable internal operations. All also includes planned, blocked, and unavailable operations.
default: "public"
Allowed:publicavailableall
Responses
200Versioned capability manifest
dataobjectrequired
Show properties
schema_versionstringrequired
Allowed:roasos.capability-manifest@1
manifest_versionstringrequired
Allowed:platform-capabilities@2026-07-17.v10
boundarystringrequired
Allowed:public_api
pricing_versionstringrequired
min length 1 · max length 200
capabilitiesobject[]required
max items 500
Show properties
Array of object
idstringrequired
matches ^[a-z][a-z0-9.-]*@[1-9][0-9]*$
titlestringrequired
min length 1 · max length 200
descriptionstringrequired
min length 1 · max length 2000
domainstringrequired
Allowed:platformgenerationsceneavataraccountdiscoverresearch
availabilitystringrequired
Allowed:availableunavailableplannedblocked
releaseobjectrequired
Show properties
runtimeStatusstringrequired
Allowed:availableunavailableplannedblocked
launchReadinessstringrequired
Allowed:readyconditionalblocked
exposurestringrequired
Allowed:publicinternaldeferred
executionstringrequired
Allowed:syncasync
requiredScopesstring[]required
min items 1 · max items 10
riskobjectrequired
Show properties
readOnlybooleanrequired
paidbooleanrequired
destructivebooleanrequired
humanApprovalRecommendedbooleanrequired
billingobjectrequired
Show properties
behaviorstringrequired
Allowed:includeddynamicunpriced
authoritystringrequired
min length 1 · max length 200
pricingVersionstring | nullrequired
min length 1 · max length 200
restobject[]required
min items 1 · max items 10
Show properties
Array of object
methodstringrequired
Allowed:GETPOSTDELETE
pathstringrequired
matches ^\/v1\/
operationIdstringrequired
matches ^[a-z][A-Za-z0-9]*$
statusstringrequired
Allowed:availableunavailableplannedblocked
mcpobject | nullrequired
Show properties
toolstringrequired
matches ^roasos_[a-z0-9_]+$
statusstringrequired
Allowed:availableplanned
modelsstring[]
max items 200
constraintsobject
policiesobject
Show properties
catalogVersionstringrequired
min length 1 · max length 200
mediaPolicyIdstringrequired
matches ^media\.[a-z0-9-]+@[1-9][0-9]*$
trustPolicyIdstringrequired
matches ^trust\.[a-z0-9-]+@[1-9][0-9]*$
lifecyclePolicyIdstringrequired
matches ^lifecycle\.[a-z0-9-]+@[1-9][0-9]*$
financePolicyIdstringrequired
matches ^finance\.[a-z0-9-]+@[1-9][0-9]*$
contractsobject
Show properties
inputSchemastring | nullrequired
matches ^[a-z][a-z0-9_]*$
outputSchemastringrequired
matches ^[a-z][a-z0-9_]*$
errorSchemastringrequired
Allowed:error_response
unavailableReasonstring
min length 1 · max length 2000
contractsobjectrequired
Show properties
contract_versionstringrequired
min length 1 · max length 200
intent_fingerprint_versionstringrequired
min length 1 · max length 200
schemasobjectrequired
examplesobjectrequired
400Invalid include filter
errorobjectrequired
Show properties
codestringrequired
min length 1 · max length 128
messagestringrequired
min length 1 · max length 2000
retryablebooleanrequired
request_idstring<uuid>required
balanceinteger
min 0
requiredinteger
min 0
fieldstring
min length 1 · max length 512
statestring
min length 1 · max length 128
retryWithNewKeyboolean
parameterstring
min length 1 · max length 128
allowedstring[]
max items 100
Request
curl -X GET "https://api.roasos.com/v1/capabilities"
Response
{
  "data": {
    "schema_version": "roasos.capability-manifest@1",
    "manifest_version": "platform-capabilities@2026-07-17.v10",
    "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": {},
        "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": {},
      "examples": {}
    }
  }
}