---
title: "Get replica"
method: GET
path: "/v1/replica/{id}"
tags: ["Replica"]
---

# Get replica

`GET /v1/replica/{id}`

## Request

- Base URL: `https://api.replicas.dev`
- URL: `https://api.replicas.dev/v1/replica/{id}`
- Auth: HTTP bearer

Returns the replica with its chats, repositories, and pull requests. Sleeping and archived replicas return their retained chats without waking. Use `include` for environment details and diffs.

## Path parameters

- `id` string, uuid, required

## Query parameters

- `include` string

## Headers

- `X-Replicas-Api-Version` '2026-10-07'

## Response `200`

Successful response

- GetReplicaResponse
  - `replica` ReplicaDetails, required: A workspace item in list responses
    - `id` string, uuid, required: Unique identifier for the workspace
    - `name` string, required: Human-readable name for the workspace. Must not contain whitespace.
    - `status` 'active' | 'sleeping' | 'archived' | 'preparing' | 'error', required: Current status of the workspace
    - `source` 'api' | 'dashboard' | 'slack' | 'linear' | 'github' | 'gitlab' | 'automation', required: How the workspace was created
    - `created_at` string, date-time, required: Timestamp when the workspace was created
    - `last_activity_at` string, date-time, nullable, required: Timestamp of the last activity on the workspace
    - `repositories` RepositoryReference[], required: Repositories associated with the workspace
      - `id` string, uuid, required: Repository ID
      - `name` string, required: Repository name
      - `url` string, uri, required: Repository URL
    - `pull_requests` PullRequest[], required: Associated pull requests
      - `repository` string, required: Repository name
      - `number` integer, required: Pull request number
      - `url` string, uri, required: URL to the pull request
    - `coding_agent` 'claude' | 'codex' | 'cursor' | 'muse' | 'opencode' | 'pi' | 'null', nullable: Currently active coding agent
    - `repository_statuses` RepositoryStatus[]: Status of each repository in the workspace
      - `repository` string, required: Repository name
      - `branch` string, required: Current git branch
      - `default_branch` string, required: Default branch of the repository
      - `pr_urls` string[], required: All pull request URLs the workspace has opened in this repository.
      - `start_hooks_completed` boolean, required: Whether start hooks have finished executing
      - `git_diff` GitDiff, required: Git diff statistics
        - `added` integer, required: Number of lines added
        - `removed` integer, required: Number of lines removed
        - `full_diff` string, required: Full diff content
    - `waking` boolean, nullable: Whether the workspace was just woken from a sleeping state. Retry in 30-90 seconds for full details.
    - `chats` ReplicaChat[]: Chat sessions in this workspace
      - `id` string, required: Unique identifier for the chat
      - `provider` 'claude' | 'codex' | 'cursor' | 'muse' | 'opencode' | 'pi', required: Coding agent provider for this chat
      - `title` string, required: Chat title
      - `created_at` string, date-time, required: When the chat was created
      - `updated_at` string, date-time, required: When the chat was last updated
      - `processing` boolean, required: Whether the chat is currently doing work — either processing a foreground message or running background/spawned-agent tasks
    - `environment` ReplicaEnvironment: Environment configuration and status for a workspace
      - `engine_version` string, required: Version of the workspace engine
      - `files_uploaded` string[], required: List of uploaded file names
      - `env_vars_set` string[], required: List of environment variable names that are set
      - `skills_installed` string[], required: List of installed skill names
      - `integrations` object, required: Integration connection statuses
        - `github` boolean, required
        - `gitlab` boolean, required
        - `linear` boolean, required
        - `slack` boolean, required
      - `coding_agents` object, required: Available coding agents and their authentication methods
        - `claude` object, required
          - `available` boolean, required
          - `auth_method` string, required
        - `codex` object, required
          - `available` boolean, required
          - `auth_method` string, required
        - `muse` object, required
          - `available` boolean, required
          - `auth_method` string, required
        - `opencode` object, required
          - `available` boolean, required
          - `auth_method` string, required
        - `pi` object, required
          - `available` boolean, required
          - `auth_method` string, required
        - `cursor` object, required
          - `available` boolean, required
          - `auth_method` string, required
      - `hooks` object, required: Hook configuration and status
        - `environment_warm_hook` object, required: Warm hooks of the environment and the environments it builds on, run as one step
          - `status` string, required
          - `details` string, nullable, required
        - `repositories` object[], required
          - `repository_name` string, required
          - `warm_hook` string, required
          - `start_hook` string, required
      - `last_updated_at` string, date-time, required: When the environment was last updated
    - `activity` ReplicaActivity: What the replica's agent is doing, as its chat shows it. Background tasks the agent will wake up for count as working.
      - `state` 'working' | 'waiting_for_input' | 'idle', required
      - `chat_id` string, nullable, required: The chat described: the requested one, or the most recently active
      - `current_step` string, nullable, required: What the agent is doing now, such as `Running npm test`, while it is working
      - `last_agent_message` string, nullable, required: The agent's latest message, cut to 2,000 characters

## Other responses

- `401`: Unauthorized - Invalid or missing API key
- `404`: Resource not found
- `500`: Internal server error
- `502`: Bad gateway - The workspace is unreachable or returned an invalid response

---

[API](https://skmtc.dev/replicas/apis/replicas-api.md) - [All operations](https://skmtc.dev/replicas/apis/replicas-api/llms.txt) - [OpenAPI document](https://skmtc.dev/replicas/apis/replicas-api/revisions/2703ac1c9cb7?raw)