List design agent clients

GET/v1/design/agent-clients

Signed-in sessionLaunch key product.designOperation design_agent_clients_list

An internal tool for design rules and components that agents synthesize, review and promote, with evaluation runs to check them.

Query parameters

cursorstring
expectedAuthorizationVersionstring
limitnumber

Returns

itemsobject[] | nullRequired
permission"not_permitted" | "permitted"Required
nextCursornull | null | stringRequired
accountIdstringRequired
serviceTenancyIdstringRequired
authorizationVersionstringRequired
evaluatedAtnumberRequired

Errors

400, 401, 403, 404, 409, 429 and 503 return {"error": {"code", "message", "correlationId"}}.

GET/v1/design/agent-clients

curl "$SPECIFY_API_ORIGIN/v1/design/agent-clients" \
  -H "Authorization: Bearer $SPECIFY_SESSION_TOKEN" \
  -H "X-Specify-Account-Id: <accountId>" \
  -H "X-Specify-Service-Tenancy-Id: <serviceTenancyId>"

Response

{
  "result": {
    "items": [
      {
        "clientId": "<clientId>",
        "name": "<name>",
        "scopes": [
          "answer:design_clarifications"
        ],
        "designPurpose": "design_evaluation",
        "expiresAt": 1,
        "lastInitializedAt": "<lastInitializedAt>"
      }
    ],
    "permission": "not_permitted",
    "nextCursor": "<nextCursor>",
    "accountId": "<accountId>",
    "serviceTenancyId": "<serviceTenancyId>",
    "authorizationVersion": "<authorizationVersion>",
    "evaluatedAt": 1
  }
}

List design agent clients

Headers

Query parameters

Returns

Errors