Content API

List and view your community’s content, and change when it’s published. Before you start, read the API overview for how authentication, headers, pagination and errors work.

List contents

Return a paginated list of your published content.

List contents

curl "https://your-community.zapnito.com/api/v1/contents" \
  -H "Authorization: Token token=YOUR_API_TOKEN" \
  -H "Content-Type: application/json; charset=utf-8"

GET https://your-community.zapnito.com/api/v1/contents

{
  "contents": [
    {
      "type": "Post",
      "title": "Preparing for an audit",
      "introduction": "A practical checklist for getting ready for your first audit.",
      "url": "https://your-community.zapnito.com/posts/2-preparing-for-an-audit",
      "canonical_url": "https://your-community.zapnito.com/users/3-maya-patel/posts/2-preparing-for-an-audit",
      "thumbnail_url": null,
      "published_at": "2026-03-10T09:00:00Z",
      "created_at": "2026-03-09T16:30:00Z"
    }
  ]
}

Get content

Return a single piece of content.

string

required

The ID or slug of the content.

string

The URL-encoded DOI, if one has been allocated to the content.

Get content

curl "https://your-community.zapnito.com/api/v1/contents/2-preparing-for-an-audit" \
  -H "Authorization: Token token=YOUR_API_TOKEN" \
  -H "Content-Type: application/json; charset=utf-8"

GET https://your-community.zapnito.com/api/v1/contents/:id

{
  "content": {
    "type": "Post",
    "title": "Preparing for an audit",
    "introduction": "A practical checklist for getting ready for your first audit.",
    "url": "https://your-community.zapnito.com/posts/2-preparing-for-an-audit",
    "canonical_url": "https://your-community.zapnito.com/users/3-maya-patel/posts/2-preparing-for-an-audit",
    "thumbnail_url": null,
    "published_at": "2026-03-10T09:00:00Z",
    "created_at": "2026-03-09T16:30:00Z"
  }
}

Publish content

Publish a draft or scheduled piece of content. This endpoint doesn’t accept a published_at date and time. Zapnito sets published_at to the time it receives the request.

string

required

The ID or slug of the content.

Publish content

curl -X POST "https://your-community.zapnito.com/api/v1/contents/2-preparing-for-an-audit/publish" \
  -H "Authorization: Token token=YOUR_API_TOKEN" \
  -H "Content-Type: application/json; charset=utf-8"

POST https://your-community.zapnito.com/api/v1/contents/:id/publish

{
  "contents": [
    {
      "type": "Post",
      "title": "Preparing for an audit",
      "introduction": "A practical checklist for getting ready for your first audit.",
      "url": "https://your-community.zapnito.com/posts/2-preparing-for-an-audit",
      "canonical_url": "https://your-community.zapnito.com/users/3-maya-patel/posts/2-preparing-for-an-audit",
      "thumbnail_url": null,
      "published_at": "2026-03-10T09:00:00Z",
      "scheduled_at": null,
      "created_at": "2026-03-09T16:30:00Z"
    }
  ]
}

Unpublish content

Move a published piece of content back to draft.

Unpublishing removes access to the content across your community until you publish it again.

string

required

The ID or slug of the content.

Unpublish content

curl -X POST "https://your-community.zapnito.com/api/v1/contents/2-preparing-for-an-audit/unpublish" \
  -H "Authorization: Token token=YOUR_API_TOKEN" \
  -H "Content-Type: application/json; charset=utf-8"

POST https://your-community.zapnito.com/api/v1/contents/:id/unpublish

{
  "contents": [
    {
      "type": "Post",
      "title": "Preparing for an audit",
      "introduction": "A practical checklist for getting ready for your first audit.",
      "url": "https://your-community.zapnito.com/posts/2-preparing-for-an-audit",
      "canonical_url": "https://your-community.zapnito.com/users/3-maya-patel/posts/2-preparing-for-an-audit",
      "thumbnail_url": null,
      "published_at": null,
      "scheduled_at": null,
      "created_at": "2026-03-09T16:30:00Z"
    }
  ]
}

Schedule content

Schedule a piece of content to be published at a future time.

string

required

The ID or slug of the content.

string

required

When to publish the content, as an ISO 8601 formatted string, for example 2026-03-10T09:00:00Z.

Schedule content

curl -X POST "https://your-community.zapnito.com/api/v1/contents/2-preparing-for-an-audit/schedule" \
  -H "Authorization: Token token=YOUR_API_TOKEN" \
  -H "Content-Type: application/json; charset=utf-8" \
  -d '{"scheduled_at": "2026-03-10T09:00:00Z"}'

POST https://your-community.zapnito.com/api/v1/contents/:id/schedule

{
  "contents": [
    {
      "type": "Post",
      "title": "Preparing for an audit",
      "introduction": "A practical checklist for getting ready for your first audit.",
      "url": "https://your-community.zapnito.com/posts/2-preparing-for-an-audit",
      "canonical_url": "https://your-community.zapnito.com/users/3-maya-patel/posts/2-preparing-for-an-audit",
      "thumbnail_url": null,
      "published_at": null,
      "scheduled_at": "2026-03-10T09:00:00Z",
      "created_at": "2026-03-09T16:30:00Z"
    }
  ]
}

Getting started

Users

Groups and organisations

Content

Channels and rooms

Badges

List contents

Get content

Publish content

Unpublish content

Schedule content

​List contents

​Get content

​Publish content

​Unpublish content

​Schedule content

List contents

Get content

Publish content

Unpublish content

Schedule content