Skip to article
crumbless.
Docs
Contents

Posts

Create, approve, schedule, publish, and manage posts.

GET /brands/:slug/posts

List posts, optionally filtered by status.

Query
?status=pending_user | approved | scheduled | published | failed
Responses
200Array of posts
401Invalid token

Use your running CRUMBLESS_API_BASE_URL and matching CRUMBLESS_API_TOKEN. API setup

curl -X GET \
  "$CRUMBLESS_API_BASE_URL/brands/:slug/posts" \
  -H "Authorization: Bearer $CRUMBLESS_API_TOKEN"
PUT /brands/:slug/posts/:id

Update a post.

Request Body
{ "caption": "New text", "platforms": ["instagram"] }
Responses
200Updated
404Not found

Use your running CRUMBLESS_API_BASE_URL and matching CRUMBLESS_API_TOKEN. API setup

curl -X PUT \
  "$CRUMBLESS_API_BASE_URL/brands/:slug/posts/:id" \
  -H "Authorization: Bearer $CRUMBLESS_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "caption": "New text", "platforms": ["instagram"] }'
POST /brands/:slug/posts/:id/approve

Approve and publish a single post.

Responses
200Approved

Use your running CRUMBLESS_API_BASE_URL and matching CRUMBLESS_API_TOKEN. API setup

curl -X POST \
  "$CRUMBLESS_API_BASE_URL/brands/:slug/posts/:id/approve" \
  -H "Authorization: Bearer $CRUMBLESS_API_TOKEN"
POST /brands/:slug/posts/approve-all

Approve all pending posts.

Responses
200Bulk result

Use your running CRUMBLESS_API_BASE_URL and matching CRUMBLESS_API_TOKEN. API setup

curl -X POST \
  "$CRUMBLESS_API_BASE_URL/brands/:slug/posts/approve-all" \
  -H "Authorization: Bearer $CRUMBLESS_API_TOKEN"
POST /brands/:slug/posts/:id/publish

Publish immediately.

Responses
200Published

Use your running CRUMBLESS_API_BASE_URL and matching CRUMBLESS_API_TOKEN. API setup

curl -X POST \
  "$CRUMBLESS_API_BASE_URL/brands/:slug/posts/:id/publish" \
  -H "Authorization: Bearer $CRUMBLESS_API_TOKEN"
POST /brands/:slug/posts/:id/reschedule

Reschedule a post.

Request Body
{ "scheduled_for": "2026-06-22T14:00:00Z" }
Responses
200Rescheduled

Use your running CRUMBLESS_API_BASE_URL and matching CRUMBLESS_API_TOKEN. API setup

curl -X POST \
  "$CRUMBLESS_API_BASE_URL/brands/:slug/posts/:id/reschedule" \
  -H "Authorization: Bearer $CRUMBLESS_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "scheduled_for": "2026-06-22T14:00:00Z" }'
DELETE /brands/:slug/posts/:id

Delete a post (pending_user only).

Responses
200Deleted

Use your running CRUMBLESS_API_BASE_URL and matching CRUMBLESS_API_TOKEN. API setup

curl -X DELETE \
  "$CRUMBLESS_API_BASE_URL/brands/:slug/posts/:id" \
  -H "Authorization: Bearer $CRUMBLESS_API_TOKEN"