For canonical Banger actions, Banger derives exact scopes, applies the workspace review policy, records an immutable audit request, and automatically queues actions within the configured limit. To publish managed email source, use action_kind managed_email.publish and payload {content_id, expected_version}; Banger binds the source revision/hash and enforces human review when required. Generic approval kinds always remain pending and must provide summary, capabilities, and resources. In mail.draft and transactional.send payloads, to, cc, bcc and reply_to accept any RecipientInput shape and are stored as { email, name } objects.

post/v1/workspaces/{workspaceId}/approvals

Request

  • Base URL: https://api.bangermail.com
  • URL: https://api.bangermail.com/v1/workspaces/{workspaceId}/approvals
  • Auth: HTTP bearer

Headers

Idempotency-Keystring

Required for recognized Banger actions; custom approval requests do not consume this header.

Request body

action_kindstring required
summarystring
capabilitiesstring[]
resourcesobject
payloadobject required
expires_in_secondsinteger
approve_as_launcherboolean

For sequence.activate: a person pressing Turn on approves this exact request when the review policy needs a person. Ignored for API keys and agents, which wait in Approvals.

Response

Governed request created; it may already be automatically approved and queued.

Changes

No recorded changes to this operation across all 1 revision of this API.