Skip to content

Approve an action

POST
/api/v1/approvals/{approval_id}/approve

Approves a pending action, optionally with feedback for the agent.

Authorizations

Parameters

Path Parameters

approval_id
required

The approval item ID to approve

string

The approval item ID to approve

Request Body

Any of:

Request body for approving an action.

Attributes: feedback: Optional reason or context for the approval.

object
feedback
Any of:
string

Responses

200

Successful Response

Envelope response for approval action endpoints.

Attributes: data: The approval decision payload. meta: Standard response metadata.

object
data
required

Inner data payload for approval decision responses.

Attributes: decision: The decision made (approved, rejected, modified). decision_id: The ID of the approval that was acted on. action_type: The action type that was decided on. feedback: Owner feedback, if provided. reason: Rejection reason, if applicable. modifications: Requested modifications, if applicable. execution_result: Result of executing the action, if available.

object
action_type
required
string
decision
required
string
decision_id
required
string
execution_result
Any of:
object
key
additional properties
any
feedback
Any of:
string
modifications
Any of:
string
reason
Any of:
string
meta

Standard metadata included in every API response.

Attributes: request_id: Unique identifier for this request. timestamp: When the response was generated.

object
request_id

Unique identifier for this request

string
timestamp

When the response was generated

string format: date-time

422

Validation Error

object
detail
Array<object>
object
ctx
object
input
loc
required
Array
msg
required
string
type
required
string