Read your blocks back
Lists the blocks you pushed into the workspace your key addresses, newest
window last. It is a reconciliation surface: after a timeout or a 500 you can
see whether a push actually landed, rather than guessing.
Two things bound the result and neither is a parameter you send: the blocks are yours, and the workspace is the one your key was issued for. Another partner syncing the same property sees their own blocks and never yours.
Nothing about a guest is here, because nothing about a guest was ever accepted.
Paged with page and page_size; has_more tells you whether to ask for the
next one. There is no total — we do not count the whole set to answer a page.
Live in a sandbox workspace. Returns 501 against a production one, where
nothing has been blocked and so there is nothing to read back.
Authorizations
A short-lived partner token, obtained by exchanging your API key at
POST /token. Send it as Authorization: Bearer <access_token>.
Tokens live for fifteen minutes by default and never for more than an hour. Mint one per batch of work, not one per request.
The token carries the workspace and the environment its key was issued for. You cannot change either by asking: the exchange ignores everything in the request body for exactly that reason.
Never send it as a cookie or in a query string, and never store it — store the API key, mint tokens from it.
Query Parameters
Only blocks holding a night on or after this date. A block whose check_out is
this date holds no night in the window, so it is not returned.
Only blocks holding a night on or before this date.
1-based page number. Defaults to the first page.
x >= 1Rows per page.
1 <= x <= 200