---
title: "POST /v2/agent/{agentId}/transfer-rules"
method: POST
path: "/v2/agent/{agentId}/transfer-rules"
---

# POST /v2/agent/{agentId}/transfer-rules

`POST /v2/agent/{agentId}/transfer-rules`

Cria uma nova regra de transferência para o agente especificado

## Path parameters

- `agentId` string, required

## Request body

- object
  - `instructions` string — Instruções visíveis na transferência
  - `returnOnFinish` boolean — Define se deve retornar ao assistente após o atendimento
  - `type` 'HUMAN' | 'AGENT'
  - `userId` string, nullable — Id do usuário de destino (caso o tipo seja HUMAN)
  - `agentId` string, nullable — Id do agente de destino (caso o tipo seja AGENT)

## Response `200`

Regra de transferência criada com sucesso

- object
  - `id` string — Id da regra
  - `createdAt` string — data de atualização do campo
  - `instructions` string — Instruções visíveis na transferência
  - `returnOnFinish` boolean — Define se deve retornar ao assistente após o atendimento
  - `type` 'HUMAN' | 'AGENT'
  - `agentId` string, nullable — Id do agente de destino (se aplicável)
  - `userId` string, nullable — Id do usuário de destino (se aplicável)

## Other responses

- `400` — Erro inesperado
- `403` — Erro de token

---

[API](https://skmtc.net/gptmaker/apis/openapi-gpt-maker.md) · [All operations](https://skmtc.net/gptmaker/apis/openapi-gpt-maker/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gptmaker/openapi-gpt-maker/versions/bda09b3eba6e/schema)