> ## Documentation Index
> Fetch the complete documentation index at: https://reach-owl.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Stages API: Create and Manage Pipeline Stages

> Stages represent steps in your ReachOwl outreach pipeline. Create, reorder, and delete stages to organize contact progress through your funnel.

Stages are the steps in your ReachOwl outreach pipeline. Use these endpoints to list stages for a team, view a single stage, create new stages, reorder them, or delete stages you no longer need.

## List stages

```bash theme={null}
curl -X GET "https://api.reachowl.com/api/v1/stages?team_id=123" \
  -H "Authorization: Bearer <token>"
```

<ParamField query="team_id" type="integer" required>
  The team whose stages you want to list.
</ParamField>

## Get a single stage

```bash theme={null}
curl -X GET https://api.reachowl.com/api/v1/stages/456 \
  -H "Authorization: Bearer <token>"
```

## Create a stage

```bash theme={null}
curl -X POST https://api.reachowl.com/api/v1/stages \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Connected",
    "order": 2
  }'
```

<ParamField body="name" type="string" required>
  Display name of the stage.
</ParamField>

<ParamField body="order" type="integer" required>
  Position of the stage in the pipeline. Lower values appear first.
</ParamField>

## Reorder stages

Send the full array of stages with updated order values. The API will persist the new sequence.

```bash theme={null}
curl -X PUT https://api.reachowl.com/api/v1/stages \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '[
    {"id": 1, "order": 0},
    {"id": 2, "order": 1},
    {"id": 3, "order": 2}
  ]'
```

<ParamField body="id" type="integer" required>
  Stage identifier.
</ParamField>

<ParamField body="order" type="integer" required>
  New position for the stage.
</ParamField>

## Delete a stage

```bash theme={null}
curl -X DELETE https://api.reachowl.com/api/v1/stages/456 \
  -H "Authorization: Bearer <token>"
```