Blog

Create post

POST/api/v1/blog

Creates a blog post. Staff-only.

Requires Authorization

ADMIN, SUPPORT only

Authenticated action

Form fields

`title`stringrequired
`excerpt`stringrequired
`content`stringrequired	HTML content.
`status`string	DRAFT or PUBLISHED. Defaults to DRAFT.
`coverImage`file

Request

curl --request POST \
  --url https://api.swiftgoma.com/api/v1/blog \
  --header 'Authorization: Bearer <access_token>' \
  --form 'title=<title>' \
  --form 'excerpt=<excerpt>' \
  --form 'content=<content>' \
  --form 'status=<status>' \
  --form 'coverImage=@/path/to/file.jpg'

201Example response

{
  "success": true,
  "data": {
    "id": "post_1a2b3c",
    "authorId": "9f8e7d6c",
    "title": "Comment bien démarrer sur SwiftGoma",
    "slug": "comment-bien-demarrer-sur-swiftgoma",
    "excerpt": "Un guide rapide pour les nouveaux vendeurs.",
    "content": "<p>Contenu de l'article…</p>",
    "coverImageUrl": "https://res.cloudinary.com/dx3wclabo/image/upload/v1/blog/demarrer.jpg",
    "status": "PUBLISHED",
    "publishedAt": "2026-02-01T09:00:00.000Z"
  }
}