Get Agent
Machine Agents
Get Agent
Retrieve full details for a specific machine agent identity
GET
Get Agent
Get Agent
GET /v1/agents/{agentID}
Returns the complete agent identity record for the specified agent, including cryptographic key information, current trust score, assigned scopes, delegation depth, and all metadata. The agent must belong to the authenticated tenant.
Authentication
RequiresX-API-Key header or Bearer JWT token. Tenant-scoped via X-Tenant-ID.
Path Parameters
string
required
The MAIP agent identifier (e.g.,
maip:t1234567:01HYX3KPZQ7RJGBN0WFMV8SDEH).Response
string
Internal UUID primary key.
string
MAIP-compliant agent identifier.
string
UUID of the owning tenant.
string
Agent type classification.
string
Human-readable agent name.
string
Agent description.
string
Trust hierarchy level. One of:
"platform_root", "verified_org",
"verified_individual", "authenticated", "self_asserted", "anonymous".number
Numeric trust score between 0.0 and 1.0. Adjusted over time based on agent
behavior, anomaly detection, and attestation history.
string
Current lifecycle status:
"active", "suspended", or "revoked".string
Base64url-encoded Ed25519 public key for this agent.
string
Unique key identifier for receipt and attestation signature verification.
string[]
Assigned permission scopes in
resource:action format.object
Arbitrary metadata attached to the agent.
string
If this agent was created via delegation, the parent agent’s MAIP ID.
number
Position in the delegation chain (0 = root, max 8).
string
UUID of the user who registered the agent, if applicable.
string
ISO 8601 timestamp if the agent’s key was marked compromised.
string
Automatic expiration timestamp, if configured.
string
ISO 8601 creation timestamp.
string
ISO 8601 last-updated timestamp.
Example
Authorizations
API key for machine-to-machine authentication
Path Parameters
Agent identifier
Response
Agent details
Available options:
orchestrator, worker, inference, pipeline, service, bot, llm Maximum string length:
256Available options:
active, suspended, revoked Required range:
0 <= x <= 1Base64-encoded public key

