latestOpenAPI 3.0.32026-08-19299284712.8 KB

67d9f45bb99b

Library

Distinct creators of Library entries visible to the requester. Backs the Library page Owner filter dropdown. Mirrors /library visibility (same ?folder_id= / ?type= scoping, same per-instance permission filter) so creators of rows the requester can't see never appear here. Not paginated -- owner counts are bounded by company size.

get/library/owners

Query parameters

created_by_idinteger

Filter to entries created by the given user id.

folder_idinteger

Folder id to scope the owner set to a specific folder. Omit to return owners of the root listing. Same semantics as /library?folder_id=.

limitinteger

Number of results to return per page.

orderingstring

Comma-separated sort tokens (prefix - for descending). Allowed: ['created_at', 'created_by', 'last_opened_at', 'name', 'sharing_scheme']. Default: -created_at. Folders always pin at the top regardless of ordering.

pageinteger

A page number within the paginated result set.

searchstring

Case-insensitive substring match on name, applied at SQL before pagination.

type'all' | 'file' | 'template'

Single value: all (default), template, or file. Narrows the owner set to creators of items of those kinds. Folders are always considered, matching /library.

Headers

X-Company-IDstring required

Associates request with company

Response

countinteger required
nextstring uri nullable
previousstring uri nullable

Example response

{
  "count": 123,
  "next": "http://api.example.org/accounts/?page=4",
  "previous": "http://api.example.org/accounts/?page=2"
}