---
title: "Load Template"
method: POST
path: "/agent-templates/load"
tags: ["Workflows"]
---

# Load Template

`POST /agent-templates/load`

## Query parameters

- `project_id` string, uuid, required

## Request body

- TemplateLoadRequest
  - `source` InternalTemplateSource, required
    - `kind` 'internal'
    - `key` string, required
  - `base_revision` WorkflowRevisionDataInput, required
    - `uri` string, nullable
    - `url` string, nullable
    - `headers` object, nullable
    - `runtime` 'python' | 'typescript' | 'javascript', nullable
    - `script` string, nullable
    - `schemas` JsonSchemasInput
      - `parameters` object, nullable
      - `inputs` object, nullable
      - `outputs` object, nullable
    - `parameters` object, nullable
  - `ui_build_kit_enabled` boolean
  - `ui_disabled_ops` string[]
  - `ui_op_permissions` object
  - `staging_session_id` string, nullable
  - `attachment_ids` string[]
  - `initial_message` string, required
  - `connection_choices` union[]
    - union
      - GatewayConnectionChoiceRequest
        - `connection_key` string, required
        - `kind` 'gateway', required
        - `provider` 'composio', required
        - `integration` string, required
      - MCPConnectionChoiceRequest
        - `connection_key` string, required
        - `kind` 'mcp', required
        - `server` string, required
      - SkipConnectionChoiceRequest
        - `connection_key` string, required
        - `kind` 'skip', required

## Response `200`

Idempotent replay

## Other responses

- `201` — Successful Response
- `400` — Idempotency key required
- `403` — Forbidden
- `404` — Template source not found
- `409` — Idempotency conflict
- `422` — Invalid package or request
- `503` — Load handoff not durable

## Changes

- **2026-09-25** `ec21cdc5486c` — 1 info
  - added the new optional request property `ui_op_permissions`
- **2026-09-23** `89054d43d2f0` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/agenta-ai/apis/agenta-api/changes/agent-templates/load/post.md)

---

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