Innlegg

Hent alle innlegg

Uten brødtekst, og uten paginering: lista gir alt på én gang. Hent ett innlegg for å få innholdet.

{
  "posts": [
    {
      "id": "pst_4Wm7",
      "slug": "sommerbrev",
      "title": "Sommerbrev",
      "status": "published",
      "updated_at": "2026-07-19T07:30:00.000Z"
    }
  ]
}

# Kaller skribb-klienten: https://skribb.no/utviklere/autentisering#klient
skribb "/posts"

Opprett en kladd

Sender du title og content i samme kall, får du et ferdig innlegg av én forespørsel. Send Idempotency-Key, så er det trygt å prøve igjen om svaret går tapt. Går kladden i orden, men innholdet ikke inn, svarer vi 502 og gir deg likevel id-en, så du kan prøve igjen mot den i stedet for å sitte igjen med et tomt innlegg. Sender du slug, blir opprettelsen idempotent på den adressen: neste gang samme slug kommer inn, svarer vi 409 slug-taken i stedet for å lage en tvilling. Det er en annen garanti enn Idempotency-Key, og de finnes begge fordi de svarer på hvert sitt spørsmål: nøkkelen dekker én forespørsel som kanskje ble sendt to ganger, i et døgn. Slugen dekker «har jeg skrevet dette før», på tvers av kjøringer, uker fra hverandre, uten at noe må huskes imellom.

# Kaller skribb-klienten: https://skribb.no/utviklere/autentisering#klient
skribb "/posts" \
  -X POST \
  -H "content-type: application/json" \
  -d '{
    "title": "Sommerbrev",
    "slug": "sommerbrev",
    "markdown": "## Juli\n\nDet ble en lang måned.",
    "tags": [
      "brev"
    ],
    "publish": true
  }'

Hent ett innlegg med brødtekst

Legg til ?format=markdown for å få feltene markdown og markdown_dropped ved siden av content. Markdown kan ikke bære skribbs egne blokker, altså betalingsmur, nivåsperre og abonnent-kort, så markdown_dropped navngir det som ikke ble med. Er lista tom, gikk alt inn. content er der uansett.

?format

markdown, eller utelat for bare Portable Text.

# Kaller skribb-klienten: https://skribb.no/utviklere/autentisering#klient
post_id="pst_4Wm7"

skribb "/posts/$post_id?format=markdown"

Endre, eventuelt publiser

Ekte delvis endring: felt du ikke sender, blir stående. Retter du en tittel, står brødteksten der etterpå. Send minst ett felt, ellers svarer vi 422 empty-update.

# Kaller skribb-klienten: https://skribb.no/utviklere/autentisering#klient
post_id="pst_4Wm7"

skribb "/posts/$post_id" \
  -X PATCH \
  -H "content-type: application/json" \
  -d '{
    "publish": true,
    "send_newsletter": false
  }'

Send innlegget som nyhetsbrev

Et publisert innlegg går ut til abonnentene som har bedt om å få det, med det samme, og en utsending kan ikke tas tilbake. Derfor har ruta sin egen tilgang, som aldri følger med posts:write, og derfor krever den Idempotency-Key: går svaret tapt underveis, er du den eneste som vet at de to forespørslene var den samme. Hvert innlegg går ut én gang. Har det gått ut før, svarer vi 409 already-sent, og det finnes ingen force. Publiserte du med send_newsletter: false, teller sperren som en utsending. dry_run: true svarer med hvor mange brevet ville gått til, uten å sende noe og uten å kreve en nøkkel, og avviser det samme en ekte utsending ville avvist, så en prøve er et ekte svar på «hva skjer om jeg gjør dette».

Idempotency-Key:

En verdi du finner på selv, unik for denne utsendingen. Påkrevd for en ekte utsending, unødvendig på en prøve. Prøver du igjen med den samme, får du svaret fra første gang i stedet for et brev til.

{
  "send": {
"post_id": "sommerbrev",
"dry_run": false,
"recipient_count": 412,
"sent_count": 411,
"failed_count": 1
  }
}

# Kaller skribb-klienten: https://skribb.no/utviklere/autentisering#klient
post_id="pst_4Wm7"

skribb "/posts/$post_id/send" \
  -X POST \
  -H "content-type: application/json" \
  -d '{
    "dry_run": true
  }'

Sett en kladd i kø

Kladden publiseres av seg selv på tidspunktet du oppgir, av den samme jobben som publiserer det du planlegger i oversikten. publish_at er ISO 8601, som alle andre tidspunkt her: oversikten leser Oslo-tid fra en datovelger fordi et menneske som skriver 14:30, mener 14:30 der det står, mens du som sender JSON, mener et øyeblikk. Å gjette en tidssone på dine vegne er slik et innlegg går ut to timer for tidlig to ganger i året. Ett innlegg kan bare stå i kø én gang: står det allerede i kø, svarer vi 409 og sier når. Planlegging krever en betalt pakke på publikasjonen.

# Kaller skribb-klienten: https://skribb.no/utviklere/autentisering#klient
post_id="pst_4Wm7"

skribb "/posts/$post_id/schedule" \
  -X POST \
  -H "content-type: application/json" \
  -d '{
    "publish_at": "2026-08-01T06:00:00Z"
  }'

Se når et innlegg går ut

404 betyr at innlegget ikke står i kø, ikke at innlegget ikke finnes. Et innlegg som allerede er publisert, eller som ble avlyst, står ikke i kø lenger.

# Kaller skribb-klienten: https://skribb.no/utviklere/autentisering#klient
post_id="pst_4Wm7"

skribb "/posts/$post_id/schedule"

Avlys en køplass

Kladden blir stående urørt og kan settes i kø igjen. Dette er også veien til å flytte et tidspunkt: avlys, og legg det inn på nytt.

# Kaller skribb-klienten: https://skribb.no/utviklere/autentisering#klient
post_id="pst_4Wm7"

skribb "/posts/$post_id/schedule" \
  -X DELETE