---
title: "Reordenar contextos do agente"
method: PUT
path: "/api/management/ai/agents/{agentId}/contexts/reorder"
tags: ["ai-agents", "agents", "contexts", "reorder"]
---

# Reordenar contextos do agente

`PUT /api/management/ai/agents/{agentId}/contexts/reorder`

## Request

- Base URL: `https://api.olie.ai`
- URL: `https://api.olie.ai/api/management/ai/agents/{agentId}/contexts/reorder`
- Auth: HTTP bearer

Redefine a posição dos contextos do agente. Envie cada contexto com seu `id` e a nova `order`; todos os IDs precisam pertencer a este agente, e os contextos que não aparecerem na lista ficam com a posição que já tinham.

## Request body

- object: Novas posições dos contextos do agente.
  - `contexts` object[], required: Contextos a reposicionar; os que não aparecerem na lista mantêm a posição atual.
    - `id` string, uuid, required: ID (UUID) de um contexto que pertence a este agente.
    - `order` integer, required: Nova posição do contexto na sequência aplicada ao prompt.

## Response `200`

Sucesso

- object: Confirmação da reordenação, sem corpo de dados.
  - `response` boolean: Indicador de sucesso da requisição; sempre verdadeiro nesta resposta.

## Other responses

- `422`: Erro de validação

## Changes

- **2026-09-22** `d71b18b1685d`: 3 breaking, 1 warning
  - added the new required request property `contexts/items/id`
  - the request property `contexts` became required
  - the request property `contexts/items/order` became required
  - removed the optional property `validation/contexts.0.id` from the response with the `422` status
- **2026-09-22** `b43a04f35145`: 1 warning
  - removed the request property `contexts/items/id`
- **2026-09-18** `468063611950`: 3 info
  - added optional request body
  - added the media type `application/json` for the response with the status `200`
  - added the non-success response with the status `422`

[Operation history](https://skmtc.dev/olie-ai/apis/olie-api/changes/api/management/ai/agents/:agentId/contexts/reorder/put.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/fbae0c094507?raw)