Security inventory

GET/v1/security/devices

Signed-in sessionLaunch key product.securityOperation security_inventory

People see the devices that run their agents, their security posture and the events those devices report.

Query parameters

status"active" | "revoked"
cursorstring
client"claude_code" | "codex" | "cursor" | "mcp_proxy"
allfalse | true
expectedAuthorizationVersionstring
limitnumber

Returns

accountIdstringRequired
serviceTenancyIdstringRequired
authorizationVersionstringRequired
evaluatedAtnumberRequired
scope"organization" | "own"Required
itemsobject[]Required
nextCursornull | stringRequired

Errors

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

GET/v1/security/devices

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

Response

{
  "result": {
    "accountId": "<accountId>",
    "serviceTenancyId": "<serviceTenancyId>",
    "authorizationVersion": "<authorizationVersion>",
    "evaluatedAt": 1,
    "scope": "organization",
    "items": [
      {
        "id": "<id>",
        "owner": {
          "name": "<name>",
          "self": true
        },
        "client": "claude_code",
        "clientVersion": "<clientVersion>",
        "adapterVersion": "<adapterVersion>",
        "status": "active",
        "createdAt": 1,
        "reportedPolicyGeneration": 1,
        "issuedPolicyGeneration": "<issuedPolicyGeneration>",
        "bundleNotBefore": "<bundleNotBefore>",
        "bundleExpiresAt": "<bundleExpiresAt>",
        "minimumAdapterVersion": "<minimumAdapterVersion>",
        "lastSeenAt": "<lastSeenAt>",
        "coverage": "expired_policy",
        "verification": "client_reported",
        "connectivity": "unknown",
        "enforcement": "unknown",
        "clientSupport": "unverified"
      }
    ],
    "nextCursor": "<nextCursor>"
  }
}

Security inventory

Headers

Query parameters

Returns

Errors