Delete Blog Post

DELETE

/api/v1/posts/{id}

Authorizations

SessionAuth

Session ID for authenticated requests

Type

API Key (header: X-Session-ID)

Parameters

Path Parameters

id*

Type

string

Required

Responses

Post deleted

DELETE

/api/v1/posts/{id}

Playground

Server

Authorization

SessionAuth

Variables

Key

Value

id*

Samples

Powered by VitePress OpenAPI

Delete a blog post.

Auth: session + owner/admin.

Parameters

Name	In	Type	Required	Description
id	path	string	Yes	Post id

Request Body

None.

Response 200

{
	"data": { "id": "post_2", "deleted": true },
	"user_context": { "authenticated": true },
	"meta": {}
}

Response Errors

• 401 missing session
• 403 not owner/admin
• 404 post not found

Notes

• Use this for permanent removal or admin cleanup.
• If soft delete is enabled, the underlying system may preserve the record.