> For the complete documentation index, see [llms.txt](https://developers.make.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.make.com/api-documentation/api-reference/scenarios/logs.md).
# Logs
The following endpoints allow you to manage scenarios logs.
## List scenario logs
> Retrieves a collection of all logs for a scenario with a given ID. Returned logs are sorted by \`imtId\` in descending order. Logs with type \`modify\` can include versioned Scenario History changes in \`detail.change\`.
```json
{"openapi":"3.0.0","info":{"title":"Web API v2 - Public ","version":"1.0.0"},"tags":[{"name":"Scenarios / Logs","description":"The following endpoints allow you to manage scenarios logs."}],"servers":[{"url":"https://eu1.make.com/api/v2","description":"EU1 production zone"},{"url":"https://eu2.make.com/api/v2","description":"EU2 production zone"},{"url":"https://us1.make.com/api/v2","description":"US1 production zone"},{"url":"https://us2.make.com/api/v2","description":"US2 production zone"},{"url":"https://eu1.make.celonis.com/api/v2","description":"Celonis EU1 production zone"},{"url":"https://us1.make.celonis.com/api/v2","description":"Celonis US1 production zone"}],"security":[{"token":["scenarios:read"]}],"components":{"securitySchemes":{"token":{"type":"apiKey","name":"Authorization","in":"header","description":"Authorize the API call with your API token in the `Authorization` header with the value: `Token your-api-token`.\n\nIf you don't have an API token yet, please refer to the [\"Authentication\" section](/api-documentation/authentication) to learn how to create one.\n"}}},"paths":{"/scenarios/{scenarioId}/logs":{"get":{"tags":["Scenarios / Logs"],"summary":"List scenario logs","description":"Retrieves a collection of all logs for a scenario with a given ID. Returned logs are sorted by `imtId` in descending order. Logs with type `modify` can include versioned Scenario History changes in `detail.change`.","parameters":[{"description":"The ID of the scenario. You can get the `scenarioId` with the [List scenarios](/api-reference/scenarios/get--scenarios.md) API call.","name":"scenarioId","in":"path","schema":{"type":"integer"},"required":true},{"name":"from","in":"query","schema":{"type":"integer"},"description":"The timestamp in milliseconds that defines the starting point of time from which the logs should be retrieved. Older logs will not be returned."},{"name":"to","in":"query","schema":{"type":"integer"},"description":"The timestamp in milliseconds that defines the ending point of time to which the logs should be retrieved. Newer logs will not be returned."},{"name":"status","in":"query","schema":{"type":"integer","enum":[1,2,3]},"description":"Filters logs by numeric terminal execution status. `1` is for success, `2` is for warning, and `3` is for error. Do not use this parameter with `displayStatus`."},{"name":"displayStatus","in":"query","schema":{"type":"string","enum":["RUNNING","WAITING","SUCCESS","WARNING","ERROR"]},"description":"Filters execution logs by derived display status. `WAITING` is a timed, parked execution. Do not use this parameter with `status`."},{"name":"durationFrom","in":"query","schema":{"type":"integer"},"description":"Filters logs to only include executions with a duration greater than or equal to this value (in milliseconds)."},{"name":"durationTo","in":"query","schema":{"type":"integer"},"description":"Filters logs to only include executions with a duration less than or equal to this value (in milliseconds)."},{"name":"operationsFrom","in":"query","schema":{"type":"integer"},"description":"Filters logs to only include executions with an operations count greater than or equal to this value."},{"name":"operationsTo","in":"query","schema":{"type":"integer"},"description":"Filters logs to only include executions with an operations count less than or equal to this value."},{"name":"transferFrom","in":"query","schema":{"type":"integer"},"description":"Filters logs to only include executions with a data transfer greater than or equal to this value (in bytes)."},{"name":"transferTo","in":"query","schema":{"type":"integer"},"description":"Filters logs to only include executions with a data transfer less than or equal to this value (in bytes)."},{"name":"executionName","in":"query","schema":{"type":"string"},"description":"Filters logs by the execution name (partial match)."},{"name":"creditsFrom","in":"query","schema":{"type":"integer"},"description":"Filters logs to only include executions with credits greater than or equal to this value (in centicredits)."},{"name":"creditsTo","in":"query","schema":{"type":"integer"},"description":"Filters logs to only include executions with credits less than or equal to this value (in centicredits)."},{"name":"showCheckRuns","in":"query","schema":{"type":"boolean"},"description":"If set to `true`, check runs are included in the returned results. By default they are excluded. Check runs concern scenarios starting with a trigger in cases when the trigger does not find anything new."},{"name":"pg[offset]","in":"query","schema":{"type":"integer"},"description":"The number of entities you want to skip before getting entities you want."},{"name":"pg[limit]","in":"query","schema":{"type":"integer"},"description":"The maximum number of entities you want to get in the response."},{"name":"pg[showLast]","in":"query","schema":{"type":"boolean"},"description":"Include records with `last` value in the result set. Just in case of the `last` based paging."},{"name":"pg[last]","in":"query","schema":{"type":"integer"},"description":"The last retrieved key. In response, you get only entries that follow after the key."},{"name":"pg[sortBy]","in":"query","schema":{"type":"string"},"description":"The value that will be used to sort returned entities by."},{"name":"pg[sortDir]","in":"query","schema":{"type":"string","enum":["asc","desc"]},"description":"The sorting order. It accepts the ascending and descending direction specifiers."}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"scenarioLogs":{"type":"array","items":{"allOf":[{"type":"object","properties":{"imtId":{"type":"string"},"duration":{"type":"integer"},"operations":{"type":"integer"},"transfer":{"type":"integer"},"centicredits":{"type":"integer"},"organizationId":{"type":"integer"},"teamId":{"type":"integer"},"id":{"type":"string"},"type":{"type":"string"},"authorId":{"type":"integer","nullable":true},"authorName":{"type":"string","nullable":true,"description":"Name of the user who triggered the scenario run. Null when authorId is missing or unknown."},"instant":{"type":"boolean"},"timestamp":{"type":"string","format":"date-time"},"status":{"type":"integer","description":"Numeric terminal execution status. `1` is success, `2` is warning, and `3` is error. It is absent for active executions."},"eventType":{"type":"string","description":"Execution lifecycle marker on execution rows. `EXECUTION_PAUSED` means the execution is parked (interrupted) and waiting to resume; a parked row deliberately carries no `status`."},"resumeAt":{"type":"string","format":"date-time","description":"Only on a parked (`eventType: EXECUTION_PAUSED`) row whose wait is time-based: the ISO-8601 timestamp the execution is scheduled to resume. Absent for waits on an external signal (e.g. human-in-the-loop)."},"interruptReason":{"type":"string","enum":["sleep","hitl"],"description":"Only on a parked row: why the execution parked. `sleep` = a timed wait (has `resumeAt`); `hitl` = waiting for human input (no `resumeAt`)."},"interruptModuleId":{"type":"integer","description":"Only on a parked row: id of the module that parked the execution."},"interruptModuleName":{"type":"string","nullable":true,"description":"Only on a parked row: custom name of the module that parked the execution, resolved from the scenario blueprint. `null` when the module has not been renamed."},"provenance":{"description":"Only on execution rows of runs and replays requested through the API, an OAuth app or an MCP client: how the run was requested. Absent on other runs and on runs started before it was recorded.","allOf":[{"type":"object","description":"How a scenario change or run was requested: in the app, with an API token, through an OAuth app, by an MCP client, or by another Make service.","required":["v","channel","auth"],"properties":{"v":{"type":"integer","enum":[1]},"channel":{"type":"string","description":"How the request reached Make: `ui`, `api_token`, `oauth_app`, `mcp`, `service`, `external` or `unknown`. New values may be added."},"auth":{"type":"string","description":"How the request authenticated. New values may be added."},"services":{"type":"array","description":"Make services the request passed through, the original caller first.","items":{"type":"string"}},"tokenLabel":{"type":"string","description":"Label of the API token used."},"oauthClientId":{"type":"string","description":"Client ID of the OAuth app used."},"mcp":{"type":"object","description":"Details of an MCP tool call.","properties":{"authMethod":{"type":"string"},"client":{"type":"string","description":"MCP client, for example `claude`, `cursor` or `openai-mcp`; the client's User-Agent when not recognized."},"conversationId":{"type":"string"},"entrypoint":{"type":"string"},"tool":{"type":"string"},"requestId":{"oneOf":[{"type":"string"},{"type":"number"}]}}},"impersonated":{"type":"boolean","enum":[true],"description":"Present when a Make admin made the change while logged in as the user."},"requestId":{"type":"string","description":"ID of the HTTP request that made the change."}}}]},"detail":{"type":"object","description":"Event-specific details. Modify events can include a versioned Scenario History change.","properties":{"author":{"type":"object","properties":{"name":{"type":"string"},"staff":{"type":"boolean"}}},"change":{"anyOf":[{"type":"object","required":["version","kind","origin","label"],"properties":{"version":{"type":"integer","enum":[1]},"kind":{"type":"string","enum":["label-assigned","label-unassigned"]},"origin":{"type":"string","enum":["direct","cascade"]},"label":{"type":"object","required":["id","name"],"properties":{"id":{"type":"integer"},"name":{"type":"string"}}}}},{"type":"object","required":["version","kind","origin","fromFolder","toFolder"],"properties":{"version":{"type":"integer","enum":[1]},"kind":{"type":"string","enum":["folder-moved"]},"origin":{"type":"string","enum":["direct","cascade"]},"fromFolder":{"type":"object","nullable":true,"required":["id","name","path"],"properties":{"id":{"type":"integer"},"name":{"type":"string"},"path":{"type":"string"}}},"toFolder":{"type":"object","nullable":true,"required":["id","name","path"],"properties":{"id":{"type":"integer"},"name":{"type":"string"},"path":{"type":"string"}}}}},{"type":"object","description":"A versioned Scenario History change not yet interpreted by this API specification.","additionalProperties":true}]},"provenance":{"description":"How the change was made. Absent on rows written before it was recorded and on system actions (for example plan downgrades).","allOf":[{"type":"object","description":"How a scenario change or run was requested: in the app, with an API token, through an OAuth app, by an MCP client, or by another Make service.","required":["v","channel","auth"],"properties":{"v":{"type":"integer","enum":[1]},"channel":{"type":"string","description":"How the request reached Make: `ui`, `api_token`, `oauth_app`, `mcp`, `service`, `external` or `unknown`. New values may be added."},"auth":{"type":"string","description":"How the request authenticated. New values may be added."},"services":{"type":"array","description":"Make services the request passed through, the original caller first.","items":{"type":"string"}},"tokenLabel":{"type":"string","description":"Label of the API token used."},"oauthClientId":{"type":"string","description":"Client ID of the OAuth app used."},"mcp":{"type":"object","description":"Details of an MCP tool call.","properties":{"authMethod":{"type":"string"},"client":{"type":"string","description":"MCP client, for example `claude`, `cursor` or `openai-mcp`; the client's User-Agent when not recognized."},"conversationId":{"type":"string"},"entrypoint":{"type":"string"},"tool":{"type":"string"},"requestId":{"oneOf":[{"type":"string"},{"type":"number"}]}}},"impersonated":{"type":"boolean","enum":[true],"description":"Present when a Make admin made the change while logged in as the user."},"requestId":{"type":"string","description":"ID of the HTTP request that made the change."}}}]}}}}},{"type":"object","properties":{"displayStatus":{"allOf":[{"type":"string","enum":["RUNNING","WAITING","SUCCESS","WARNING","ERROR"],"description":"Canonical status derived from the execution document. `WAITING` identifies a timed, parked execution."}],"description":"This field is absent for non-execution history rows."}}}]}},"pg":{"type":"object","properties":{"last":{"type":"string","description":"Shown only when using the `last` based pagination."},"showLast":{"type":"boolean","description":"Shown only when using the `last` based pagination."},"sortBy":{"type":"string"},"sortDir":{"type":"string"},"limit":{"type":"integer"},"offset":{"type":"integer","description":"Shown only when using the `offset` based pagination."}}}}}}}}}}}}}
```
## Get execution log
> Retrieves an execution log with a given ID for a scenario with a given ID. It returns the execution details such as execution duration, type, and status.
```json
{"openapi":"3.0.0","info":{"title":"Web API v2 - Public ","version":"1.0.0"},"tags":[{"name":"Scenarios / Logs","description":"The following endpoints allow you to manage scenarios logs."}],"servers":[{"url":"https://eu1.make.com/api/v2","description":"EU1 production zone"},{"url":"https://eu2.make.com/api/v2","description":"EU2 production zone"},{"url":"https://us1.make.com/api/v2","description":"US1 production zone"},{"url":"https://us2.make.com/api/v2","description":"US2 production zone"},{"url":"https://eu1.make.celonis.com/api/v2","description":"Celonis EU1 production zone"},{"url":"https://us1.make.celonis.com/api/v2","description":"Celonis US1 production zone"}],"security":[{"token":["scenarios:read"]}],"components":{"securitySchemes":{"token":{"type":"apiKey","name":"Authorization","in":"header","description":"Authorize the API call with your API token in the `Authorization` header with the value: `Token your-api-token`.\n\nIf you don't have an API token yet, please refer to the [\"Authentication\" section](/api-documentation/authentication) to learn how to create one.\n"}}},"paths":{"/scenarios/{scenarioId}/logs/{executionId}":{"get":{"tags":["Scenarios / Logs"],"summary":"Get execution log","description":"Retrieves an execution log with a given ID for a scenario with a given ID. It returns the execution details such as execution duration, type, and status.","parameters":[{"description":"The ID of the scenario. You can get the `scenarioId` with the [List scenarios](/api-reference/scenarios/get--scenarios.md) API call.","name":"scenarioId","in":"path","schema":{"type":"integer"},"required":true},{"description":"The unique ID of the scenario execution. It can be retrieved from the [List scenario logs](/api-reference/scenarios/logs/get--scenarios--scenarioid--logs.md) endpoint under the ID key.","name":"executionId","in":"path","schema":{"type":"string"},"required":true}],"responses":{"200":{"description":"Execution log retrieved","content":{"application/json":{"schema":{"type":"object","properties":{"scenarioLog":{"allOf":[{"type":"object","properties":{"imtId":{"type":"string"},"duration":{"type":"integer"},"operations":{"type":"integer"},"transfer":{"type":"integer"},"centicredits":{"type":"integer"},"organizationId":{"type":"integer"},"teamId":{"type":"integer"},"id":{"type":"string"},"type":{"type":"string"},"authorId":{"type":"integer","nullable":true},"authorName":{"type":"string","nullable":true,"description":"Name of the user who triggered the scenario run. Null when authorId is missing or unknown."},"instant":{"type":"boolean"},"timestamp":{"type":"string","format":"date-time"},"status":{"type":"integer","description":"Numeric terminal execution status. `1` is success, `2` is warning, and `3` is error. It is absent for active executions."},"eventType":{"type":"string","description":"Execution lifecycle marker on execution rows. `EXECUTION_PAUSED` means the execution is parked (interrupted) and waiting to resume; a parked row deliberately carries no `status`."},"resumeAt":{"type":"string","format":"date-time","description":"Only on a parked (`eventType: EXECUTION_PAUSED`) row whose wait is time-based: the ISO-8601 timestamp the execution is scheduled to resume. Absent for waits on an external signal (e.g. human-in-the-loop)."},"interruptReason":{"type":"string","enum":["sleep","hitl"],"description":"Only on a parked row: why the execution parked. `sleep` = a timed wait (has `resumeAt`); `hitl` = waiting for human input (no `resumeAt`)."},"interruptModuleId":{"type":"integer","description":"Only on a parked row: id of the module that parked the execution."},"interruptModuleName":{"type":"string","nullable":true,"description":"Only on a parked row: custom name of the module that parked the execution, resolved from the scenario blueprint. `null` when the module has not been renamed."},"provenance":{"description":"Only on execution rows of runs and replays requested through the API, an OAuth app or an MCP client: how the run was requested. Absent on other runs and on runs started before it was recorded.","allOf":[{"type":"object","description":"How a scenario change or run was requested: in the app, with an API token, through an OAuth app, by an MCP client, or by another Make service.","required":["v","channel","auth"],"properties":{"v":{"type":"integer","enum":[1]},"channel":{"type":"string","description":"How the request reached Make: `ui`, `api_token`, `oauth_app`, `mcp`, `service`, `external` or `unknown`. New values may be added."},"auth":{"type":"string","description":"How the request authenticated. New values may be added."},"services":{"type":"array","description":"Make services the request passed through, the original caller first.","items":{"type":"string"}},"tokenLabel":{"type":"string","description":"Label of the API token used."},"oauthClientId":{"type":"string","description":"Client ID of the OAuth app used."},"mcp":{"type":"object","description":"Details of an MCP tool call.","properties":{"authMethod":{"type":"string"},"client":{"type":"string","description":"MCP client, for example `claude`, `cursor` or `openai-mcp`; the client's User-Agent when not recognized."},"conversationId":{"type":"string"},"entrypoint":{"type":"string"},"tool":{"type":"string"},"requestId":{"oneOf":[{"type":"string"},{"type":"number"}]}}},"impersonated":{"type":"boolean","enum":[true],"description":"Present when a Make admin made the change while logged in as the user."},"requestId":{"type":"string","description":"ID of the HTTP request that made the change."}}}]},"detail":{"type":"object","description":"Event-specific details. Modify events can include a versioned Scenario History change.","properties":{"author":{"type":"object","properties":{"name":{"type":"string"},"staff":{"type":"boolean"}}},"change":{"anyOf":[{"type":"object","required":["version","kind","origin","label"],"properties":{"version":{"type":"integer","enum":[1]},"kind":{"type":"string","enum":["label-assigned","label-unassigned"]},"origin":{"type":"string","enum":["direct","cascade"]},"label":{"type":"object","required":["id","name"],"properties":{"id":{"type":"integer"},"name":{"type":"string"}}}}},{"type":"object","required":["version","kind","origin","fromFolder","toFolder"],"properties":{"version":{"type":"integer","enum":[1]},"kind":{"type":"string","enum":["folder-moved"]},"origin":{"type":"string","enum":["direct","cascade"]},"fromFolder":{"type":"object","nullable":true,"required":["id","name","path"],"properties":{"id":{"type":"integer"},"name":{"type":"string"},"path":{"type":"string"}}},"toFolder":{"type":"object","nullable":true,"required":["id","name","path"],"properties":{"id":{"type":"integer"},"name":{"type":"string"},"path":{"type":"string"}}}}},{"type":"object","description":"A versioned Scenario History change not yet interpreted by this API specification.","additionalProperties":true}]},"provenance":{"description":"How the change was made. Absent on rows written before it was recorded and on system actions (for example plan downgrades).","allOf":[{"type":"object","description":"How a scenario change or run was requested: in the app, with an API token, through an OAuth app, by an MCP client, or by another Make service.","required":["v","channel","auth"],"properties":{"v":{"type":"integer","enum":[1]},"channel":{"type":"string","description":"How the request reached Make: `ui`, `api_token`, `oauth_app`, `mcp`, `service`, `external` or `unknown`. New values may be added."},"auth":{"type":"string","description":"How the request authenticated. New values may be added."},"services":{"type":"array","description":"Make services the request passed through, the original caller first.","items":{"type":"string"}},"tokenLabel":{"type":"string","description":"Label of the API token used."},"oauthClientId":{"type":"string","description":"Client ID of the OAuth app used."},"mcp":{"type":"object","description":"Details of an MCP tool call.","properties":{"authMethod":{"type":"string"},"client":{"type":"string","description":"MCP client, for example `claude`, `cursor` or `openai-mcp`; the client's User-Agent when not recognized."},"conversationId":{"type":"string"},"entrypoint":{"type":"string"},"tool":{"type":"string"},"requestId":{"oneOf":[{"type":"string"},{"type":"number"}]}}},"impersonated":{"type":"boolean","enum":[true],"description":"Present when a Make admin made the change while logged in as the user."},"requestId":{"type":"string","description":"ID of the HTTP request that made the change."}}}]}}}}},{"type":"object","required":["displayStatus"],"properties":{"displayStatus":{"type":"string","enum":["RUNNING","WAITING","SUCCESS","WARNING","ERROR"],"description":"Canonical status derived from the execution document. `WAITING` identifies a timed, parked execution."}}}]}}}}}}}}}}}
```
## Get scenario execution details
> Retrieves details about an execution.
```json
{"openapi":"3.0.0","info":{"title":"Web API v2 - Public ","version":"1.0.0"},"tags":[{"name":"Scenarios / Logs","description":"The following endpoints allow you to manage scenarios logs."}],"servers":[{"url":"https://eu1.make.com/api/v2","description":"EU1 production zone"},{"url":"https://eu2.make.com/api/v2","description":"EU2 production zone"},{"url":"https://us1.make.com/api/v2","description":"US1 production zone"},{"url":"https://us2.make.com/api/v2","description":"US2 production zone"},{"url":"https://eu1.make.celonis.com/api/v2","description":"Celonis EU1 production zone"},{"url":"https://us1.make.celonis.com/api/v2","description":"Celonis US1 production zone"}],"security":[{"token":["scenarios:read"]}],"components":{"securitySchemes":{"token":{"type":"apiKey","name":"Authorization","in":"header","description":"Authorize the API call with your API token in the `Authorization` header with the value: `Token your-api-token`.\n\nIf you don't have an API token yet, please refer to the [\"Authentication\" section](/api-documentation/authentication) to learn how to create one.\n"}}},"paths":{"/scenarios/{scenarioId}/executions/{executionId}":{"get":{"tags":["Scenarios / Logs"],"summary":"Get scenario execution details","description":"Retrieves details about an execution.","parameters":[{"description":"The ID of the scenario. You can get the `scenarioId` with the [List scenarios](/api-reference/scenarios/get--scenarios.md) API call.","name":"scenarioId","in":"path","schema":{"type":"integer"},"required":true},{"description":"The unique ID of the scenario execution. It can be retrieved from the [List scenario logs](/api-reference/scenarios/logs/get--scenarios--scenarioid--logs.md) endpoint under the ID key.","name":"executionId","in":"path","schema":{"type":"string"},"required":true}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","required":["status"],"properties":{"status":{"type":"string","enum":["RUNNING","SUCCESS","WARNING","ERROR","PAUSED"],"description":"Status of the scenario execution:\n\n- RUNNING\n - SUCCESS\n - WARNING\n - ERROR\n - PAUSED — the execution is parked (interrupted) and waiting to resume "},"resumeAt":{"type":"string","format":"date-time","description":"Only present when `status` is `PAUSED` and the wait is time-based: the ISO-8601 timestamp the execution is scheduled to resume. Absent for waits on an external signal (e.g. human-in-the-loop)."},"interruptReason":{"type":"string","enum":["sleep","hitl"],"description":"Only present when `status` is `PAUSED`: why the execution parked. `sleep` = a timed wait (has `resumeAt`); `hitl` = waiting for human input (no `resumeAt`)."},"interruptModuleId":{"type":"integer","description":"Only present when `status` is `PAUSED`: id of the module that parked the execution."},"outputs":{"type":"object","additionalProperties":true,"description":"Outputs of the scenario execution. The structure of the outputs depends on the scenario configuration."},"error":{"type":"object","properties":{"name":{"type":"string","description":"Name of the error."},"message":{"type":"string","description":"Description of the error."},"causeModule":{"type":"object","properties":{"name":{"type":"string","description":"Name of the module that caused the error."},"appName":{"type":"string","description":"Name of the app that caused the error."}}}}}}}}}}}}}}}
```
## Stop scenario execution
> Stops a running execution. Use \`force: true\` to immediately terminate the execution without waiting for the current module to finish.
```json
{"openapi":"3.0.0","info":{"title":"Web API v2 - Public ","version":"1.0.0"},"tags":[{"name":"Scenarios / Logs","description":"The following endpoints allow you to manage scenarios logs."}],"servers":[{"url":"https://eu1.make.com/api/v2","description":"EU1 production zone"},{"url":"https://eu2.make.com/api/v2","description":"EU2 production zone"},{"url":"https://us1.make.com/api/v2","description":"US1 production zone"},{"url":"https://us2.make.com/api/v2","description":"US2 production zone"},{"url":"https://eu1.make.celonis.com/api/v2","description":"Celonis EU1 production zone"},{"url":"https://us1.make.celonis.com/api/v2","description":"Celonis US1 production zone"}],"security":[{"token":["scenarios:run"]}],"components":{"securitySchemes":{"token":{"type":"apiKey","name":"Authorization","in":"header","description":"Authorize the API call with your API token in the `Authorization` header with the value: `Token your-api-token`.\n\nIf you don't have an API token yet, please refer to the [\"Authentication\" section](/api-documentation/authentication) to learn how to create one.\n"}}},"paths":{"/scenarios/{scenarioId}/executions/{executionId}/stop":{"post":{"tags":["Scenarios / Logs"],"summary":"Stop scenario execution","description":"Stops a running execution. Use `force: true` to immediately terminate the execution without waiting for the current module to finish.","parameters":[{"description":"The ID of the scenario. You can get the `scenarioId` with the [List scenarios](/api-reference/scenarios/get--scenarios.md) API call.","name":"scenarioId","in":"path","schema":{"type":"integer"},"required":true},{"description":"The unique ID of the scenario execution. It can be retrieved from the [List scenario logs](/api-reference/scenarios/logs/get--scenarios--scenarioid--logs.md) endpoint under the ID key.","name":"executionId","in":"path","schema":{"type":"string"},"required":true}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"force":{"type":"boolean","description":"If set to `true`, the execution is terminated immediately. If set to `false` or omitted, the execution stops after the current module finishes.","default":false}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"}}}}}}}}}
```
## Replay a scenario execution
> Replays one execution of the scenario. The replay creates a new execution that runs the latest version of the scenario with the data of the original execution. The scenario has to be active, and only executions marked as replayable can be replayed.\
> \
> To replay several executions (up to 100) in one call, use \`POST /scenarios/{scenarioId}/replay\`.\
> \
> The scenario is not replayed when its organization or team is paused because an operations or data transfer limit was exceeded. In that case the call returns \`429\` with the code \`IM310\`.
```json
{"openapi":"3.0.0","info":{"title":"Web API v2 - Public ","version":"1.0.0"},"tags":[{"name":"Scenarios / Logs","description":"The following endpoints allow you to manage scenarios logs."}],"servers":[{"url":"https://eu1.make.com/api/v2","description":"EU1 production zone"},{"url":"https://eu2.make.com/api/v2","description":"EU2 production zone"},{"url":"https://us1.make.com/api/v2","description":"US1 production zone"},{"url":"https://us2.make.com/api/v2","description":"US2 production zone"},{"url":"https://eu1.make.celonis.com/api/v2","description":"Celonis EU1 production zone"},{"url":"https://us1.make.celonis.com/api/v2","description":"Celonis US1 production zone"}],"security":[{"token":["scenarios:run"]}],"components":{"securitySchemes":{"token":{"type":"apiKey","name":"Authorization","in":"header","description":"Authorize the API call with your API token in the `Authorization` header with the value: `Token your-api-token`.\n\nIf you don't have an API token yet, please refer to the [\"Authentication\" section](/api-documentation/authentication) to learn how to create one.\n"}}},"paths":{"/scenarios/{scenarioId}/executions/{executionId}/replay":{"post":{"tags":["Scenarios / Logs"],"summary":"Replay a scenario execution","description":"Replays one execution of the scenario. The replay creates a new execution that runs the latest version of the scenario with the data of the original execution. The scenario has to be active, and only executions marked as replayable can be replayed.\n\nTo replay several executions (up to 100) in one call, use `POST /scenarios/{scenarioId}/replay`.\n\nThe scenario is not replayed when its organization or team is paused because an operations or data transfer limit was exceeded. In that case the call returns `429` with the code `IM310`.\n","parameters":[{"description":"The ID of the scenario. You can get the `scenarioId` with the [List scenarios](/api-reference/scenarios/get--scenarios.md) API call.","name":"scenarioId","in":"path","schema":{"type":"integer"},"required":true},{"description":"The unique ID of the scenario execution. It can be retrieved from the [List scenario logs](/api-reference/scenarios/logs/get--scenarios--scenarioid--logs.md) endpoint under the ID key.","name":"executionId","in":"path","schema":{"type":"string"},"required":true}],"responses":{"202":{"description":"202 Accepted - the replay was queued","content":{"application/json":{"schema":{"type":"object","required":["executionId"],"properties":{"executionId":{"type":"string","description":"ID of the new execution that replays the original one."}}}}}},"400":{"description":"400 Bad Request - malformed execution ID (`IM005`)"},"403":{"description":"403 Forbidden - the execution belongs to another team (`SC403`)"},"404":{"description":"404 Not Found - the execution was not found (`SC404`)"},"422":{"description":"422 Unprocessable Entity - the organization or team is paused, or the execution is not replayable (`SC422`)"},"429":{"description":"429 Too Many Requests - the organization or team is paused because a limit was exceeded (`IM310`), or no execution slot was available (`SC429`)"},"503":{"description":"503 Service Unavailable - execution replays are temporarily unavailable (`SC503`)"}}}}}}
```
## Operations by Module
> Retrieves an aggregated list of operations per module within a specified time period.
```json
{"openapi":"3.0.0","info":{"title":"Web API v2 - Public ","version":"1.0.0"},"tags":[{"name":"Scenarios / Logs","description":"The following endpoints allow you to manage scenarios logs."}],"servers":[{"url":"https://eu1.make.com/api/v2","description":"EU1 production zone"},{"url":"https://eu2.make.com/api/v2","description":"EU2 production zone"},{"url":"https://us1.make.com/api/v2","description":"US1 production zone"},{"url":"https://us2.make.com/api/v2","description":"US2 production zone"},{"url":"https://eu1.make.celonis.com/api/v2","description":"Celonis EU1 production zone"},{"url":"https://us1.make.celonis.com/api/v2","description":"Celonis US1 production zone"}],"security":[{"token":["scenarios:read"]}],"components":{"securitySchemes":{"token":{"type":"apiKey","name":"Authorization","in":"header","description":"Authorize the API call with your API token in the `Authorization` header with the value: `Token your-api-token`.\n\nIf you don't have an API token yet, please refer to the [\"Authentication\" section](/api-documentation/authentication) to learn how to create one.\n"}}},"paths":{"/scenarios/{scenarioId}/modules/operations":{"get":{"tags":["Scenarios / Logs"],"deprecated":true,"summary":"Operations by Module","description":"Retrieves an aggregated list of operations per module within a specified time period.","parameters":[{"description":"The ID of the scenario. You can get the `scenarioId` with the [List scenarios](/api-reference/scenarios/get--scenarios.md) API call.","name":"scenarioId","in":"path","schema":{"type":"integer"},"required":true},{"name":"days","in":"query","schema":{"type":"integer"},"description":"Days to summarize retrospectively. Default 1, must be between 1 and 30.","required":false}],"responses":{"200":{"description":"Module log retrieved","content":{"application/json":{"schema":{"type":"object","properties":{"operations":{"type":"array","items":{"type":"object","properties":{"moduleId":{"type":"integer"},"total":{"type":"integer","description":"The total number of module executions, including warnings and errors, within a specified time period."},"warnings":{"type":"integer"},"errors":{"type":"integer"}}}}}}}}}}}}}}
```
## List module logs
> Retrieves an operation logs of a given module within a given scenario. Returns the operation details such as execution id, timestamp or status.
```json
{"openapi":"3.0.0","info":{"title":"Web API v2 - Public ","version":"1.0.0"},"tags":[{"name":"Scenarios / Logs","description":"The following endpoints allow you to manage scenarios logs."}],"servers":[{"url":"https://eu1.make.com/api/v2","description":"EU1 production zone"},{"url":"https://eu2.make.com/api/v2","description":"EU2 production zone"},{"url":"https://us1.make.com/api/v2","description":"US1 production zone"},{"url":"https://us2.make.com/api/v2","description":"US2 production zone"},{"url":"https://eu1.make.celonis.com/api/v2","description":"Celonis EU1 production zone"},{"url":"https://us1.make.celonis.com/api/v2","description":"Celonis US1 production zone"}],"security":[{"token":["scenarios:read"]}],"components":{"securitySchemes":{"token":{"type":"apiKey","name":"Authorization","in":"header","description":"Authorize the API call with your API token in the `Authorization` header with the value: `Token your-api-token`.\n\nIf you don't have an API token yet, please refer to the [\"Authentication\" section](/api-documentation/authentication) to learn how to create one.\n"}}},"paths":{"/scenarios/{scenarioId}/modules/{moduleId}/logs":{"get":{"tags":["Scenarios / Logs"],"summary":"List module logs","description":"Retrieves an operation logs of a given module within a given scenario. Returns the operation details such as execution id, timestamp or status.","parameters":[{"description":"The ID of the scenario. You can get the `scenarioId` with the [List scenarios](/api-reference/scenarios/get--scenarios.md) API call.","name":"scenarioId","in":"path","schema":{"type":"integer"},"required":true},{"description":"The unique ID of the scenario module. It is available in the scenario blueprint that can be retrieved from the [Get scenario blueprint](/api-reference/scenarios/blueprint/get--scenarios--scenarioid--blueprint.md) endpoint.","name":"moduleId","in":"path","schema":{"type":"integer"},"required":true},{"name":"pg[offset]","in":"query","schema":{"type":"integer"},"description":"The number of entities you want to skip before getting entities you want."},{"name":"pg[limit]","in":"query","schema":{"type":"integer"},"description":"The maximum number of entities you want to get in the response."},{"name":"pg[showLast]","in":"query","schema":{"type":"boolean"},"description":"Include records with `last` value in the result set. Just in case of the `last` based paging."},{"name":"pg[last]","in":"query","schema":{"type":"integer"},"description":"The last retrieved key. In response, you get only entries that follow after the key."},{"name":"pg[sortBy]","in":"query","schema":{"type":"string"},"description":"The value that will be used to sort returned entities by."},{"name":"pg[sortDir]","in":"query","schema":{"type":"string","enum":["asc","desc"]},"description":"The sorting order. It accepts the ascending and descending direction specifiers."}],"responses":{"200":{"description":"Module logs retrieved","content":{"application/json":{"schema":{"type":"object","properties":{"moduleLogs":{"type":"array","items":{"type":"object","properties":{"imtId":{"type":"string"},"executionId":{"type":"string"},"organizationId":{"type":"integer"},"teamId":{"type":"integer"},"scenarioId":{"type":"integer"},"timestamp":{"type":"string","format":"date-time"},"status":{"type":"integer"},"bundles":{"type":"integer"},"size":{"type":"integer"},"warning":{"type":"object","description":"Present when status equals 2.","properties":{"message":{"type":"string"}}},"error":{"type":"object","description":"Present when status equals 3.","properties":{"message":{"type":"string"}}}}}},"pg":{"type":"object","properties":{"last":{"type":"string","description":"Shown only when using the `last` based pagination."},"showLast":{"type":"boolean","description":"Shown only when using the `last` based pagination."},"sortBy":{"type":"string"},"sortDir":{"type":"string"},"limit":{"type":"integer"},"offset":{"type":"integer","description":"Shown only when using the `offset` based pagination."}}}}}}}}}}}}}
```
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://developers.make.com/api-documentation/api-reference/scenarios/logs.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.