> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xpander.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Confirm Card-Gated Action

> Approve or decline a confirmation card and continue the turn (SSE).

When a turn raises a confirmation card for a destructive action (deleting an agent, for example), approve or decline it here. The target of the action is read from the card itself, never from the body, and the action's own permission check runs again against the confirming user. `approve: false` dismisses the card and changes nothing. Streams the continued turn's events over SSE.

See the [Conversations overview](/api-reference/v1/agents/conversations/overview) for the full conversation model.


## OpenAPI

````yaml POST /v1/agents/{agent_id}/conversations/{conversation_id}/confirm
openapi: 3.1.0
info:
  title: xpander.ai API Service
  description: |2-

        The xpander.ai API Service provides a unified REST API for managing AI agents,
        executing tasks, managing knowledge bases, and integrating with external systems.
        
        Features:
        - Agent Management: Create, update, deploy, and delete AI agents
        - Task Execution: Invoke agents with support for sync, async, and streaming modes
        - Knowledge Bases: Manage knowledge bases and documents for RAG workflows
        - Tools: Discover, connect, and attach tools (connectors, custom functions, MCP servers, sub-agents, workflows) to agents and workflows
        - MCP Integration: Model Context Protocol support for standardized AI interactions
        
        Authentication: All endpoints require authentication via either an API key (`x-api-key`) or an OAuth2 JWT (`Authorization: Bearer <jwt>`).
        
  version: '0.001'
servers:
  - url: https://api.xpander.ai
security: []
paths:
  /v1/agents/{agent_id}/conversations/{conversation_id}/confirm:
    post:
      tags:
        - API v1
        - Agents
        - Conversations
      summary: Confirm Card-Gated Action (Stream)
      description: >-
        Approve or decline a confirmation card and continue the turn, streaming
        every event over SSE. The target of the action is read from the card
        itself, never from the body.
      operationId: >-
        Confirm_Card_Gated_Action_Stream__v1_agents_agent_id_conversations__conversation_id_confirm_post
      parameters:
        - name: agent_id
          in: path
          required: true
          schema:
            type: string
            title: Agent Id
        - name: conversation_id
          in: path
          required: true
          schema:
            type: string
            title: Conversation Id
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                request_id:
                  type: string
                approve:
                  type: boolean
              required:
                - request_id
      responses:
        '200':
          description: Server-Sent Events stream of TaskUpdateEvent frames
      security:
        - APIKeyHeader: []
components:
  securitySchemes:
    APIKeyHeader:
      type: apiKey
      description: API Key for authentication
      in: header
      name: x-api-key

````