ATatlassian
Database

Get views for database

Changed on

Returns the views defined on a database using cursor-based pagination. Only view IDs, names, and types are returned; view configuration is not exposed.

Consistency: Responses may not immediately reflect recent changes. Clients requiring read-after-write confirmation should poll with bounded backoff.

Experimental: This operation is experimental and may change in backwards-incompatible ways without notice.

Permissions required: Permission to view the database and its corresponding space.

get/databases/{id}/views

Request

  • Base URL
    https://no-default/wiki/api/v2
  • URL
    https://no-default/wiki/api/v2/databases/{id}/views
  • Auth
    • HTTP basic
    • or OAuth 2
      Authorization code: https://auth.atlassian.com/authorize
      Token URL: https://auth.atlassian.com/oauth/token scopes: read:database:confluence

Path parameters

idstring required

The Confluence content ID of the database, represented as an ASCII decimal-digit string.

Query parameters

limitinteger

Maximum number of results to return. The value must be a positive integer without a sign, decimal point, or leading zero. The default is 50 and the maximum is 250.

cursorstring

Opaque, offset-based continuation token obtained from _links.next or the Link response header. A cursor is scoped to the database, collection endpoint, filters, sort, and page size that produced it. Reusing a well-formed cursor with any different query context returns CURSOR_QUERY_MISMATCH; malformed or structurally invalid cursors return INVALID_CURSOR, and a decoded but unsupported version returns UNSUPPORTED_CURSOR_VERSION.

Cursor versions remain decodable for at least 24 hours, but the API does not promise TTL-expiration detection. Cursors are continuation state, not caller-scoped credentials, and authorization is re-evaluated on every request. Their query-context fingerprint is unsigned and must not be treated as authentication or tamper protection.

Pagination is best effort under concurrent mutation. Inserts, deletes, or changes to sort values can cause duplicate or omitted rows; restart from the first page when a consistent export is required.

Headers

If-None-Matchstring

One or more entity tags previously returned for this exact request URL. A matching strong or weak validator returns 304 with no response body.

Response

Returned if the requested database views are returned.

Changes