---
title: "Deploy a use case blueprint"
method: POST
path: "/use-case-blueprints/{id}/deploy"
tags: ["Agents"]
---

# Deploy a use case blueprint

`POST /use-case-blueprints/{id}/deploy`

## Request

- Base URL: `https://api.atako.ai`
- URL: `https://api.atako.ai/use-case-blueprints/{id}/deploy`
- Auth: HTTP bearer

Creates the blueprint's agents (personal to the caller), integration grants, project and kickoff messages in one call. Idempotent per `(user, idempotencyKey)`. Guards, in order: AGENT_CREATION_NOT_ALLOWED (403), NO_ACTIVE_SUBSCRIPTION (402), SEATS_INSUFFICIENT (409, `needed`/`available`), MISSING_CONNECTION / CONNECTION_NOT_USABLE (400, `providerKey`), INVALID_INPUT (400, `key`). Nothing is created when a guard fails. A mid-way failure keeps what exists: status `partial` with `errors`.

## Request body

- object
  - `locale` 'en' | 'fr'
  - `idempotencyKey` string, uuid, required
  - `connections` object, required: providerKey → connection id
  - `inputs` object, required

## Response `200`

- object
  - `deploymentId` string
  - `status` 'complete' | 'partial'
  - `projectId` string, nullable
  - `agents` object[]
  - `errors` object[]

## Other responses

- `400`: MISSING_CONNECTION / CONNECTION_NOT_USABLE / INVALID_INPUT
- `401`: Missing, malformed, or invalid bearer token / API key, or revoked session (SESSION_REVOKED).
- `402`: NO_ACTIVE_SUBSCRIPTION
- `403`: AGENT_CREATION_NOT_ALLOWED
- `404`: BLUEPRINT_NOT_FOUND
- `409`: SEATS_INSUFFICIENT

---

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