CUcubesoftware
Library

GET /library/owners

Changed on

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.

Request

  • Base URL
    https://api.cubesoftware.com
  • Auth
    OAuth 2
    Authorization code: https://portal.cubesoftware.com/o/authorize/
    Token URL: https://api.cubesoftware.com/o/token/

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' | 'builder' | 'file' | 'reports' | 'template'

Single value: all (default), reports, template, file, or builder. 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"
}

Changes

  • 2ef6e2cdfaefRevision changes
    • info

      added the new enum value builder to the query request parameter type

    • info

      added the new enum value reports to the query request parameter type