> ## 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.

# Known Issues

> Live tracker of bugs we are aware of, with workarounds where possible

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](https://discord.postiz.com) or [GitHub](https://github.com/gitroomhq/postiz-app/issues).

## 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 a `t/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`](/public-api/uploads/upload-file) 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.

### `PUT /public/v1/posts/:id/release-id` validation 500

Sending malformed input to the release-id endpoint surfaces a Prisma
validation error as 500.

**Workaround:** validate input shape client-side before sending.

## Uploads

### Cannot cancel an in-flight upload

The uploader does not support mid-flight cancellation.

**Workaround:** wait for the upload to finish, then delete the asset
from the post.