Archive a Forward template.
POST /api/v1/forward/templates/{template_id}/archive
Archives a template without deleting historical records.
Headers
| Header | Required | Description |
|---|---|---|
Authorization | Yes | Bearer <PAT or SAT> |
Idempotency-Key | No | Optional idempotency key for unsafe requests. |
Path parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
template_id | string | Yes | Forward Template ID. |
Example request
Example response
HTTP 200 OK
Response fields
Returns the archived Template object with status set to archived. Its Forward managed-capability baseline is retained in managed_tool_config.
Errors
| HTTP | Type | Code | Trigger |
|---|---|---|---|
| 404 | not_found_error | - | Template does not exist or is not visible to the caller. |
| 409 | conflict_error | - | Template state does not allow archive. |
| 401 | authentication_error | authentication_required | The PAT or SAT is invalid or expired. |
Notes
- Archived templates do not appear in active lists by default.
- Archiving does not delete historical Sessions or configuration records.

