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.