Remove a post from a collection

DELETE

/collections/{id}/posts/{post_id}

• Local development behind nginx (port 8088 by default)

Un-pins the reference. It does NOT delete the post, and it does not touch any other collection that references the same post — removing from your collection is yours alone (#882).

Not gated on readability, deliberately, for the same reason the asset route is not: a post whose visibility was narrowed after it was pinned would otherwise be permanently stranded in a collection its curator can no longer remove it from.

Authorizations

• cookieAuth
• bearerAuth

Parameters

Path Parameters

id

required

string format: uuid

post_id

required

string format: uuid

Responses

204

Removed (or was already absent)

401

Authentication required, missing, or invalid

object

error

required

Human-readable error summary

string

Example

the request could not be completed

Example

{
  "error": "authentication required: sign in and retry with a valid session or API token"
}

404

Resource not found

object

error

required

Human-readable error summary

string

Example

the request could not be completed