Skip to main content
GET
List replicas

Authorizations

Authorization
string
header
required

Organization or personal API key from Settings → API Keys.

Headers

X-Replicas-Api-Version
enum<string>

API version. 2026-10-07 returns snake_case responses. See versioning.

Available options:
2026-10-07

Query Parameters

page
integer
default:1

Page number for pagination

Required range: x >= 1
limit
integer
default:10

Number of items per page

Required range: 1 <= x <= 100
user_id
string

Filter replicas by the user who created them

source
enum<string>

Filter replicas by creation source

Available options:
api,
dashboard,
slack,
linear,
github,
gitlab,
automation
status
enum<string>

Filter replicas by status

Available options:
active,
sleeping,
archived,
preparing,
error
kind
enum<string>

Filter replicas by kind, such as manager to list only Managers manager for a Manager, scout for Scout, standard otherwise

Available options:
standard,
manager,
scout

Response

Successful response

replicas
object[]
required

Array of workspaces

total
integer
required

Total number of workspaces matching the filters

page
integer
required

Current page number

limit
integer
required

Number of items per page

total_pages
integer
required

Total number of pages