Skip to main content

Cursor

Cursor-based pagination input for list queries.

Use limit to control page size and next/previous cursors to navigate between pages. Cursors are opaque strings returned in the response's cursor field — pass them back exactly as received to fetch the adjacent page.

# First page (20 items by default)
query { instances(organizationId: "my-org") { cursor { next } items { id } } }

# Next page
query { instances(organizationId: "my-org", cursor: { next: "eyJpZCI6..." }) { cursor { next } items { id } } }

# Custom page size
query { instances(organizationId: "my-org", cursor: { limit: 50 }) { cursor { next } items { id } } }
input Cursor {
limit: Int
next: String
previous: String
}

Fields

Cursor.limit ● Int scalar {#limit}

Maximum number of items to return per page. Default: 20. Minimum: 1. Maximum: 100.

Cursor.next ● String scalar {#next}

Forward pagination cursor. Pass the next value from a previous response to fetch the next page. Mutually exclusive with previous.

Cursor.previous ● String scalar {#previous}

Backward pagination cursor. Pass the previous value from a previous response to fetch the preceding page. Mutually exclusive with next.

Member Of

auditLogs query ● bundles query ● deployments query ● environments query ● groups query ● instances query ● integrations query ● ociRepos query ● paramDimensions query ● projects query ● resources query ● resourceTypes query