Sign in
Outline collections

Register an Outline collection for mirroring (lands ENABLED + PENDING; idempotent on the id)

post/workspaces/{workspaceSlug}/outline/collections

Request

  • Base URL: / (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /workspaces/{workspaceSlug}/outline/collections
  • Auth: HTTP bearer

Path parameters

workspaceSlugstring required

Workspace slug

Request body

collectionIdstring required

Outline collection id (UUID)

Response

Collection was already registered (idempotent repeat)

collectionIdstring required

Outline collection id (UUID; the natural key)

colorstring

Collection color as configured in Outline

createdAtstring date-time required

When the collection was registered for mirroring

descriptionstring

Collection description as shown in Outline

documentCountinteger required

Live (non-tombstoned) mirrored document count

documentsUpstreaminteger

Documents upstream reported for this collection at the last enumeration (coverage denominator)

exportsSkippedForBudgetinteger

Exports the last pass skipped because the shared budget ran out (0 on a clean pass)

iconstring

Collection icon as configured in Outline

idinteger required

Internal registry row id

lastSyncErrorstring

Last sync failure for this collection, cleared on the next clean pass

lastSyncedAtstring date-time

When this collection last completed a full reconcile pass, if any

namestring

Collection name as shown in Outline, if known

state'ENABLED' | 'PAUSED' required

Mirror lifecycle state (PAUSED freezes sync but keeps documents)

syncStatus'PENDING' | 'COMPLETE' required

Whether a clean full pass has completed since registration or the last resume

urlIdstring

Outline url id (the short slug in collection URLs)

Changes

No recorded changes to this operation across all 1 revision of this API.