> Revox API docs for developers and AI agents. Index: https://www.getrevox.com/docs/api/llms.txt · Everything in one file: https://www.getrevox.com/docs/api/llms-full.txt · OpenAPI 3.1: https://www.getrevox.com/openapi.json · MCP server: https://www.getrevox.com/mcp
> Base URL https://www.getrevox.com/api · Auth: `Authorization: Bearer $REVOX_API_KEY`

# Get a multi-step flow

`GET https://www.getrevox.com/api/assistants/{id}/edges`

The steps of a multi-step assistant and the transitions between them. Transitions are found by walking the flow outward from the given assistant, so pass the multi-step assistant's id to get the whole flow.

## Before you call

- A multi-step assistant is its own start step: its prompt runs first, and its voice, first sentence and other call settings apply to the whole call. Each entry of `steps` is a later phase with its own prompt, which replaces the start step's when the call reaches it (only the conversation carries over).
- Steps are not in [`GET /assistants`](https://www.getrevox.com/docs/api/assistants/get-assistants.md): take their ids from `steps`, then read or change a step with GET and [`PATCH /assistants/{id}`](https://www.getrevox.com/docs/api/assistants/update-an-assistant.md).

## Request

```bash
curl -X GET "https://www.getrevox.com/api/assistants/3f6c2a1e-8b4d-4c7a-9e2f-5d1b7a9c0e34/edges" \
  -H "Authorization: Bearer $REVOX_API_KEY"
```

## Path parameters

- `id` (string, required): ID of the assistant, as returned by [`GET /assistants`](https://www.getrevox.com/docs/api/assistants/get-assistants.md).

## Body

No body: send the request without one.

## Response 200

```json
{
  "edges": [
    {
      "source": "source",
      "target": "target",
      "condition": "la personne veut réserver une salle"
    }
  ],
  "steps": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "Appointment reminder"
    }
  ]
}
```

- `edges` (array of object): The flow's transitions, each taken when its condition is met.
  - `edges.source` (string): The step the call leaves: the flow's id (its start step) or one of its steps' ids.
  - `edges.target` (string): The step the call moves to, one of the flow's steps' ids.
  - `edges.condition` (string): When the call takes this transition, as one natural-language sentence the agent evaluates during the call, e.g. « la personne veut réserver une salle ». A transition with an empty condition is ignored on calls. Example: `"la personne veut réserver une salle"`.
- `steps` (array of object): The flow's steps (sub-assistants), the start step excluded: its id is the flow's own.
  - `steps.id` (string): The step's assistant id: read it with [`GET /assistants/{id}`](https://www.getrevox.com/docs/api/assistants/get-assistant-by-id.md), change its prompt or settings with [`PATCH /assistants/{id}`](https://www.getrevox.com/docs/api/assistants/update-an-assistant.md).
  - `steps.name` (string): The step's name, as on the flow editor's canvas.

## Errors

- `404` Not found in your organization: `{"error":"Not found"}`
- Every status is explained under Errors in https://www.getrevox.com/docs/api.md#errors.