content

Create a content draft

Starts a new piece of social content from a goal for a business. The response arrives immediately with the queued draft; the writing continues in the background.

Poll Get a content draft and watch phase: queued, gathering, synthesizing and drafting mean it is still working; interviewing and review mean it is waiting on you (answer questions, or confirm); ready and failed are final.

Creating a draft counts against the plan's monthly draft allowance.

Errors

  • 402 LIMIT_REACHED: social content is not in the plan, or this month's allowance is spent. The body is a LimitReachedBody; read reason to tell NOT_IN_PLAN from QUOTA_SPENT, because only the second one comes back on a date (resetAt).
  • 400 VALIDATION_ERROR: the body failed validation; details.issues[] names each field.
post/api/v1/content

Request

  • Base URL: https://api.growomat.com
  • URL: https://api.growomat.com/api/v1/content
  • Auth: HTTP bearer

Headers

X-Space-Idstring

The Space to work in, for example spc_8f3aK2. Omit it to use your personal Space. List your Spaces returns the ids. A Space that does not exist returns 404 SPACE_NOT_FOUND; one you are not a member of returns 403 NOT_A_MEMBER.

Request body

goalstring required

What the piece should say: the idea that is researched and drafted.

businessIdstring required

The business the piece is written for. Its brand voice applies.

researchEnabledboolean

Ground the piece in web research. When off, no sources are attached and no source sign-off is needed.

recencyDaysinteger

Only use sources newer than this many days.

Response

OK. The result is in data. List responses also carry meta with nextCursor and total.

dataunknown required

Changes

No recorded changes to this operation across all 2 revisions of this API.