SUsuperit
comms

Decide Tool Approval

Approve or decline a pending command approval (REST counterpart of WS).

post/api/comms/{team_key}/tool-approvals/{approval_key}/decision

Request

  • Base URL
    https://api.superit.ai (the document declares no server; this is the origin it was published from)
  • Auth
    HTTP bearer

Path parameters

team_keystring required
approval_keystring required

Request body

approvedboolean required
reasonstring nullable
skippedStepKeysstring[]

Response

Successful Response

keystring required
toolNamestring required
toolCallIdstring required
parentToolCallIdstring nullable

The tool cycle the chat renders this under when tool_call_id is an explore sub-agent's call, which is never in the transcript.

commandstring required
titlestring nullable
reasonstring required
riskstring required
riskLevel'low' | 'medium' | 'high' required
status'PENDING' | 'APPROVED' | 'DENIED' | 'ABANDONED' | 'CANCELLED' | 'AUTO_APPROVED' required

API approval statuses.

chatKeystring required
teamNamestring required
createdAtstring date-time required
messagestring nullable required
operatingSystemstring nullable required
elevatedboolean
selfConsentEligibleboolean
cancelableboolean
targetLabelstring nullable
targetPlatformstring nullable

Target device os_platform: windows, linux or darwin.

decidedAtstring date-time nullable
approvalSource'command_judge' nullable
agentNamestring nullable
approvalReasonstring nullable
ticketChangedSinceProposalboolean

A pending PSA write whose ticket the PSA updated after the card went up; approving it is refused until it is proposed again.

outcome'verified' | 'written_unconfirmed' | 'failed' nullable

What an approved PSA write did. Null until the write finishes, and for anything that is not a PSA write.

outcomeDetailstring nullable

The PSA's displayed ticket number when verified, else the reason.

Changes

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