Sign in

ec90bd653983

latestOpenAPI 3.1.02026-08-1084330443.7 KB
Operations
MCP

Get Operation Status

Authorization scope: operations:list

For a given asynchronous operation ID, the endpoint returns its status.

📖 Instructions for usage

activate_data_flow, get_operation

activate_data_flow

Activate (schedule) a data flow so it runs on its configured schedule.

Set wait=True to block until activation completes or fails — eliminates
the need to manually call get_operation in a loop.
Returns the final operation status when wait=True.

get_operation

Get an activation/validation operation by its operation_id (24-char hex).

This is for activate_river / validate operations only.
For data run status, use get_run instead.
get/v1/accounts/{account_id}/environments/{environment_id}/operations/{operation_id}

Path parameters

operation_idstring required
account_idstring required
environment_idstring required

Response

Successful Response

operation_idstring required

The ID of the operation

operation_typestring required

The type of the operation

run_idstring required

The run id of the operation

last_update_datestring date-time required

The date time in UTC timezone of the last update

status'W' | 'E' | 'R' | 'D' required

The status of the pull request that we use in the back, and expose in the API

resultstring nullable

The result of the operation

error_messagestring nullable

The error message of the operation

Example response

{
  "operation_id": "62e7f4352c13160013dc39be",
  "operation_type": "dataframe",
  "run_id": "5cbc6bbbc90a4658b00c70a3bb0f3b31",
  "last_update_date": "2022-08-02T13:38:44.054000",
  "result": "true",
  "error_message": "[RVR-QBK-003]: Response value error: Missing Rows/Columns"
}