View file execution records¶

Lists workflow execution records triggered by files, used to locate associated workflows and jobs.

HTTP
GET $CLOUDSIGMA_API_BASE/workflow/v2/workflow-apps/file-executions

Before you call this API¶

Configure the regional API endpoint and authentication, and select the target workspace.

Request¶

Input examples

Shell
curl -X GET "$CLOUDSIGMA_API_BASE/workflow/v2/workflow-apps/file-executions?offset=$OFFSET" \
  -H "X-API-Key: $CLOUDSIGMA_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID"

Parameter reference

Query parameters

Field	Type	Description
`offset`	integer	Returns the starting position of the list.
`limit`	integer	Return the quantity.

Successful response¶

When the request is successful, the data of this operation is returned. Just because the write or run request has been accepted does not mean that the subsequent processing has been completed; please confirm the result based on the return status or subsequent query.

Response example

JSON
{
  "code": "OK",
  "msg": "OK",
  "data": {
    "executions": [],
    "total": 0
  }
}

Field reference

Field	Type	Description
`data.executions`	array	File execution record.
`data.total`	integer	The total number of matching records.

Error response¶

Response example

JSON
{
  "code": "ErrParamInvalid",
  "msg": "请求参数无效",
  "data": null
}

Field reference

Field	Type	Description
`code`	string	Error code.
`msg`	string	Readable error message.
`data`	null	`null` in an error response.

Follow-up operations¶

Use the workflow and execution identifier in the record query workflow job details.

Last updated on Sep 15, 2026