---
title: "Create Agent Generation"
method: POST
path: "/v1/agents/generations"
tags: ["Agents"]
deprecated: true
---

# Create Agent Generation

`POST /v1/agents/generations`

> **Deprecated.**

Create Agent Generation

## Request body

- union
  - CreateTemplateGenerationRequestPublicV1
    - `input_schema` object
    - `metadata` CreateTemplateMetadataPublicV1
      - `description` string, nullable
      - `display_name` string, nullable
      - `tags` string[]
    - `name` string, nullable
    - `output_schema` object
    - `prompt` string, required
    - `url` string, required
  - CreateTemplateRefinementRequestPublicV1
    - `from_agent` string, required
    - `prompt` string, required

## Response `201`

Successful Response

- TemplateGenerationResponsePublicV1
  - `agent_name` string, nullable
  - `completed_at` string, date-time, nullable
  - `created_at` string, date-time, nullable
  - `error` string, nullable
  - `generated_version` TemplateVersionResponsePublicV1
    - `agent_name` string, required
    - `created_at` string, date-time, required
    - `id` string, uuid, required
    - `input_schema` object, required
    - `metadata` TemplateVersionMetadataPublicV1, required
      - `data_source` string, nullable
      - `description` string, nullable
      - `display_name` string, nullable
      - `domain` string, nullable
      - `entity_type` string, nullable
      - `tags` string[]
      - `vertical` string, nullable
    - `output_schema` object, required
    - `samples` TemplateSamplePublicV1[], nullable
      - `input` unknown
      - `output` unknown
    - `version_number` integer, required
  - `generated_version_id` string, uuid, nullable
  - `id` string, uuid, required
  - `source_version_id` string, uuid, nullable
  - `started_at` string, date-time, nullable
  - `status` string, required
  - `summary` string, nullable

## Other responses

- `422` — Validation Error

## Changes

- **2026-07-20** `d4e4f170f4f4` — 1 breaking, 1 warning, 7 info
  - removed `#/components/schemas/CrustCreateAgentGenerationRequest, #/components/schemas/CrustCreateAgentRefinementRequest` from the request body `anyOf` list
  - deleted the `cookie` request parameter `token`
  - api operation id `create_agent_generation_v2_templates_generations_post` removed and replaced with `create_template_generation_public_v1_api_v1_public_templates_generations_post`
  - the endpoint scheme security `APIKeyCookie` was added to the API
  - …5 more
- **2026-07-12** `e8a97dc9fce2` — 1 breaking, 3 info
  - removed `#/components/schemas/CreateAgentGenerationRequest, #/components/schemas/CreateAgentRefinementRequest` from the request body `anyOf` list
  - added `#/components/schemas/CrustCreateAgentGenerationRequest, #/components/schemas/CrustCreateAgentRefinementRequest` to the request body `anyOf` list
  - added `#/components/schemas/CrustAgentVersionResponse` to the `generated_version` response property `anyOf` list for the response status `201`
  - removed `#/components/schemas/AgentVersionResponse` from the `generated_version` response property `anyOf` list for the response status `201`
- **2026-07-07** `ebe52c375b71` — 1 warning, 1 info
  - removed the request property `anyOf[subschema #1: CreateAgentGenerationRequest]/agent_name`
  - added the new optional request property `anyOf[subschema #1: CreateAgentGenerationRequest]/name`
- …earlier changes not shown

[Full history](https://skmtc.dev/nimbleway/apis/api-gateway/changes/v1/agents/generations/post.md)

---

[API](https://skmtc.dev/nimbleway/apis/api-gateway.md) · [All operations](https://skmtc.dev/nimbleway/apis/api-gateway/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nimbleway/api-gateway/revisions/d1947ec7af21/schema)