---
title: "Revise a template with the authoring agent"
method: POST
path: "/v1/agent/templates/{template_id}/revise"
tags: ["Agent"]
---

# Revise a template with the authoring agent

`POST /v1/agent/templates/{template_id}/revise`

Send natural-language feedback on an existing image template; the agent revises
the draft while keeping layer names stable. Asynchronous — poll
`GET /v1/agent/jobs/{job_id}`; the completed job always includes a fresh
**preview_url**.

**Authentication:** API Key required (`x-api-key` header)

## Credits

A revision costs **10 credits**, deducted when the job
is queued and fully refunded if the job fails.

## Path parameters

- `template_id` string, required — Template short ID (12 characters)

## Request body

- ReviseAgentTemplateRequest
  - `feedback` string, required — Natural-language feedback on the current template.
  - `brand` BrandInputs — Optional brand constraints passed to the agent.
    - `colors` string[] — Brand colors as hex strings, e.g. ['#0C3C5F', '#E27D28']
    - `fonts` string[] — Preferred font families. Non-built-in fonts are substituted with the closest built-in and noted in the result.
    - `asset_urls` string[] — Public https:// URLs of assets (logo, photos) the agent may use.

## Response `200`

Job queued

- AgentJobCreatedResponse
  - `job_id` string, required
  - `status` 'pending', required
  - `credits_charged` integer, required
  - `credits_remaining` integer, required

## Other responses

- `400` — Not an image template
- `402` — Insufficient credits
- `403` — Template belongs to another team
- `422` — Validation Error
- `429` — Rate limit exceeded

---

[API](https://skmtc.net/pdftemplateapi/apis/templatefox-api.md) · [All operations](https://skmtc.net/pdftemplateapi/apis/templatefox-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pdftemplateapi/templatefox-api/revisions/5673fc0d5fad/schema)