Replicas

Replicas Preview API

Manage public preview URLs for workspace ports

Documentation GitHub OpenAPI

Operations 2

DELETE /v1/previews/{port} Delete Preview #

DELETE /v1/workspaces/{workspaceId}/previews/{port} Delete Workspace Preview #

Specifications

⚙

OpenAPI

https://raw.githubusercontent.com/api-evangelist/replicas/refs/heads/main/openapi/replicas-preview-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/replicas-preview-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Replica Analytics Preview API
  version: 2.0.0
  description: The Replica API allows you to programmatically manage cloud workspaces for AI agents. Use this API to manage environments (the org-scoped primitive workspaces are created from — including variables, files, skills, MCPs, warm hooks, start hooks, and warm pools), create and manage replicas, send messages, manage chats, stream events, read connected repositories and repository sets, and configure automations.
servers:
- url: https://api.tryreplicas.com
  description: Production API
security:
- apiKey: []
tags:
- name: Preview
  description: Manage public preview URLs for workspace ports
paths:
  /v1/previews/{port}:
    delete:
      operationId: deleteAgentPreview
      summary: Delete Preview
      description: Unregisters a preview port for the authenticated workspace. This endpoint is intended for agent mode and requires the workspace ID header plus the workspace engine secret as a bearer token.
      tags:
      - Preview
      security:
      - engineSecret: []
        workspaceId: []
      parameters:
      - name: port
        in: path
        description: Workspace port number to unregister.
        required: true
        schema:
          type: integer
          minimum: 1
          maximum: 65535
      responses:
        '200':
          description: Preview deleted
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeletePreviewResponse'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
        '500':
          $ref: '#/components/responses/InternalServerError'
  /v1/workspaces/{workspaceId}/previews/{port}:
    delete:
      operationId: deleteWorkspacePreview
      summary: Delete Workspace Preview
      description: Unregisters a preview port for a workspace in the authenticated organization.
      tags:
      - Preview
      parameters:
      - name: workspaceId
        in: path
        description: Workspace UUID.
        required: true
        schema:
          type: string
          format: uuid
      - name: port
        in: path
        description: Workspace port number to unregister.
        required: true
        schema:
          type: integer
          minimum: 1
          maximum: 65535
      responses:
        '200':
          description: Preview deleted
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeletePreviewResponse'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
        '500':
          $ref: '#/components/responses/InternalServerError'
components:
  schemas:
    Error:
      type: object
      properties:
        error:
          type: string
          description: Error message
        details:
          type:
          - string
          - 'null'
          description: Additional error details
      required:
      - error
    DeletePreviewResponse:
      type: object
      properties:
        success:
          type: boolean
          description: Whether the preview was deleted
        port:
          type: integer
          description: Port number that was unregistered
      required:
      - success
      - port
  responses:
    BadRequest:
      description: Bad request - Missing or invalid parameters
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    InternalServerError:
      description: Internal server error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    NotFound:
      description: Resource not found
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Unauthorized:
      description: Unauthorized - Invalid or missing API key
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  securitySchemes:
    apiKey:
      type: http
      scheme: bearer
      description: API key authentication. Obtain your API key from the Replicas dashboard under Organization → Settings → API Keys.
    engineSecret:
      type: http
      scheme: bearer
      description: Workspace engine secret used by agent-mode workspace requests.
    workspaceId:
      type: apiKey
      in: header
      name: X-Workspace-Id
      description: Workspace ID used with the engine secret for agent-mode workspace requests.