Skip to main content
Templates

List templates

List Forward templates under the current account with cursor pagination.

GET /api/v1/forward/templates Lists Forward template baselines. Archived templates are excluded unless requested.

Headers

HeaderRequiredDescription
AuthorizationYesBearer <PAT or SAT>

Query parameters

ParameterTypeRequiredDefaultDescription
statusstringNo-Filter by active or archived.
limitintegerNo20Items per page. Maximum 100.
after_idstringNo-Cursor for records after the given Template ID. Cannot be used with before_id.
before_idstringNo-Cursor for records before the given Template ID. Cannot be used with after_id.

Example request

curl -s -X GET 'https://api.qoder.com/api/v1/forward/templates' \
  -H "Authorization: Bearer $QODER_ACCESS_TOKEN"

Example response

HTTP 200 OK 
{
  "data": [
    {
      "type": "template",
      "id": "tmpl_support",
      "name": "Support assistant",
      "description": "Handles customer support requests",
      "status": "active",
      "created_at": "2026-06-18T10:00:00Z",
      "updated_at": "2026-06-18T10:00:00Z"
    }
  ],
  "first_id": "tmpl_support",
  "last_id": "tmpl_support",
  "has_more": false
}

Response fields

FieldTypeDescription
dataarrayTemplate objects on the current page.
first_idstring|nullID of the first record on this page.
last_idstring|nullID of the last record on this page.
has_morebooleanWhether more records remain.

Errors

HTTPTypeTrigger
400invalid_request_errorInvalid pagination parameters or limit above 100.
401authentication_errorPAT or SAT invalid or expired.
403permission_errorNot authorized for this resource.
401authentication_errorauthentication_required

Notes

  • Results are scoped to the authenticated account.
  • Use after_id or before_id for cursor pagination, not both.

Create a template

Get a template

First steps
Define your agent
Configure agent environment
Delegate work to your agent
Agent integrations
Manage agent context
Account
Best Practices
Announcements
API reference