Skip to content

Add (or re-pin) an asset in a collection

POST
/collections/{id}/resources

Idempotent on (collection_id, asset_id). Re-adding an existing membership updates sort_order, pinned, and expires_at but keeps added_at fixed.

id
required
string format: uuid
object
asset_id
required
string format: uuid
sort_order
integer
0
pinned
boolean
default: true
expires_at
string format: date-time
nullable

Resource added

Malformed request

object
error
required

Human-readable error summary

string
Example
the request could not be completed

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"
}

Authenticated but missing required capabilities

object
error
required

Human-readable error summary

string
Example
the request could not be completed

Resource not found

object
error
required

Human-readable error summary

string
Example
the request could not be completed