Count what became of drafts
social.feedback.summary@1
Count, for each recipe version, the drafts made and how many were kept as made, kept after changes, skipped or deleted, split by who decided, with how often each reason was given. Counts and reason words only: no free text, no rate, no ranking, no advice.
How did each recipe's drafts go
Plain counts. Small numbers are counts, not rates.
# 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": "summarizeFeedback",
"contractRef": "social.feedback.summary@1"
},
"operationId": "feedback-summary-1",
"input": {}
}'
// 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": "summarizeFeedback",
"contractRef": "social.feedback.summary@1"
},
"operationId": "feedback-summary-1",
"input": {}
}),
},
);
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": "summarizeFeedback",
"contractRef": "social.feedback.summary@1",
},
"operationId": "feedback-summary-1",
"input": {},
},
timeout=30,
)
print(response.status_code, response.json())
Parameters
What goes in input:
| Name | Type | Required | Description |
|---|---|---|---|
since |
string | No | Count only drafts recorded at or after this instant. |
Response
A call that worked answers 200 with an applied receipt; its output holds these fields, among others. GET /catalog/social.feedback.summary@1 answers the complete shape as JSON Schema.
| Name | Type | Description |
|---|---|---|
since |
string or null | When the first counted draft was recorded; null when none was. Drafts made before recording began are counted only once someone acts on them. |
recipes |
array of object | One entry per recipe version. |
recipes[].presetRef |
string or null | The recipe; null for drafts whose recipe could not be read. |
recipes[].made |
integer | Drafts recorded for this recipe version. |
recipes[].waiting |
integer | Of those, drafts nothing has decided yet. |
recipes[].keptAsMade |
integer | Approved without a change to the caption or picture. |
recipes[].keptAfterChanges |
integer | Approved after a change. |
recipes[].skipped |
integer | Skipped and not yet kept or deleted. Never a dislike. |
recipes[].deleted |
integer | Deleted, unless restored. |
recipes[].byKind |
object | The same four counts split by person, agent and automation. |
recipes[].reasons |
array of object | How many times each reason was given. |
truncated |
boolean | True when more than 100 recipe versions had drafts and only the first 100 are listed. |
{
"status": "applied",
"operationId": "feedback-summary-1",
"output": {
"truncated": false,
"since": "2026-11-14T16:00:00+00:00",
"recipes": [
{
"presetRef": "YOUR_RECIPE_ID",
"version": 1,
"title": "A post from a brief",
"made": 3,
"waiting": 1,
"keptAsMade": 1,
"keptAfterChanges": 0,
"skipped": 1,
"deleted": 0,
"byKind": {
"person": {
"keptAsMade": 1,
"keptAfterChanges": 0,
"skipped": 1,
"deleted": 0
},
"agent": {
"keptAsMade": 0,
"keptAfterChanges": 0,
"skipped": 0,
"deleted": 0
},
"automation": {
"keptAsMade": 0,
"keptAfterChanges": 0,
"skipped": 0,
"deleted": 0
}
},
"reasons": [
{
"reason": "not-our-style",
"count": 1
}
]
}
]
}
}
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. |