Scripto docs
View as Markdown

GET /api/articles/[id]/brief

The handoff read — an article's premise plus every note grouped by kind, full bodies rendered, in one call. Backs scripto brief.

The CLI equivalent is scripto brief <id> — the first thing a fresh agent runs to pick up an article.

Returns the article’s Brief: the premise plus every note grouped by kind (full bodies, rendered), so a fresh agent gets oriented in one call. Owner-scoped.

Endpoint

GET https://scripto.codika.io/api/articles/{id}/brief

Auth

Authorization: Bearer scripto_…

Response (200)

{
  "success": true,
  "data": {
    "article": { "id": "0a1b2c3d-…", "title": "Our launch", "status": "draft" },
    "brief": {
      "premise": "A go-to-market piece: the install is the pitch.",
      "groups": {
        "source": [ { "anchor": "1a2b3c4d", "title": "Medium import docs", "url": "https://…", "html": "…" } ],
        "decision": [ "…" ],
        "idea": [ "…" ],
        "question": [ "…" ]
      }
    }
  }
}

Errors

HTTPcodeCause
401unauthenticatedMissing or invalid key.
404not-foundNo such article, or you don’t own it.
500internalBackend error.

curl

curl -sS "https://scripto.codika.io/api/articles/$ID/brief" \
  -H "Authorization: Bearer $SCRIPTO_API_KEY"

Next