Skill の削除

指定した組織配下の Skill を削除できます。

本インターフェースを使用して、指定した組織配下の Skill を削除できます。削除時には、Skill の下書き、バージョンスナップショット、Skill パッケージファイルのレコードが連鎖的にクリーンアップされます。

リクエストメソッド

POST

リクエストURL

https://api.${endpoint}/v1/org/skill/delete

リクエスト認証

アカウントレベルの DevKey / DevSecret による Basic 認証を使用します。呼び出しアカウントに組織 Skill の削除権限が必要です。

リクエスト

リクエスト例

curl -X POST 'https://api.${endpoint}/v1/org/skill/delete' \ -H 'Authorization: Basic ${BASIC_TOKEN}' \ -H 'Content-Type: application/json' \ -d '{ "org_id": "p-xxxx", "skill_id": "skill-xxxx" }'

                      
                      curl -X POST 'https://api.${endpoint}/v1/org/skill/delete' \
  -H 'Authorization: Basic ${BASIC_TOKEN}' \
  -H 'Content-Type: application/json' \
  -d '{
    "org_id": "p-xxxx",
    "skill_id": "skill-xxxx"
  }'

このコードブロックをポップアップで表示

リクエストヘッダー

フィールド	タイプ	説明
Authorization	Basic ${BASIC_TOKEN}	`DevKey:DevSecret` を Base64 エンコードした Basic Token を使用します。
Content-Type	application/json	リクエストボディの形式。

リクエストパラメータ（Body Parameters）

パラメータ	タイプ	説明	required
org_id	String	組織 ID。	true
skill_id	String	Skill ID。	true

レスポンス

レスポンス例

{ "code": 0, "message": "OK", "affect_count": 1 }

                      
                      {
  "code": 0,
  "message": "OK",
  "affect_count": 1
}

このコードブロックをポップアップで表示

成功時のレスポンス

フィールド	タイプ	説明
affect_count	Integer	影響を受けたレコード数。

エラー時のレスポンス

フィールド	タイプ	説明
code	Integer	エラーコード。
message	String	エラー詳細。

ステータスコード

ステータスコード	説明
200	成功
400	パラメータエラー
401	未認証
403	権限不足
429	リクエストが頻繁すぎます
500	サーバーエラー