Operations#

Long-running async operations. Every async mutation returns an OperationRef; poll this resource to track progress.

List a database’s async operations#

GET /api/v2/databases/{owner}/{database}/operations

Returns the async operations (imports, merges, SQL writes, forks, …) recorded against the database {owner}/{database}, ordered by the backend. Cursor-paginated via page_token (request) / meta.next_page_token (response); when next_page_token is absent or empty there are no further pages. Public databases are readable without authentication; private databases require a credential with access (and return 404 otherwise, so their existence isn’t leaked). Each entry is the same Operation shape GET /api/v2/operations/{id} returns — data[i].id is what you pass to that endpoint to re-poll a single operation.

Parameters

Example request

curl -X GET 'https://www.dolthub.com/api/v2/databases/{owner}/{database}/operations' \
  -H 'Authorization: Bearer YOUR_TOKEN'

Responses

Get an async operation#

GET /api/v2/operations/{operation_id}

Polls a long-running operation by its id. Every async mutation (SQL write, import, merge, fork) returns an OperationRef in its 202 response; clients poll this endpoint until status is succeeded or failed. The id is the job resource name returned by the backend.

Parameters

Example request

curl -X GET 'https://www.dolthub.com/api/v2/operations/{operation_id}' \
  -H 'Authorization: Bearer YOUR_TOKEN'

Responses