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

# Pausar agente

> Pausa um agente de IA ativo, interrompendo novas execuções.

## Endpoint

```
POST /v1/ai-agents/:id/pause
```

**Escopo necessário:** `write:ai_agents`

Transição de status: `active` → `paused`

O agente para de responder a novos eventos. Execuções já em andamento são concluídas normalmente.

## Exemplo de requisição

```bash theme={null}
curl -X POST https://api.socialsell.ai/v1/ai-agents/664p1q2r3s4t5u6v7w8x9y0z/pause \
  -H "Authorization: Bearer sk_live_..."
```

## Resposta

Retorna `HTTP 200` com o agente no status `paused`.