メインコンテンツへスキップ
GET /api/v1/forward/templates Forward テンプレートのベースラインを一覧表示します。アーカイブ済みのテンプレートは、明示的に要求しない限り除外されます。

Headers

HeaderRequiredDescription
AuthorizationYesBearer <PAT>

Query parameters

ParameterTypeRequiredDefaultDescription
statusstringNo-active または archived でフィルタします。
limitintegerNo201 ページあたりの件数。最大 100。
after_idstringNo-指定した Template ID より後のレコードを取得するカーソル。before_id と併用できません。
before_idstringNo-指定した Template ID より前のレコードを取得するカーソル。after_id と併用できません。

Example request

curl -s -X GET 'https://api.qoder.com/api/v1/forward/templates?status=active&limit=20' \
  -H "Authorization: Bearer $QODER_PAT"

Example response

HTTP 200 OK
{
  "data": [
    {
      "type": "template",
      "id": "tmpl_support",
      "name": "Support assistant",
      "description": "Handles pre-sales and after-sales support",
      "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
dataarray現在のページの Template オブジェクト。
first_idstring|nullこのページの最初のレコードの ID。
last_idstring|nullこのページの最後のレコードの ID。
has_morebooleanさらにレコードが残っているかどうか。

Errors

HTTPTypeTrigger
400invalid_request_errorページネーションパラメータが不正、または limit が 100 を超えている。
401authentication_errorPAT が無効または期限切れ。
403permission_errorこのリソースへのアクセス権がない。

Notes

  • 結果は認証されたアカウントのスコープに限定されます。
  • カーソルページネーションには after_id または before_id のいずれか一方を使用し、両方を同時に使用しないでください。

テンプレートの作成

テンプレートの取得