Skip to main content
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

Requires X-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

X-API-Key
string
header
required

API key for machine-to-machine authentication

Path Parameters

agentId
string<uuid>
required

Agent identifier

Response

Agent details

id
string<uuid>
agent_type
enum<string>
Available options:
orchestrator,
worker,
inference,
pipeline,
service,
bot,
llm
display_name
string
Maximum string length: 256
description
string
status
enum<string>
Available options:
active,
suspended,
revoked
scopes
string[]
metadata
object
trust_score
number<float>
Required range: 0 <= x <= 1
public_key
string

Base64-encoded public key

session_count
integer
keys
object[]
created_at
string<date-time>
updated_at
string<date-time>