Clone an existing Forward template.
POST /api/v1/forward/templates/{template_id}/clone
Creates a new template by copying the source template's agent configuration and session defaults.
Headers
| Header | Required | Description |
|---|---|---|
Authorization | Yes | Bearer <PAT or SAT> |
Content-Type | Yes | application/json |
Idempotency-Key | No | Optional idempotency key for unsafe requests. |
Path parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
template_id | string | Yes | Source Forward Template ID. |
Body parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
name | string | No | New template name. If omitted, uses <source-name> Copy <random-short-ID>. |
description | string | No | New template description. If omitted, the source description is used. |
Example request
Example response
HTTP 200 OK
Response fields
Returns the newly created Template object, including the Forward managed-capability baseline copied from the source Template in managed_tool_config.
See Get a template for field descriptions.
Errors
| HTTP | Type | Code | Trigger |
|---|---|---|---|
| 400 | invalid_request_error | - | Invalid clone request. |
| 404 | not_found_error | - | Source template does not exist. |
| 409 | conflict_error | - | New template name already exists. |
| 401 | authentication_error | authentication_required | The PAT or SAT is invalid or expired. |
Notes
- Clone generates a new Template ID.
- Cloning copies the Template's
managed_tool_config. - Cloning does not copy Identity Config records.

