---
title: "Provision (or idempotently re-apply) a multi-agent app from a manifest"
method: POST
path: "/api/agent-apps"
tags: ["Agent apps"]
---

# Provision (or idempotently re-apply) a multi-agent app from a manifest

`POST /api/agent-apps`

## Request

- Base URL: `https://agentsbooks.com`
- URL: `https://agentsbooks.com/api/agent-apps`
- Auth: HTTP bearer

## Request body

- AgentAppManifest: Declarative description of a whole multi-agent application. One document describing many agents, the handoffs between them, and an optional team grouping — provisioned idempotently via ``POST /api/agent-apps``.
  - `app_id` string, required
  - `name` string, required
  - `description` string, nullable
  - `version` string
  - `agents` AgentAppAgentSpec[] (unresolved $ref)
  - `connections` AgentAppConnection[] (unresolved $ref)
  - `team` AgentAppTeamSpec (unresolved $ref)
  - `webhook` AgentAppWebhook (unresolved $ref)

## Response `201`

Deploy report

---

[API](https://skmtc.dev/agentsbooks/apis/agentsbooks-agent-mode-api.md) · [All operations](https://skmtc.dev/agentsbooks/apis/agentsbooks-agent-mode-api/llms.txt) · [OpenAPI document](https://skmtc.dev/agentsbooks/apis/agentsbooks-agent-mode-api/revisions/3be3beabaefb?raw)