Comment on page
Making an API Request
To authenticate with the REST API, provide an
Authorization
header with the token for the user, where “YOURTOKEN” is the token for your Service Accounts: Authorization: Token YOURTOKEN
The PixieBrix API is versioned using the
Accept
header. We follow Semver and will increment the major version on any backward incompatible changes.The latest version of the API is version=2.0:
Accept: "application/json; version=2.0"
The PixieBrix API accepts and responds with JSON. However, certain endpoints can also return other formats (notably, CSV). Refer to the OpenAPI specification for which content types a given endpoint supports
To control the response format, vary the mime type in the
Accept
header:Accept: "application/json; version=2.0"
Accept: "text/csv; version=2.0"
Pagination information is included in responses via the Link header. See https://datatracker.ietf.org/doc/html/rfc8288 for more detailed information.
Most languages have library support for working with Link headers:
You can request a specific page using the page query param. For example:
/api/database/:databaseId/records?page=2
You can control the page size (maximum 1,000) using the
page_size
query parameter. For example:/api/database/:databaseId/records?page_size=150
The API endpoints are throttled on a per-token basis to prevent abuse. If you make too many requests within a given minute, the server will respond with
429 Too many requests
Last modified 28d ago