---
title: "Spawn scoped swarm child"
method: POST
path: "/v1/agents/{parent_agent_id}/spawn"
tags: ["swarm"]
---

# Spawn scoped swarm child

`POST /v1/agents/{parent_agent_id}/spawn`

## Request

- Base URL: `https://api.lithtrix.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.lithtrix.ai/v1/agents/{parent_agent_id}/spawn`
- Auth: none declared

Requires the parent **root** ``ltx_*`` key. Creates a child agent row with ``parent_agent_id`` set and returns a one-time scoped sub-key.

## Path parameters

- `parent_agent_id` string, required

## Headers

- `authorization` string, nullable

## Request body

- SwarmSpawnRequest
  - `agent_name` string, nullable: Optional child display name; server generates ``swarm-{uuid8}`` if omitted.
  - `scope` string: Scoped sub-key permission (Arc 20 ``VALID_SCOPES``).
  - `ttl_seconds` integer, nullable: Optional key expiry hint stored on the key row (auto-revoke scheduling deferred).
  - `issue_ephemeral_passport` boolean: When true, mint ephemeral passport for the child agent.

## Response `201`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/lithtrix/apis/lithtrix-api.md) · [All operations](https://skmtc.dev/lithtrix/apis/lithtrix-api/llms.txt) · [OpenAPI document](https://skmtc.dev/lithtrix/apis/lithtrix-api/revisions/be5de51bf4f8?raw)