メインコンテンツへスキップ
GET /api/v1/forward/resources 現在の呼び出し元が所有するリソースを返します。リソースが引き続き参照可能な場合、結果には最新の resource_spec データが含まれます。

Headers

HeaderRequiredDescription
AuthorizationYesBearer <PAT>

Query parameters

ParameterTypeRequiredDefaultDescription
typestringYes-リソースタイプ: skillfilevault、または environment
limitintegerNo201 ページあたりの件数。最大 100。
after_idstringNo-カーソルとなるリソース ID。それより後のレコードを返します。before_id とは併用できません。
before_idstringNo-カーソルとなるリソース ID。それより前のレコードを返します。after_id とは併用できません。

Example request

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

Example response

HTTP 200 OK
{
  "data": [
    {
      "id": "skill_xxx",
      "type": "skill",
      "owner_type": "user",
      "owner_id": "usr_xxx",
      "resource_spec": {
        "name": "customer-reply-skill",
        "description": "Customer reply policy skill",
        "type": "skill",
        "status": "active",
        "skill_type": "custom",
        "created_at": "2026-06-24T07:51:38.276624Z",
        "updated_at": "2026-06-24T07:51:38.276624Z",
        "metadata": {}
      }
    }
  ],
  "has_more": false,
  "first_id": "skill_xxx",
  "last_id": "skill_xxx"
}

Response fields

FieldTypeDescription
dataarray現在のページのリソースオブジェクト。
has_morebooleanさらにレコードが残っているかどうか。
first_idstring|nullこのページの最初の項目のリソース ID。
last_idstring|nullこのページの最後の項目のリソース ID。

Resource object fields

FieldTypeDescription
idstringリソース ID。リソース ID と直接一致します。
typestringリソースタイプ。
owner_typestring所有権タイプ。このエンドポイントは user にフィルターされます。
owner_idstring現在の呼び出し元の所有者 ID。
resource_specobjectフラット化された最新のリソースオブジェクト。フィールドは type によって異なります。

Errors

HTTPTypeTrigger
400invalid_request_errorリソースの type が欠落しています。
400invalid_request_errorリソースの type がサポートされていません。
400invalid_request_errorlimit が範囲外、または after_idbefore_id の両方が指定されています。
401authentication_errorPAT が無効または期限切れです。

Notes

  • 参照できなくなったリソースはスキップされます。そのため data はローカルレジストリのレコード数より少なくなる場合があります。

リソースを登録する

テンプレートを作成する