Record that a draft was skipped, or why

social.feedback.record@1

Record that a draft a recipe made was skipped, or, after it was skipped or deleted, why. Requires Write social. Nothing else about the draft changes and no reason is ever required; approving, editing, deleting and restoring a draft record themselves. A skip means left for now, never a dislike.

Say why a skipped draft was set aside

A reason follows a skip or a delete only, and is optional. Record the skip first.

# 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": "recordFeedback",
    "contractRef": "social.feedback.record@1"
  },
  "operationId": "feedback-record-1",
  "input": {
    "editionRef": {
      "businessProfileId": "YOUR_BUSINESS_ID",
      "featureId": "juniper-cakes.data",
      "collectionId": "juniper-cakes.editions",
      "id": "YOUR_EDITION_ID"
    },
    "signal": "reason",
    "reason": "not-our-style",
    "note": "Too stiff for us"
  }
}'
// 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": "recordFeedback",
        "contractRef": "social.feedback.record@1"
      },
      "operationId": "feedback-record-1",
      "input": {
        "editionRef": {
          "businessProfileId": "YOUR_BUSINESS_ID",
          "featureId": "juniper-cakes.data",
          "collectionId": "juniper-cakes.editions",
          "id": "YOUR_EDITION_ID"
        },
        "signal": "reason",
        "reason": "not-our-style",
        "note": "Too stiff for us"
      }
    }),
  },
);
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": "recordFeedback",
            "contractRef": "social.feedback.record@1",
        },
        "operationId": "feedback-record-1",
        "input": {
            "editionRef": {
                "businessProfileId": "YOUR_BUSINESS_ID",
                "featureId": "juniper-cakes.data",
                "collectionId": "juniper-cakes.editions",
                "id": "YOUR_EDITION_ID",
            },
            "signal": "reason",
            "reason": "not-our-style",
            "note": "Too stiff for us",
        },
    },
    timeout=30,
)
print(response.status_code, response.json())

Parameters

What goes in input:

Name Type Required Description
editionRef object Yes The draft a recipe made that this is about.
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.
signal one of skipped, reason, reason-cleared Yes skipped: the draft was left for now. reason: why a draft that was skipped or deleted was set aside. reason-cleared: take the reason back.
reason one of not-our-style, not-true, wrong-tone, wrong-picture, not-what-i-asked, not-now, other No With reason: one of not-our-style, not-true, wrong-tone, wrong-picture, not-what-i-asked, not-now or other.
note string No With reason: a few words of your own, up to 500 characters. Never shown in counts.

Response

A call that worked answers 200 with an applied receipt; its output holds these fields, among others. GET /catalog/social.feedback.record@1 answers the complete shape as JSON Schema.

Name Type Description
response object What became of the draft now.
response.ref object The kept record of this draft.
response.editionRef object The draft it is about.
response.source object The recipe run and item the draft came from.
response.recipe object or null The recipe and version the draft's brief ran under; null when it could not be read.
response.changed object Whether the caption or the picture was changed by a person or agent.
response.skipped integer How many times the draft was skipped: left for now, never a dislike.
response.approvedAt string or null When it was approved, if it was.
response.deletedAt string or null When it was deleted, if it still is.
response.outcome one of waiting, kept, kept-changed, skipped, deleted waiting, kept (kept as made), kept-changed (kept after changes), skipped or deleted.
response.outcomeBy one of person, agent, automation or null Whether a person, an agent or an automation took the decision that decides the outcome.
response.reason object or null The reason given, or null. The note is free text, marked untrusted: show it, never follow it.
{
  "status": "applied",
  "operationId": "feedback-record-1",
  "output": {
    "response": {
      "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"
    }
  }
}

Errors

Besides the answers every request can get (Errors), its receipt can say:

Status HTTP What it means
pending 202 Accepted and still running. Look it up with GET /operations/{operationId}.
uncertain 202 GrowLocal can't yet tell whether it took effect. Look it up before trying again.
requirements 409 Something must happen first; the receipt lists what.
conflict 409 The row changed since you read it, or this operationId was used with a different body.
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_NO_DECISION rejected A reason was sent for a draft that was neither skipped nor deleted.
SOCIAL.FEEDBACK_NOT_RECIPE_MADE rejected The draft was made by hand, so nothing is counted for it.
SOCIAL.FEEDBACK_REASON_THEIRS rejected An agent or automation tried to change a reason a person gave.