TokenLab

Văn bản

Xóa phản hồi

Xóa một phản hồi đã lưu. Thao tác này không hủy quá trình tạo phản hồi.

DELETE
/v1/responses/{id}

Tổng quan

Xóa một phản hồi đã lưu theo ID. Sau khi xóa, ID này sẽ không thể truy xuất hoặc sử dụng làm previous_response_id được nữa.

Đây là thao tác xóa, không phải hủy: nó không dừng một phản hồi đang trong quá trình tạo. Bạn chỉ có thể xóa các phản hồi được tạo trong tài khoản của chính mình. Một ID không xác định, ID từ tài khoản khác hoặc ID đã bị xóa trước đó đều sẽ trả về mã lỗi 404.

Ví dụ

Yêu cầu

cURL
curl -X DELETE "https://api.tokenlab.sh/v1/responses/resp_abc123" \
  -H "Authorization: Bearer sk-your-api-key"

Ví dụ phản hồi

Phản hồi

200 OK
{
  "id": "resp_abc123",
  "object": "response.deleted",
  "deleted": true
}
deletedboolean
true khi phản hồi đã được xóa. Hãy kiểm tra trường này: giá trị của object có thể khác nhau tùy theo model.

Lỗi

Trạng tháiMãÝ nghĩa
404response_not_foundID không xác định, thuộc về tài khoản khác hoặc đã bị xóa.
502upstream_delete_failedTokenLab không thể xóa phản hồi tại dịch vụ đã tạo ra nó. Phản hồi vẫn được lưu trữ. Vui lòng thử lại sau.
503upstream_delete_recovery_pendingThao tác xóa đang được đối soát. Không gửi lại yêu cầu ngay lập tức.
503response_state_unavailableTrạng thái phản hồi tạm thời không khả dụng. Vui lòng thử lại sau.

Xác thực

BearerAuth
AuthorizationBearer <token>

Xác thực bằng Khóa API. Tạo hoặc quản lý khóa API trong Dashboard > API > API Keys.

Vị trí: header

Tham số đường dẫn

id*string

ID phản hồi được trả về bởi POST /v1/responses.

Phản hồi

application/json

application/json

application/json

application/json