---
title: "Reorder Voice Questions"
description: "Set the order a voice agent asks its questions in."
---

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

# Reorder Voice Questions

Use the Speak AI MCP server tool `reorder_voice_questions` to set the order a voice
agent asks its questions in.

## What does it do?

Set the order a voice agent asks its questions in. Requires the OWNER or ADMIN role.
Bulk-writes the order value on each listed question (written directly, not
resequenced), then returns the agent's full question list in its new order. Entries
whose fieldId doesn't belong to agentId are silently skipped.

## Parameters

`reorder_voice_questions` takes 2 parameters, all of them required.

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `agentId` | string | Yes |  |
| `fieldOrders` | array of object | Yes | The new order for some or all of the agent's questions. |

## Behaviour

The Speak AI MCP server publishes these behaviour hints for
`reorder_voice_questions`.

- Can change data in your workspace.
- Can delete or overwrite data. Use with care.
- Repeating an identical call is safe.
- Stays inside Speak AI. Does not reach other systems.

## Related

- [Voice agents](/mcp/tools/voice-agents/) lists the rest of the Voice agents
  category.
- [Tool reference](/mcp/tools/) lists every Speak AI MCP server tool.
- [MCP server](/mcp/) covers setup, supported clients, and what agents can do once
  connected.

Source: https://docs.speakai.co/mcp/tools/voice-agents/reorder_voice_questions/index.mdx