Get agent details
Request
- Base URL: https://api.1claw.co
- URL: https://api.1claw.co/v1/agents/{agent_id}
- Auth: HTTP bearer
Path parameters
Response
Agent details
A child is a sub-agent under parent_agent_id that inherits its parent's policies and does not count against the plan's agent cap.
Present on child agents.
Whether durable key-value and semantic memory is enabled. Omitted when false: the server skips serializing this field unless it is true, so an absent key means disabled.
Namespaces this agent may use. Omitted when empty, which means unrestricted.
Maximum size of a single memory entry value. Omitted when unset, which means the platform default (64 KiB).
Maximum value per transaction in native major units for the transacting chain family (ETH on EVM, BTC on Bitcoin, SOL on Solana, XRP, ADA, TRX).
Rolling daily spend cap in native major units, enforced per chain family at signing time.
Deprecated alias for tx_max_value. Same unit semantics (native major units, not ETH-only).
Deprecated alias for tx_daily_limit.
Sum of today's spend across all chain families in major units. Prefer tx_spent_today_by_chain.
Deprecated alias for tx_spent_today.
SHA-256 fingerprint of the client certificate (mTLS agents)
OIDC issuer URL (oidc_client_credentials agents)
OIDC client ID (oidc_client_credentials agents)
Ed25519 SSH public key (base64-encoded, auto-generated at creation)
P-256 ECDH public key (base64 SEC1 uncompressed point, auto-generated at creation)
Whether this agent routes LLM traffic through the Shroud TEE proxy
Default system prompt for agent chat when requests do not override it.
Whether Execution Intents (bindings and execute endpoint) are enabled for this agent
Guardrails applied to all execution intents for this agent
When true, transaction/sign requests must arrive via a TEE host (Pro+ only)
When true, execute requests must arrive via TEE and all direct secret reads are blocked (Pro+ only)
Max transactions per UTC calendar day. Null = unlimited.
Per-chain daily overhead budget in native units.
Solana wallet addresses whose ATAs may be created.
Whether this agent may order payment cards (x402 card ordering).
Maximum USD amount for a single card order.
Maximum cumulative USD spent ordering cards per rolling 24h window.
One cap across ALL of this agent's x402 stablecoin spend — POST /v1/pay and card orders together. Calendar day, UTC. Omit for no cap. Applied in addition to the per-route caps, never instead of them: tx_* bounds signing and submitting, pay_* bounds POST /v1/pay, and card_* bounds card orders. None of those three bounds the others, so this is the only field that caps an agent's total stablecoin spend.
Allowed x402 payTo recipients for card orders (empty = built-in Laso recipients).
Whether agents may reveal card details subject to per-card reveal policy.
When true, card orders route through the human approval queue before x402 payment.
Graduated transaction approval policy (HITL thresholds).
Which business actions this agent must ask a human about, and above what amount. {} means no per-action rules.
Shape: { "default_mode": "deny|approve|allow", "rules": [ { "action_type": "refund.create", "mode": "approve", "require_for_amount_above_usd": "50", "summary_template": "Refund {{amount_usd}} to {{customer_email}}" } ] }.
A rule can only raise the bar. Editing this is classified as a guardrail widening, so it routes through the same approval flow as loosening a transaction limit. Malformed rules are rejected on write rather than ignored at request time.
Block unlimited ERC-20 approvals.
True when circuit breaker auto-suspended the agent after repeated guardrail denials.
Today's transaction count (UTC calendar day). Present when intents_api_enabled.
Today's overhead spend by chain in native units.
Whether this agent may mint OIDC federation tokens via POST /v1/auth/federated-token. False by default.
Allowlist of audience URIs the agent may federate to.
Per-agent TTL override for federation tokens (60..=3600).
Chains for which this agent has provisioned signing keys.
JSON array of allowed EIP-712 domain entries.
Default EIP-712 policy (deny blocks all unless allowlisted).
Whether EIP-191 personal_sign is enabled.
Whether the raw/precomputed-digest signing intent (eip712_digest) is enabled. Blind signing — bypasses transaction guardrails; OFF by default and human-set. Required for ERC-1271/ERC-7739 flows (e.g. Polymarket).
Token contract/mint addresses this agent may interact with.
When true, only tokens in the known_tokens registry may be used.
Allowed XRP Ledger transaction types.
Per-chain guardrail overrides.
Per-chain-family daily spend in native major units (keys: evm, bitcoin, solana, xrp, cardano, tron).
Optional expiration time for the agent's API key.
Agent's Ethereum EOA address (used as Safe signer for smart accounts and Intents API).
Named environment this agent belongs to (production, preview, development, or custom).
When true, the environment tag is locked and cannot be changed.
When true, env var resolve endpoints auto-fill environment from this agent's tag.
Per-environment guardrail overrides keyed by environment slug.
Recipient address screening policy. mode may be off, deny, or approve.
Changes
No recorded changes to this operation across all 1 revision of this API.