Get security device
/v1/security/devices/{id}
Signed-in sessionLaunch key product.securityOperation security_device_get
People see the devices that run their agents, their security posture and the events those devices report.
Headers
- X-Specify-Account-IdstringRequired
- The account the request acts in.
- X-Specify-Service-Tenancy-IdstringRequired
- The service tenancy the request acts in.
Path parameters
- idstringRequired
Query parameters
- expectedAuthorizationVersionstring
Returns
- idstringRequired
- ownerobjectRequired
- client"claude_code" | "codex" | "cursor" | "mcp_proxy"Required
- clientVersionstringRequired
- adapterVersionstringRequired
- status"active" | "revoked"Required
- createdAtnumberRequired
- reportedPolicyGenerationnumberRequired
- issuedPolicyGenerationnull | numberRequired
- bundleNotBeforenull | numberRequired
- bundleExpiresAtnull | numberRequired
- minimumAdapterVersionnull | stringRequired
- lastSeenAtnull | numberRequired
- coverage"expired_policy" | "invalid_policy" | "missing_policy" | "policy_not_yet_valid" | "reported_current" | "reported_generation_mismatch" | "revoked" | "rollout_pending"Required
- verification"client_reported"Required
- connectivity"unknown"Required
- enforcement"unknown"Required
- clientSupport"unverified"Required
Errors
400, 401, 403, 404, 409, 429 and 503 return {"error": {"code", "message", "correlationId"}}.