Operations

List operations (headers only)

The GET of this path with no response body. It is authorized exactly as the GET is and answers its statuses and headers, never a body: an error’s correlation is in X-Request-ID alone. Range is ignored. It runs the GET’s own read and discards the body, so it touches whatever that read touches, the guest included: it is not a lighter way to poll.

Requires the viewer role or higher.

head/operations

Request

  • Base URL: https://app.mandala.computer/api/v1
  • URL: https://app.mandala.computer/api/v1/operations
  • Auth: HTTP bearer

Query parameters

computer_idstring

Only this computer’s operations. For a clone, that is the new computer. A value no computer id could be is a 400.

idempotency_keystring

Only the operation the call sent with this Idempotency-Key recorded, within the key’s 24 hours. Keys are kept per scope, so this finds the operation that a credential of your own scope reserved with the key. An operation recorded under the same key by a credential of another scope (another workspace’s, or a workspace’s when you ask with an account-wide key) is not found by it, even when the unfiltered listing shows it. A value no key could be is a 400.

limitinteger

How many to answer.

cursorstring

The next_cursor of the page before. A cursor this credential cannot read — another scope’s, one whose operation has expired, or one never given out — is a 400. An unknown parameter, or one given twice, is a 400.

Response

A page of operations, newest first.

Changes

No recorded changes to this operation across all 1 revision of this API.