Agents

Mint a router key (sk-shroud-v1)

Creates an sk-shroud-v1-<32> static Bearer for the Shroud gateway, mapped to this agent. A stock OpenAI or Anthropic SDK sends it as Authorization: Bearer … with base_url set to the gateway; the gateway exchanges it key-only for the agent's token. The plaintext key is returned once. Up to 20 live keys per agent. Human users only; the agent must have shroud_enabled: true.

post/v1/agents/{agent_id}/router-keys

Request

  • Base URL: https://api.1claw.co
  • URL: https://api.1claw.co/v1/agents/{agent_id}/router-keys
  • Auth: HTTP bearer

Path parameters

agent_idstring uuid required

Request body

namestring

Shown in lists; defaults to default

max_concurrent_streamsinteger

Open streaming responses this key may hold at once (gateway default 20)

spend_cap_usdnumber

Optional spend cap in USD, metered by the gateway

Response

Router key created (plaintext returned once)

idstring uuid required
agent_idstring uuid required
namestring required
key_prefixstring required

First 20 characters (sk-shroud-v1- + 7) — enough to recognise, not to use

max_concurrent_streamsinteger nullable
spend_cap_usdnumber nullable
created_atstring date-time required
last_used_atstring date-time nullable
revoked_atstring date-time nullable
router_keystring required

The plaintext sk-shroud-v1-… key. Returned once.

base_urlstring required

The Shroud gateway to point the SDK at

Example response

{
  "router_key": "sk-shroud-v1-Q2c5o0yQ3bHkT9m1vXz8Lw7nRp4aEf6u",
  "base_url": "https://shroud.1claw.co"
}

Changes

No recorded changes to this operation across all 1 revision of this API.