Delete a post

Delete a post from Postprism.

Last checked against the API October 10, 2026 · View as Markdown

DELETEhttps://studio.postprism.app/api/v1/posts/{id}

Deletes the post from Postprism, so a scheduled post will not publish. It does not remove anything already published on a social network.

Returns 204 No Content with an empty body.

Parameters

Name	In	Type	Description
`id`	path	uuid, required	The post ID.
`workspace_id`	query	uuid	Act on another workspace you belong to. Defaults to the workspace your API key was created in.

Delete a post

curl -X DELETE "https://studio.postprism.app/api/v1/posts/3f1c2a9e-0000-4000-8000-00000000a001" \
  -H "Authorization: Bearer pp_live_your_api_key"

204 No Content, with an empty body.

Status	Message	When
401	`Invalid or revoked API key`	The `Authorization` header is missing, malformed, or the key was revoked.
404	`Workspace not found, or you are not a member of it.`	The `workspace_id` you passed (or your key’s default workspace) is not one you belong to.
429	`Too many requests`	You went over the hourly limit. See Rate limits.
500	`Failed to delete post.`	The post could not be deleted. Try again.