刪除提示詞
此 API 用於刪除指定的 Prompt。
透過提供 prompt_id,你可以將該提示詞從系統中移除,刪除後無法復原。
由該 Prompt 優化產生的其他 Prompt(metadata.derived_from 指向它)不會一併刪除。
curl -X 'DELETE' \
'http://127.0.0.1:8000/v1/prompts/{prompt_id}' \
-H "Authorization: Bearer $PRIVAI_API_KEY"
Request Headers
| Key | Value |
|---|---|
| Request Method | DELETE |
| Authorization | Bearer $PRIVAI_API_KEY |
Path Parameters
| Field | Type | Note | Required |
|---|---|---|---|
| prompt_id | string (uuid) | 欲刪除的 Prompt 唯一鍵 | true |
Response Headers
| Key | Value |
|---|---|
| Status Code | 204 |
成功刪除時回應為 204 No Content,沒有 response body。
可能的錯誤
| Error Code | HTTP Status | 情境 |
|---|---|---|
AUTH_001、AUTH_002、AUTH_003 | 401 / 403 | 缺少 Authorization header、API Key 無效或已過期,見 「錯誤代碼說明-身份驗證類」 |
PROMPT_001 | 404 | 指定的 Prompt 不存在、已被刪除,或不屬於目前的 API Key,見 「錯誤代碼說明-提示詞管理類」 |