AgentConnect
Agents

List capability requests

Lists the requests agents made for something they lack — a setting, an MCP server, a skill, repository access, a connection or an MCP server header — newest first, at most 200, for the agents the caller can see. Filter by agentId and status. Each carries what was asked, the agent’s reason as untrusted plain text, the conversations waiting for it and what the caller may do with it.

GET
/v1/orgs/{orgId}/capability-requests

授权

bearerAuth
授权Bearer <token>

位置: header

路径参数

orgId*string

查询参数

agentId?string
匹配^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
格式uuid
status?string

值于

  • "open"
  • "completed"
  • "declined"
  • "expired"
  • "withdrawn"

响应主体

application/json

curl -X GET "https://example.com/v1/orgs/string/capability-requests"
{  "requests": [    {      "id": "string",      "orgId": "string",      "agentId": "string",      "agentName": "string",      "kind": "agent-settings",      "target": "string",      "want": {        "property1": null,        "property2": null      },      "summary": "string",      "reason": "string",      "status": "open",      "generation": -9007199254740991,      "createdAt": "string",      "expiresAt": "string",      "settledAt": "string",      "settledBy": {        "kind": "console",        "userId": "string",        "name": "string"      },      "outcome": "string",      "differs": true,      "note": "string",      "origins": [        {          "sessionId": "string",          "platform": "string",          "placeLabel": "string",          "external": true,          "askers": [            {              "kind": "console",              "userId": "string",              "name": "string",              "platform": "string"            }          ],          "nobody": true,          "askedAt": "string",          "wake": "none",          "wakeReason": "string"        }      ],      "current": {        "property1": null,        "property2": null      },      "warnings": [        "string"      ],      "viewer": {        "canComplete": true,        "canDecline": true,        "canReopen": true,        "canForward": true,        "missing": "string",        "whoCan": [          {            "userId": "string",            "name": "string"          }        ]      }    }  ]}