Posts API

Posts are the content items within a channel, blog articles, LinkedIn posts, newsletter editions, etc. Posts are always accessed through their parent channel.

Endpoints

List Posts

Retrieve a paginated list of posts for a given channel.

GET /channels/{channel_id}/posts

Path Parameters

Query Parameters

Example Request

curl -s "https://api.wortfreunde.ch/v1/channels/161/posts?limit=2" \
  -H "Authorization: Bearer $WORTFREUNDE_API_KEY" | python3 -m json.tool

Response

{
  "data": [
    {
      "id": 214,
      "title": "Warum strukturierte Content-Planung mehr bringt als spontane Posts",
      "teaser": "Montagmorgen. Der Cursor blinkt. Was soll ich heute posten?...",
      "slug": "strukturierte-content-planung-vs-spontane-posts",
      "publication_status": "published",
      "created_at": "2026-03-02T16:54:36.465Z",
      "updated_at": "2026-03-09T05:00:48.275Z",
      "channel": {
        "id": 161,
        "title": "Blog",
        "platform": "git",
        "team": {
          "id": 42,
          "name": "Wortfreunde"
        },
        "posts_count": 3
      }
    },
    {
      "id": 208,
      "title": "Content-Produktion effizient gestalten: 7 Strategien fuer Fuehrungskraefte",
      "teaser": "Viele Fuehrungskraefte verbringen Stunden mit Posts, ohne Ergebnis...",
      "slug": "content-produktion-effizient-gestalten-strategien-fuer-fuehrungskraefte",
      "publication_status": "published",
      "created_at": "2026-02-28T10:03:19.931Z",
      "updated_at": "2026-02-28T10:08:20.763Z",
      "channel": {
        "id": 161,
        "title": "Blog",
        "platform": "git",
        "team": {
          "id": 42,
          "name": "Wortfreunde"
        },
        "posts_count": 3
      }
    }
  ],
  "meta": {
    "page": 1,
    "pages": 1,
    "count": 3,
    "per_page": 20
  }
}

Response Fields

Publication Status

Pagination

The meta object contains pagination details:

Get Post

Retrieve a single post with its full content.

GET /channels/{channel_id}/posts/{id}

Path Parameters

Example Request

curl -s https://api.wortfreunde.ch/v1/channels/161/posts/214 \
  -H "Authorization: Bearer $WORTFREUNDE_API_KEY" | python3 -m json.tool

Response

{
  "data": {
    "id": 214,
    "title": "Warum strukturierte Content-Planung mehr bringt als spontane Posts",
    "body": "## Struktur\n\nDas Problem ist nicht fehlende Kreativitaet...",
    "teaser": "Montagmorgen. Der Cursor blinkt. Was soll ich heute posten?...",
    "slug": "strukturierte-content-planung-vs-spontane-posts",
    "publication_status": "published",
    "created_at": "2026-03-02T16:54:36.465Z",
    "updated_at": "2026-03-09T05:00:48.275Z",
    "published_at": "2026-03-09T05:00:48.269Z",
    "channel": {
      "id": 161,
      "title": "Blog",
      "platform": "git",
      "team": {
        "id": 42,
        "name": "Wortfreunde"
      },
      "posts_count": 3
    },
    "tags": [],
    "media": [],
    "meta_title": "Strukturierte Content-Planung vs. spontane Posts",
    "meta_description": "Erfahre, warum strukturierte Content-Planung mehr Sichtbarkeit und Resonanz bringt als spontane Posts."
  }
}

Response Fields

The single post response includes all fields from the list response, plus:

Error Responses

Post Not Found

curl -s https://api.wortfreunde.ch/v1/channels/161/posts/99999 \
  -H "Authorization: Bearer $WORTFREUNDE_API_KEY"

{
  "error": {
    "code": "not_found",
    "message": "Post not found"
  }
}

Publish Post

Confirms publication of a post that is in publishing_pending status. This endpoint is used by external systems to complete the publishing workflow for API platform channels.

PATCH /channels/{channel_id}/posts/{id}/publish

Scope

Requires write:posts.

Path Parameters

Request Body (optional)

{
  "post": {
    "external_id": "ext-12345",
    "external_url": "https://example.com/posts/12345"
  }
}

The post wrapper is optional, if omitted, no external fields are set.

Example Request

curl -s -X PATCH "https://api.wortfreunde.ch/v1/channels/42/posts/214/publish" \
  -H "Authorization: Bearer $WORTFREUNDE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"post": {"external_id": "wp-789", "external_url": "https://blog.example.com/my-post"}}' \
  | python3 -m json.tool

Response

Returns the updated post with publication_status: "published":

{
  "data": {
    "id": 214,
    "title": "My API Platform Post",
    "publication_status": "published",
    "published_at": "2026-03-10T14:30:00.000Z",
    "external_id": "wp-789",
    "external_url": "https://blog.example.com/my-post",
    "channel": {
      "id": 42,
      "title": "External Blog",
      "platform": "api"
    }
  }
}

Error Responses

Unpublish Post

Reverts a published API platform post back to draft status.

PATCH /channels/{channel_id}/posts/{id}/unpublish

Scope

Requires write:posts.

Path Parameters

Example Request

curl -s -X PATCH "https://api.wortfreunde.ch/v1/channels/42/posts/214/unpublish" \
  -H "Authorization: Bearer $WORTFREUNDE_API_KEY" \
  | python3 -m json.tool

Response

Returns the updated post with publication_status: "draft":

{
  "data": {
    "id": 214,
    "title": "My API Platform Post",
    "publication_status": "draft",
    "published_at": null,
    "external_id": null,
    "external_url": null,
    "channel": {
      "id": 42,
      "title": "External Blog",
      "platform": "api"
    }
  }
}

Error Responses

API Platform Publishing Workflow

The API platform provides an async publishing workflow for external systems:

1. Schedule, A post on an API platform channel is scheduled via the content plan
2. Dispatch, At the scheduled time, Wortfreunde sets the post to publishing_pending and fires a post.publishing_pending webhook
3. Publish, The external system receives the webhook, processes the post, and calls PATCH .../publish to confirm
4. Update, If the post content changes after publishing, a post.updated webhook is fired so the external system can re-sync
5. Unpublish, To revert, the external system calls PATCH .../unpublish, which fires a post.unpublished webhook