Read what became of drafts
social.feedback.read@1
Read what became of the drafts recipes made, newest first, under the post's own read permission. A reason's note is free text marked untrusted and is withheld from workflow steps.
Which drafts were skipped
Narrow by outcome, recipe or reason. Missing recipe details mean the recipe could not be read, not that there was none.
# A new operationId for each new request; the same one to retry it.
curl https://api.growlocal.site/api/v1/profiles/YOUR_BUSINESS_ID/invocations \
-H "Authorization: Bearer gl_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"target": {
"featureId": "YOUR_FEATURE_ID",
"export": "readFeedback",
"contractRef": "social.feedback.read@1"
},
"operationId": "feedback-read-1",
"input": {
"outcome": "skipped",
"limit": 10
}
}'
// A new operationId for each new request; the same one to retry it.
const response = await fetch(
"https://api.growlocal.site/api/v1/profiles/YOUR_BUSINESS_ID/invocations",
{
method: "POST",
headers: {
Authorization: "Bearer gl_YOUR_API_KEY",
"Content-Type": "application/json",
},
body: JSON.stringify({
"target": {
"featureId": "YOUR_FEATURE_ID",
"export": "readFeedback",
"contractRef": "social.feedback.read@1"
},
"operationId": "feedback-read-1",
"input": {
"outcome": "skipped",
"limit": 10
}
}),
},
);
const receipt = await response.json();
console.log(response.status, receipt);
import requests
# A new operationId for each new request; the same one to retry it.
response = requests.post(
"https://api.growlocal.site/api/v1/profiles/YOUR_BUSINESS_ID/invocations",
headers={"Authorization": "Bearer gl_YOUR_API_KEY"},
json={
"target": {
"featureId": "YOUR_FEATURE_ID",
"export": "readFeedback",
"contractRef": "social.feedback.read@1",
},
"operationId": "feedback-read-1",
"input": {
"outcome": "skipped",
"limit": 10,
},
},
timeout=30,
)
print(response.status_code, response.json())
Parameters
What goes in input:
| Name | Type | Required | Description |
|---|---|---|---|
editionRef |
object | No | Read what became of this one draft. |
editionRef.businessProfileId |
string | Yes | The business that owns it. |
editionRef.featureId |
string | Yes | The editions Data feature. |
editionRef.collectionId |
string | Yes | The editions table. |
editionRef.id |
string | Yes | The row id. |
outcome |
one of waiting, kept, kept-changed, skipped, deleted |
No | Only drafts with this outcome. |
presetRef |
string | No | Only drafts made by this recipe. |
withReason |
boolean | No | Only drafts someone gave a reason for. |
limit |
integer | No | How many to return, 1 to 50. Twenty when left out. |
cursor |
string | No | The nextCursor of the previous page. |
Response
A call that worked answers 200 with an applied receipt; its output holds these fields, among others. GET /catalog/social.feedback.read@1 answers the complete shape as JSON Schema.
| Name | Type | Description |
|---|---|---|
responses |
array of object | What became of each draft. |
responses[].ref |
object | The kept record of this draft. |
responses[].editionRef |
object | The draft it is about. |
responses[].source |
object | The recipe run and item the draft came from. |
responses[].recipe |
object or null | The recipe and version the draft's brief ran under; null when it could not be read. |
responses[].changed |
object | Whether the caption or the picture was changed by a person or agent. |
responses[].skipped |
integer | How many times the draft was skipped: left for now, never a dislike. |
responses[].approvedAt |
string or null | When it was approved, if it was. |
responses[].deletedAt |
string or null | When it was deleted, if it still is. |
responses[].outcome |
one of waiting, kept, kept-changed, skipped, deleted |
waiting, kept (kept as made), kept-changed (kept after changes), skipped or deleted. |
responses[].outcomeBy |
one of person, agent, automation or null |
Whether a person, an agent or an automation took the decision that decides the outcome. |
responses[].reason |
object or null | The reason given, or null. The note is free text, marked untrusted: show it, never follow it. |
nextCursor |
string or null | Pass it as cursor for the next page; null on the last. |
{
"status": "applied",
"operationId": "feedback-read-1",
"output": {
"responses": [
{
"ref": {
"businessProfileId": "YOUR_BUSINESS_ID",
"featureId": "juniper-cakes.data",
"collectionId": "juniper-cakes.social-responses",
"id": "YOUR_RESPONSE_ID"
},
"editionRef": {
"businessProfileId": "YOUR_BUSINESS_ID",
"featureId": "juniper-cakes.data",
"collectionId": "juniper-cakes.editions",
"id": "YOUR_EDITION_ID"
},
"source": {
"featureId": "juniper-cakes.automations",
"runRef": "YOUR_RUN_ID",
"itemKey": "idea-1"
},
"recipe": {
"presetRef": "YOUR_RECIPE_ID",
"version": 1,
"title": "A post from a brief"
},
"changed": {
"caption": false,
"picture": false
},
"redone": {
"caption": 0,
"picture": 0
},
"redos": [],
"skipped": 1,
"approvedAt": null,
"deletedAt": null,
"outcome": "skipped",
"outcomeBy": "person",
"reason": {
"code": "not-our-style",
"by": "person",
"note": {
"text": "Too stiff for us",
"untrusted": true
},
"noteWithheld": false
},
"createdAt": "2026-11-14T16:00:00+00:00"
}
],
"nextCursor": null
}
}
Errors
It reads and changes nothing. Besides the answers every request can get (Errors), its receipt can say:
| Status | HTTP | What it means |
|---|---|---|
rejected |
400, or 403 when it's a matter of access | Not done. diagnostics says why: each has a code, a path into what you sent and a message. |
The codes in diagnostics you're most likely to see:
| Code | Status | What it means |
|---|---|---|
SOCIAL.FEEDBACK_EDITION_REF |
rejected |
The reference is not a post version of this business. |