Skip to Content
APIEndpointsWithdraw content suggestions

Withdraw content suggestions

Withdraws a set of suggested edits before anyone has decided on them; editors showing the set clear it. Refused with 409 conflict once the team has accepted or declined one of its suggestions. Only sets sent through the API or MCP can be withdrawn.

Requires the write:content scope, and the workspace must be enabled for API writes.

DELETE /v1/brands/{brand_id}/content/{draft_id}/suggestions/{suggestion_id}

Authorization

HeaderTypeRequired
AuthorizationBearer asky_sk_…required
Idempotency-Keystringrequired

Path parameters

ParameterTypeRequiredDescription
brand_iduuidrequiredFrom List brands
draft_iduuidrequiredThe draft the set is on
suggestion_iduuidrequiredFrom Suggest content edits

Query parameters

None.

Request

curl --request DELETE \ --url 'https://api.askylabs.com/v1/brands/242546de-4cee-4a7d-952e-f6aa60c63ef8/content/7c1e2b90-3f4d-4a8e-9b21-5d6f7a8b9c0d/suggestions/0b9d6c4e-21a7-4f3b-8e5d-9c1a2b3c4d5e' \ --header 'Authorization: Bearer <api-key>' \ --header 'Idempotency-Key: <unique-per-attempt>'

Response

{ "data": { "suggestion_id": "0b9d6c4e-21a7-4f3b-8e5d-9c1a2b3c4d5e", "draft_id": "7c1e2b90-3f4d-4a8e-9b21-5d6f7a8b9c0d", "withdrawn": true, "review_url": "https://app.askylabs.com/content/7c1e2b90-3f4d-4a8e-9b21-5d6f7a8b9c0d", "live_page_updated": false, "translations_unchanged": [] }, "request_id": "req_7d21b0af59c34e18b6ac" }

Response fields

FieldTypeDescription
data.suggestion_iduuidrequired
data.draft_iduuidrequired
data.withdrawnbooleanrequired. Always true
data.review_urlstringrequired
data.live_page_updatedbooleanrequired. Always false
data.translations_unchangedarrayrequired
request_idstringrequired
Last updated on