Fetch a single collection by id

GET

/collections/{id}

• Local development behind nginx (port 8088 by default)

Parameters

Path Parameters

id

required

string format: uuid

Responses

200

The collection

A user-owned collection of assets, per ADR 0009. UUID-keyed, federation-prepared (origin_server_id), with three orthogonal axes: visibility, membership, and lifecycle.

object

id

required

string format: uuid

owner_user_ref

required

integer format: int64

name

required

string

description

required

string

visibility

required

string

Allowed values: private org-only followers explicit-share

membership

required

manual only for 1.11.A. query and hybrid ship in 1.11.B once the search DSL (ADR 0010) lands.

string

Allowed values: manual query hybrid

expires_at

TTL. Null = permanent.

string format: date-time

nullable

purpose

Free-form admin-set hint (“for_review”, “for_proofing”, …). Replaces RS’s single-purpose archived flag.

string

nullable

origin_server_id

Federation home server. Null = local. Populated when collections sync in from a peer in a later phase.

string format: uuid

nullable

created_at

required

string format: date-time

updated_at

required

string format: date-time

deleted_at

Soft-delete timestamp. Non-null only on rows surfaced by the admin include_deleted=true listing (the trash view); null on live rows.

string format: date-time

nullable

deleted_reason

Optional reason captured at soft-delete time.

string

nullable

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