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

# Get Replica

`GET /v1/replica/{id}`

Returns detailed information about a specific replica by its ID. Use the `include` query parameter to request additional data such as environment configuration and diffs. If the workspace is sleeping or archived, it will be woken and the response will indicate this with `waking: true`.

## Path parameters

- `id` string, uuid, required

## Query parameters

- `include` string

## Response `200`

Successful response

- GetReplicaResponse
  - `replica` ReplicaDetails, required — A replica item in list responses
    - `id` string, uuid, required — Unique identifier for the replica
    - `name` string, required — Human-readable name for the replica. Must not contain whitespace.
    - `status` 'active' | 'sleeping' | 'archived' | 'preparing' | 'error', required — Current status of the replica
    - `source` 'api' | 'dashboard' | 'slack' | 'linear' | 'github' | 'gitlab' | 'automation', required — How the replica was created
    - `created_at` string, date-time, required — Timestamp when the replica was created
    - `last_activity_at` string, date-time, nullable, required — Timestamp of the last activity on the replica
    - `repositories` RepositoryReference[], required — Repositories associated with the replica
      - `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' | 'opencode' | 'pi' | 'null', nullable — Currently active coding agent
    - `repository_statuses` RepositoryStatus[] — Status of each repository in the replica
      - `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 or archived state. Retry in 30-90 seconds for full details.
    - `chats` ReplicaChat[] — Chat sessions in this replica
      - `id` string, required — Unique identifier for the chat
      - `provider` 'claude' | 'codex' | 'cursor' | '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 replica
      - `engine_version` string, required — Version of the replica 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
        - `google` 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
        - `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
        - `global_warm_hook` object, required
          - `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

## 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.net/tryreplicas/apis/replica-api.md) · [All operations](https://skmtc.net/tryreplicas/apis/replica-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tryreplicas/replica-api/versions/aa3b4c932f7a/schema)