---
title: "Criar contexto do agente"
method: POST
path: "/api/management/ai/agents/{agentId}/contexts"
tags: ["ai-agents", "agents", "contexts"]
---

# Criar contexto do agente

`POST /api/management/ai/agents/{agentId}/contexts`

Cria um contexto do agente. Sem `order`, ele entra no fim da lista. Para `type: "text"` envie o texto em `content`; para `type: "file"` envie a requisição como `multipart/form-data` com o arquivo no campo `file` (imagem ou PDF, até 10 MB) — nesse caso o `content` passa a apontar para o arquivo armazenado.

## Request body

- object — Dados do contexto a criar. Contextos do tipo `file` exigem uma requisição multipart/form-data.
  - `type` 'text' | 'file', required — Tipo do contexto.
  - `content` string, nullable — Texto do contexto. Obrigatório quando nenhum arquivo é enviado.
  - `file` string, binary — Arquivo do contexto: imagem ou PDF de até 10 MB. Obrigatório quando `type` é `file` e só pode ser enviado em requisição multipart/form-data.
  - `order` integer — Posição do contexto na sequência. Omita o campo para acrescentar o contexto ao fim da lista.
  - `is_active` boolean — Define se o contexto é aplicado ao prompt. Quando omitido, o contexto nasce ativo.

## Response `201`

Sucesso

- object — Contexto recém-criado.
  - `type` 'text' | 'file' — Tipo do contexto.
  - `content` string, nullable — Texto do contexto ou endereço do arquivo armazenado.
  - `mime_type` string — Tipo do arquivo enviado; presente apenas em contextos do tipo `file`.
  - `order` integer — Posição do contexto na sequência aplicada ao prompt.
  - `is_active` boolean — Indica se o contexto é aplicado ao prompt do agente.
  - `ai_agent_id` string, uuid — ID (UUID) do agente dono do contexto.
  - `updated_at` string, date-time — Data e hora da última alteração do contexto.
  - `created_at` string, date-time — Data e hora de criação do contexto.
  - `id` string, uuid — ID (UUID) do contexto.

## Other responses

- `404` — Agente não encontrado
- `422` — Erro de validação

## Changes

- **2026-09-22** `d71b18b1685d` — 3 breaking, 4 warning, 6 info
  - request property `type` was restricted to a list of enum values
  - the request property `type` became required
  - the response property `content` became nullable for the status `201`
  - removed the optional property `validation/content` from the response with the `422` status
  - …9 more
- **2026-09-18** `468063611950` — 1 breaking, 4 info
  - removed the success response with the status `200`
  - added optional request body
  - added the non-success response with the status `404`
  - added the non-success response with the status `422`
  - …1 more

[Change history](https://skmtc.dev/olie-ai/apis/olie-api/changes/api/management/ai/agents/:agentId/contexts/post.md)

---

[API](https://skmtc.dev/olie-ai/apis/olie-api.md) · [All operations](https://skmtc.dev/olie-ai/apis/olie-api/llms.txt) · [OpenAPI document](https://skmtc.dev/olie-ai/apis/olie-api/revisions/d71b18b1685d?raw)