Agents

Create a child agent

A cheap sub-agent under a parent. The child has its own API key, memory namespaces and action_approval_policy; is created with a subset of the parent's vault_ids and scopes (a superset is refused, not trimmed); inherits the parent's vault access policies (policy lookups include the parent's rows) and guardrails; does not count against the plan's agent cap (capped at 50 per parent); and cannot have children of its own. Human-only. Audited as agent.child_created.

post/v1/agents/{agent_id}/children

Request

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

Request body

namestring required
descriptionstring
vault_idsstring[]

Subset of the parent's vault_ids. Default the parent's.

scopesstring[]

Subset of the parent's scopes. Default the parent's.

memory_namespace_allowliststring[]

The child's own namespaces. Default ["child:{child_id}"].

action_approval_policyobject

The child's own policy. Default the parent's.

expires_atstring date-time
approval_idstring uuid

Response

Created; api_key shown once

api_keystring

One-time API key (only present for api_key auth method)

Changes

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