Skip to Content
APIEndpointsList content suggestions

List content suggestions

The suggestion sets on one draft, newest first: the set waiting for review, if any, and recent closed ones. Each suggestion carries its reason, category, edits and state:

  • pending: waiting for a decision.
  • accepted or declined: decided in the editor.
  • closed: its set closed before anyone decided (withdrawn, or combined into a newer set).

origin is api for sets sent with Suggest content edits and content_refresh for a Content Refresh review. Edit indexes address the body the set was based on, which may differ from the outline today.

Requires the read:content scope.

GET /v1/content/{draft_id}/suggestions

Authorization

HeaderTypeRequired
AuthorizationBearer asky_sk_…required

Path parameters

ParameterTypeRequiredDescription
draft_iduuidrequiredFrom List content drafts

Query parameters

ParameterTypeRequiredDescription
limitintegeroptionalSets per page, newest first, 1 to 20. Defaults to 20.
cursorstringoptionalOpaque cursor from the previous response. Treat it as a token, never construct one.

Request

curl 'https://api.askylabs.com/v1/content/7c1e2b90-3f4d-4a8e-9b21-5d6f7a8b9c0d/suggestions' \ -H "Authorization: Bearer $ASKY_API_KEY"

Response

{ "data": [ { "suggestion_id": "0b9d6c4e-21a7-4f3b-8e5d-9c1a2b3c4d5e", "origin": "api", "status": "open", "created_at": "2026-11-19T10:12:03.418211+00:00", "resolved_at": null, "suggestions": [ { "group_id": "e-3fa9c1d2-0", "reason": "Answers the question in the first sentence, which AI answers quote most.", "category": "answers", "state": "pending", "edits": [{ "op": "replace", "index": 1, "preview": "A CRM gives a small team one shared record of every customer..." }] } ] } ], "pagination": { "limit": 20, "has_more": false, "next_cursor": null }, "meta": { "draft_id": "7c1e2b90-3f4d-4a8e-9b21-5d6f7a8b9c0d" }, "request_id": "req_e5f14ac0015b4d63a91a" }

Response fields

FieldTypeDescription
data[]objectOne suggestion set, newest first
data[].suggestion_iduuidrequired
data[].origin"api" | "content_refresh"required
data[].status"open" | "resolved" | "dismissed"required
data[].suggestions[].state"pending" | "accepted" | "declined" | "closed"required
data[].suggestions[].edits[]arrayrequired. op, index and a text preview of the new html
pagination.has_morebooleanrequired. More sets wait behind next_cursor
pagination.next_cursorstring | nullrequired. Pass as cursor for the next page
meta.draft_iduuidrequired. The draft the sets are on
request_idstringrequired
Last updated on