Skip to content

by Startups.Studio

Content.draft

POST /{namespace}/content/draft

Draft writes Content of one kind from a brief, such as an article for a question the help center could not answer.

Noun: Content
Mode: do
Event: Content.drafted

You, to your agent

Draft the latest content.

curl -X POST https://api.sb/quietcopy.com/content/draft \
  -H "Authorization: Bearer $STARTUP_BUILDER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"kind":"article","brief":"Example brief"}'

import { $ } from 'startup-builder'

const content = await $.Content.draft({ kind: 'article', brief: 'Example brief' })

npx startup-builder do Content.draft --json '{"kind":"article","brief":"Example brief"}'

{
  "name": "do",
  "arguments": {
    "code": "return await $.Content.draft({ kind: 'article', brief: 'Example brief' })"
  }
}

Inputs

Input	Type	Required	Description
`kind`	`string`	required	What to write.
`brief`	`text`	required	The question or brief it answers.

Outputs

Output	Type	Required	Description
`content`	Content	required	The draft.

Effects

Emits Content.drafted.
Performed by the Content Lead.
Two-way: it runs at once, in the try, send and do modes.

Refuses when

Check	Error	Fix	Then call
The key is valid, but its scopes do not allow this operation.	`forbidden`	Use a key whose scopes cover the operation, or ask an owner of the namespace to grant them.	Content.draft

When it waits

Gate	Default
Decision class	Low: two-way, nothing at stake
Delay window	None: it runs once review passes.
Limit	The call Limit of the Permission it runs under.
Over the Limit	It waits `pending` for an Approval from the Founder. Approved, it runs; refused, it ends `refused` with `limit-exceeded`; unanswered by its deadline, it ends `canceled`.

Content.delete

Previous Page

Content.get

Next Page