Pixelfed: posting rules and settings

What a Pixelfed channel accepts in Postemi: media, limits, required fields, and the fields of the settings object for the API.

Basics

Rules

• Pixelfed has no platform-specific settings. The __type field is enough in the settings object.
• The limits are Pixelfed defaults (500 caption characters, 4 photos, no video). A server admin can change them.
• You connect with the address of your server and sign in there.
• Beta: not yet tested with many accounts.

Settings fields

Examples

Each example is one item in the POST /public/v1/posts request's posts array. The envelope around it is always this:

{
  "type": "schedule",
  "date": "2026-09-15T09:00:00.000Z",
  "shortLink": false,
  "posts": [ /* the item below */ ]
}

{
  "integration": { "id": "<channel-id>" },
  "value": [{ "content": "<p>The text of the post.</p>", "image": [] }],
  "settings": { "__type": "pixelfed" }
}

The channel ID comes from the channel list, and the path values for images and videos from media upload. The exact schema for the connected account comes from the settings schema endpoint. From the command line, the same thing is the --settings flag. See the CLI examples.