Bugs we’ve confirmed and are tracking. Each entry lists a workaround if one exists. Once a fix ships, the entry will be removed (or moved into release notes). If you hit something that isn’t here, please report it on Discord or GitHub.Documentation Index
Fetch the complete documentation index at: https://docs.postiz.com/llms.txt
Use this file to discover all available pages before exploring further.
Channel connect
TikTok connect page sometimes crashes
The/integrations/social/tiktok page can fail with cannot read properties of undefined for a subset of accounts.
Workaround: retry; if it persists, open the connect flow in a fresh
incognito window. Once the channel is added the rest of the TikTok UI
works normally.
X (Twitter) connect page sometimes crashes
The X connect screen can throw at/r is not a function error after the
provider redirect.
Workaround: start the connect flow over from the Channels page rather
than refreshing the broken screen.
GMB connect page shows session-recording errors
The Google My Business connect page surfaces session-replay errors that mask the underlying flow. Workaround: ignore the overlay error; the OAuth handshake usually still completes. Refresh the Channels page after authorising on Google’s side.Posting
/launches page null-deref during loading
The launches view can throw null-reference errors while data is still
loading, briefly showing a broken state.
Workaround: refresh the page once data arrives. State usually
settles within a couple of seconds.
Media generation
AI image generation returns 400 “Unknown parameter: ‘response_format’”
/media/generate-image-with-prompt, /posts/generator, and
/media/generate-image can fail against newer OpenAI API versions
because the request uses a parameter that has since changed names.
Workaround: no client-side workaround. A fix is needed in the
Postiz backend. Use externally-generated images and the
/public/v1/upload endpoint in the
meantime.
”Failed to generate video” via Transloadit
Long-running video assemblies can hit Transloadit’s assembly expiry window. Workaround: retry the generation. Shorter prompts and smaller output resolutions assemble faster and are less likely to expire.Public API
DELETE /public/v1/posts/:id 500 on non-existent ID
Deleting a post that’s already been removed currently surfaces a 500
instead of a clean 404.
Workaround: match on the specific error signature for this bug
(a Prisma undefined.integrationId error in the response body) before
treating the 500 as “already deleted.” Other 500 responses from this
endpoint indicate real server errors — log and retry them normally
rather than swallowing every 500.

