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.acceptedordeclined: 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}/suggestionsAuthorization
| Header | Type | Required |
|---|---|---|
Authorization | Bearer asky_sk_… | required |
Path parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
draft_id | uuid | required | From List content drafts |
Query parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
limit | integer | optional | Sets per page, newest first, 1 to 20. Defaults to 20. |
cursor | string | optional | Opaque 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
200
{
"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
| Field | Type | Description |
|---|---|---|
data[] | object | One suggestion set, newest first |
data[].suggestion_id | uuid | required |
data[].origin | "api" | "content_refresh" | required |
data[].status | "open" | "resolved" | "dismissed" | required |
data[].suggestions[].state | "pending" | "accepted" | "declined" | "closed" | required |
data[].suggestions[].edits[] | array | required. op, index and a text preview of the new html |
pagination.has_more | boolean | required. More sets wait behind next_cursor |
pagination.next_cursor | string | null | required. Pass as cursor for the next page |
meta.draft_id | uuid | required. The draft the sets are on |
request_id | string | required |
Last updated on