POST /api/articles/[id]/publish
Publish an article — assign a slug once, mark it published, stamp publishedAt, and return the public /story/<slug> URL. Idempotent.
The CLI equivalent is scripto articles publish <id>, which prints the URL to paste into Medium’s “Import a story”.
Publishes the article (owner-scoped): assigns a slug once, marks it published, stamps publishedAt the first time, and returns the absolute public URL Medium’s importer fetches. Idempotent — re-publishing keeps the existing slug and publishedAt.
Endpoint
POST https://scripto.codika.io/api/articles/{id}/publishAuth
Authorization: Bearer scripto_…
Request
No body.
Response (200)
{
"success": true,
"data": {
"slug": "our-launch",
"url": "https://scripto.codika.io/story/our-launch",
"status": "published"
}
}The slug is minted from the title; on a collision a short, stable suffix (the last 6 of the uuid) is appended, so the same article always resolves to the same slug.
Errors
| HTTP | code | Cause |
|---|---|---|
| 401 | unauthenticated | Missing or invalid key. |
| 404 | not-found | No such article, or you don’t own it. |
| 500 | internal | Backend error. |
curl
curl -sS -X POST "https://scripto.codika.io/api/articles/$ID/publish" \
-H "Authorization: Bearer $SCRIPTO_API_KEY"Next
- Import, don’t paste — what happens when Medium fetches the URL.
- POST /api/articles/import — the reverse direction.