Skill の取得

Description

Retrieves a single Skill by ID, optionally including its content.

パス

GET /api/v1/forward/skills/{id}

リクエストヘッダー

ヘッダー	必須	説明
`Authorization`	はい	`Bearer <PAT または SAT>`

パス参数

パラメーター	型	必須	説明
`id`	string	はい	Skill ID。

クエリパラメーター

パラメーター	型	必須	説明
`identity_id`	string	No	For Identity-owned resources only. PATs may supply this query parameter; omitting it uses the administrator scope. SAT ownership is determined by the credential; any SAT (including Admin SAT) explicitly supplying this parameter, even with an empty value, receives HTTP 400. See Identity ownership.
`include_content`	boolean	No	⚠️ Deprecated: When `true`, the response includes `content` and `content_encoding` (base64 zip) and returns `Deprecation: true` in the response headers. Use Download Skill Version Content instead.

リクエスト例

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

レスポンス例

HTTP 200 OK

{
  "id": "skill_xxx",
  "type": "skill",
  "display_title": "customer-reply",
  "description": "Customer reply skill",
  "source": "custom",
  "latest_version": "1759178010641129",
  "metadata": {"source": "console"},
  "created_at": "2026-07-23T10:00:00Z",
  "updated_at": "2026-07-23T10:00:00Z",
  "identity_id": null,
  "icon_url": null,
  "binding_info": {"agent_template_count": 0}
}

レスポンスフィールド

The response is a Skill object. With include_content=true, it also includes content and content_encoding; both fields are deprecated. Use Download Skill Version Content instead.

エラー

HTTP	Type	発生条件
400	`invalid_request_error`	リクエストボディ、パスパラメーター、またはクエリパラメーターが不正です。SAT でクエリパラメーター `identity_id` を明示的に指定した場合（空値を含む）も該当します。
401	`authentication_error`	認証トークンがないか、無効です。
403	`permission_error`	管理者 Scope で Owner mismatch が発生したか、下流サービスがアクセスを拒否しました。
404	`not_found_error`	Skill が存在しないか、現在の Identity Scope から参照できません。PAT で指定した Identity が無効、無効化済み、削除済み、または権限範囲外の場合も該当します。
500/502/503	`api_error`	Forward または依存サービスでエラーが発生しました。

​Description

​パス

​リクエストヘッダー

​パス参数

​クエリパラメーター

​リクエスト例

​レスポンス例

​レスポンスフィールド

​エラー