刪除 Skill
刪除 Skill
支援刪除指定組織下的 Skill。
可以透過該 API,刪除指定組織下的 Skill。刪除時會級聯清理技能草稿、版本快照與技能包檔案記錄。
請求方式
POST
調用地址
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 | 伺服器錯誤 |
