publications

List or Create Publications

View as Markdown
List publications scoped to the current workspace (unless public/global query params supplied) or create a new publication. Creation now supports optional bulk cocreator assignment via repeated multipart form keys 'emails'. All provided emails must: - Correspond to existing IAMUser accounts - Be members of the publication's workspace with effective role EDITOR or higher - Not already be cocreators and not be the owner Validation is all-or-nothing: if any email fails, none are added and a 400 response with per-email errors is returned. **Search:** - `q` - Full-text search across name and description fields **Ordering Options:** - `ordering=updated_at` or `ordering=-updated_at` - Sort by last update (default: descending) - `ordering=created_at` or `ordering=-created_at` - Sort by creation date - `ordering=name` or `ordering=-name` - Sort alphabetically by name - `ordering=experiences_count` or `ordering=-experiences_count` - Sort by number of experiences - `ordering=subscribers_count` or `ordering=-subscribers_count` - Sort by number of subscribers

Query parameters

created_atdateOptional
descriptionstringOptional
emailsstringOptional

Repeatable form key for cocreator emails (multipart/form-data). Provide multiple ‘emails’ keys, each with a single email value.

logged_inbooleanOptional
namestringOptional
orderingstringOptional

Order results by specified field. Prefix with ’-’ for descending order. Options: updated_at, created_at, name, experiences_count, subscribers_count. Default: -updated_at

ownerstringOptional
pageintegerOptional
A page number within the paginated result set.
page_sizeintegerOptional
Number of results to return per page.
qstringOptional

Full-text search across publication name and description

usernamestringOptional
visibilityenumOptional
* `public` - Public * `private` - Private * `team` - Team * `org` - Organization
Allowed values:

Response

List of publications
countinteger
resultslist of objects
nextstring or nullformat: "uri"
previousstring or nullformat: "uri"

Errors

400
Bad Request Error
401
Unauthorized Error