Request Approval
POST /api/v1/team-chat/threads/{thread_id}/approvals
Request approval within a conversation thread.
Args: thread_id: The thread UUID string. body: Approval request data. user: The authenticated user context. svc: The approval service (injected).
Returns: The approval request message.
Authorizations
Parameters
Path Parameters
Request Body required
Input schema for requesting approval from another agent or user.
Attributes: what: Description of what needs approval. why: Reason the approval is needed. suggested_action: The proposed action to approve. deadline_seconds: Timeout before escalation (default 300s). escalation_chain: Ordered list of escalation targets. requester_role: Agent role requesting approval. target_role: Agent role or “user” being asked to approve.
object
Responses
200
Successful Response
Response schema for a persisted conversation message.
Attributes: id: Unique message identifier. thread_id: Owning thread identifier. sender_role: Agent role or “user”. sender_id: User ID if sender is human. content: Message content text. message_type: Type of message. artifacts: List of artifact IDs referenced. a2a_task_id: Link to A2A task if applicable. metadata: Extensible metadata. created_at: When the message was created.
object
422
Validation Error