Approve or reject workflow step

put

https://api.seismic.com/integration/v2/approvalWorkflows/{approvalWorkflowId}/steps/{stepId}

Applies an approval decision to a specific workflow step identified by approvalWorkflowId and stepId.

Use this endpoint to record a step-level action (approve, reject, or revoke) and retrieve the updated workflow snapshot, including current status and step decision details.

Glossary: approvalWorkflowId — Identifier of an approval workflow instance. stepId — Identifier of a specific step within that workflow. nextApprover — Optional principal that can be assigned as the upcoming step approver when workflow configuration allows dynamic routing.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

approvalWorkflowId

string

required

Unique UUID identifier of the approval workflow instance that contains the target step.

stepId

string

required

Unique UUID identifier of the workflow step to approve, reject, or revoke.

Body Params

Action payload describing the decision to apply to the step.

Request payload used to approve, reject, or revoke a workflow step.

action

string

enum

The decision an authenticated approver records on a workflow step. approve advances the workflow to the next step (or marks it complete when this is the final step); reject halts the workflow and returns the content to the submitter; revoke is used to cancel a previously-recorded approval, typically because new information requires the approver to reconsider.

Allowed:

comment

string

Optional explanation provided with the step action.

nextApprover

object

Optional principal assignment for dynamic next-step routing.

Headers

Content-Type

string

Content type for request payload. Must be application/json.

Responses

Language

Credentials

Header

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200OK. Returns the updated workflow after the step decision is applied.

400Bad Request. One or more path parameters or request body fields are invalid

401Unauthorized. The request is missing a bearer token, or the token is invalid or expired.

403Forbidden. The caller is authenticated but is not allowed to act on this step.

404Not Found. The targeted teamsite, folder, file, item, or workflow could not be located by the provided identifier.

500Internal Server Error. An unexpected server-side error occurred while processing the request.

504Gateway Timeout. The upstream service did not respond in time, or is temporarily unavailable. Safe to retry after a brief delay.