Governance

List governance events

get

List governance events for the user's workspace.

Only shows events that the user has permission to review.

cookie

authstringOptionalDefault: ""

Query parameters

object_typeany ofOptional

Filter by object type

stringOptional

or

nullOptional

statusany ofOptional

Filter by status (default: pending)

stringOptional

or

nullOptional

pageinteger · min: 1Optional

Page number

Default: 1

page_sizeinteger · min: 1 · max: 100Optional

Items per page

Default: 20

Header parameters

authorizationany ofOptionalDefault: ""

stringOptional

or

nullOptional

X-Internal-Serviceany ofOptional

stringOptional

or

nullOptional

Responses

200

Successful Response

application/json

422

Validation Error

application/json

get

/v1/governance/events

HTTPcURLJavaScriptPython

GET /v1/governance/events HTTP/1.1
Accept: */*

{
  "items": [
    {
      "id": "text",
      "workspace_id": "text",
      "object_type": "text",
      "object_id": "text",
      "status": "pending",
      "required_role": "text",
      "meta_info": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "created_by": "text",
      "created_at": "2026-02-13T09:32:03.756Z",
      "updated_at": "2026-02-13T09:32:03.756Z"
    }
  ],
  "total": 1,
  "page": 1,
  "page_size": 1
}

Get governance event details

get

Get details of a specific governance event.

cookie

authstringOptionalDefault: ""

Path parameters

event_idstringRequired

Header parameters

authorizationany ofOptionalDefault: ""

stringOptional

or

nullOptional

X-Internal-Serviceany ofOptional

stringOptional

or

nullOptional

Responses

200

Successful Response

application/json

422

Validation Error

application/json

get

/v1/governance/events/{event_id}

HTTPcURLJavaScriptPython

GET /v1/governance/events/{event_id} HTTP/1.1
Accept: */*

{
  "id": "text",
  "workspace_id": "text",
  "object_type": "text",
  "object_id": "text",
  "status": "pending",
  "required_role": "text",
  "meta_info": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "created_by": "text",
  "created_at": "2026-02-13T09:32:03.756Z",
  "updated_at": "2026-02-13T09:32:03.756Z"
}

Approve governance event

post

Approve a governance event.

Forwards the approval to the target endpoint specified in the event's approve_spec.

cookie

authstringOptionalDefault: ""

Path parameters

event_idstringRequired

Header parameters

authorizationany ofOptionalDefault: ""

stringOptional

or

nullOptional

X-Internal-Serviceany ofOptional

stringOptional

or

nullOptional

Body

application/json

Request to approve a governance event

notesany ofOptional

Approval notes

stringOptional

or

nullOptional

Responses

200

Successful Response

application/json

422

Validation Error

application/json

post

/v1/governance/events/{event_id}/approve

HTTPcURLJavaScriptPython

POST /v1/governance/events/{event_id}/approve HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 16

{
  "notes": "text"
}

{
  "event_id": "text",
  "action_type": "approve",
  "status": "pending",
  "response_status": 1,
  "success": true,
  "message": "text"
}

Reject governance event

post

Reject a governance event.

Forwards the rejection to the target endpoint specified in the event's reject_spec.

cookie

authstringOptionalDefault: ""

Path parameters

event_idstringRequired

Header parameters

authorizationany ofOptionalDefault: ""

stringOptional

or

nullOptional

X-Internal-Serviceany ofOptional

stringOptional

or

nullOptional

Body

application/json

Request to reject a governance event

reasonstringRequired

Reason for rejection

Responses

200

Successful Response

application/json

422

Validation Error

application/json

post

/v1/governance/events/{event_id}/reject

HTTPcURLJavaScriptPython

POST /v1/governance/events/{event_id}/reject HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 17

{
  "reason": "text"
}

{
  "event_id": "text",
  "action_type": "approve",
  "status": "pending",
  "response_status": 1,
  "success": true,
  "message": "text"
}

List governance actions (audit trail)

get

List governance actions (audit trail) for the user's workspace.

cookie

authstringOptionalDefault: ""

Query parameters

pageinteger · min: 1Optional

Page number

Default: 1

page_sizeinteger · min: 1 · max: 100Optional

Items per page

Default: 20

Header parameters

authorizationany ofOptionalDefault: ""

stringOptional

or

nullOptional

X-Internal-Serviceany ofOptional

stringOptional

or

nullOptional

Responses

200

Successful Response

application/json

422

Validation Error

application/json

get

/v1/governance/actions

HTTPcURLJavaScriptPython

GET /v1/governance/actions HTTP/1.1
Accept: */*

{
  "items": [
    {
      "id": "text",
      "event_id": "text",
      "action_type": "approve",
      "reviewer_id": "text",
      "notes": "text",
      "response_status": 1,
      "response_data": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "created_at": "2026-02-13T09:32:03.756Z"
    }
  ],
  "total": 1,
  "page": 1,
  "page_size": 1
}