メインコンテンツへスキップ
POST /api/v1/forward/resources/registry 既存のリソースを ID で登録します。このエンドポイントは upsert セマンティクスを持ちます。初回登録では 201 Created を返し、以降の登録による更新では 200 OK を返します。

​
Headers

HeaderRequiredDescription
AuthorizationYesBearer <PAT>
Content-TypeYesapplication/json
Idempotency-KeyNo安全でないリクエスト向けの任意の冪等性キー。

​
Body parameters

ParameterTypeRequiredDescription
typestringYesリソースタイプ。サポートされる値: skill、file、vault、environment。
resourceobjectYesリソースオブジェクト。resource.id のみが使用されます。
resource.idstringYesリソース ID(skill_... や file_... など)。

​
Example request

curl -s -X POST 'https://api.qoder.com/api/v1/forward/resources/registry' \
  -H "Authorization: Bearer $QODER_PAT" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "skill",
    "resource": {
      "id": "skill_xxx"
    }
  }'

​
Example response

HTTP 201 Created 
{
  "id": "skill_xxx",
  "type": "skill"
}

​
Response fields

FieldTypeDescription
idstringForward Resource ID。リソース ID と直接一致します。
typestringリソースタイプ。

​
Errors

HTTPTypeTrigger
400invalid_request_errortype が欠落またはサポート対象外、resource.id が欠落、またはボディが不正です。
401authentication_errorPAT が無効または期限切れです。
403permission_error呼び出し元がリソースにアクセスできません。
404not_found_errorリソースが存在しない、または宣言された type が実際のリソースタイプと一致しません。

​
Notes

  • Forward に登録する前に、リソース API を通じてリソースを作成または更新してください。

リソース一覧を取得する

テンプレートを作成する