Quickstart

The public v1 API dispatches asynchronous work to an existing Scribe. Create an organization API key, choose a Scribe ID, submit a task, then poll the receipt.

1. Add your API key

export OBELISK_API_KEY=obk_...

2. Submit a task

curl -X POST "https://www.obelisk.li/api/v1/scribes/$SCRIBE_ID/requests" \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: $OBELISK_API_KEY" \
  -d '{
    "task": {
      "summary": "Review yesterday's support tickets and summarize blockers.",
      "acceptance_criteria": "A blocker list, customer impact notes, and recommended next actions."
    }
  }'

3. Poll the receipt

curl "https://www.obelisk.li/api/v1/requests/$REQUEST_ID" \
  -H "X-Api-Key: $OBELISK_API_KEY"

Current public surface: task dispatch, receipt polling, request listing, and URL attachments. Schedules, inbound channels, and full audit review are available in Obelisk today but are not public write endpoints in v1.