> ## Documentation Index
> Fetch the complete documentation index at: https://docs.orgo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# List public URLs

> A computer's public URLs, and how many it can have.

Returns the computer's [public URLs](https://docs.orgo.ai/guides/public-urls.md), with `limit` (most this computer can have) and `account_limit` and `account_used` (across all the workspace owner's computers).

When `enabled` is `false`, public URLs are off for your account or this computer can't have them, and the list is empty. Only Linux and Windows computers can.


## OpenAPI

````yaml GET /computers/{id}/public-urls
openapi: 3.1.0
info:
  title: Orgo API
  description: >-
    Launch cloud computers that AI agents can control and interact with. Create
    workspaces, provision computers, and control them programmatically.
  version: 2.0.0
  contact:
    name: Orgo Support
    email: contact@orgo.ai
    url: https://orgo.ai
servers:
  - url: https://www.orgo.ai/api
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Support
    description: >-
      Orgo’s support agent, for programs: ask how to do something in Orgo and
      get an answer with full URLs and copyable commands.
  - name: Account
    description: >-
      Account capacity: how many computers an account may run, and adding or
      giving back more.
  - name: Agent accounts
    description: >-
      Accounts an AI agent makes for itself, and the claim link a person uses to
      take one over.
  - name: Clients
    description: >-
      Run Orgo for your clients from your own app: a workspace and scoped key
      each, billed to you or to them.
  - name: Workspaces
    description: Organize computers into named workspaces
  - name: Computers
    description: Provision and manage virtual computers
  - name: Public URLs
    description: Share an app running on a computer at an https address on orgo.dev.
  - name: Computer Lifecycle
    description: Start, stop, and restart computers
  - name: Computer Actions
    description: Control mouse, keyboard, and execute commands
  - name: Screens
    description: >-
      More than one desktop on a single computer. Each screen is its own X
      server with its own cursor and window manager, so an agent working on one
      cannot disturb another.
  - name: Files
    description: Upload and download files
  - name: Templates
    description: Author, build, and launch reproducible computers from templates
  - name: Chat
    description: Run an agent on a computer through OpenAI-compatible chat completions.
  - name: Workflows
    description: >-
      Routines that run the same way every time: a start, then steps. Make them
      from plain words or lines, check them, run them and follow their runs (in
      preview).
paths:
  /computers/{id}/public-urls:
    get:
      tags:
        - Public URLs
      summary: List public URLs
      description: >-
        Returns the computer's public URLs and how many it can have. Answers
        `enabled: false` with an empty list when public URLs are off for your
        account or the computer cannot have them (only Linux and Windows
        computers can). Needs the **Computers** read permission.
      operationId: listPublicUrls
      parameters:
        - name: id
          in: path
          required: true
          description: Computer ID. Accepts the computer's UUID or its `instance_id`.
          schema:
            type: string
      responses:
        '200':
          description: The computer's public URLs.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicUrlList'
              example:
                enabled: true
                base_domain: orgo.dev
                limit: 10
                account_limit: 10
                account_used: 3
                public_urls:
                  - id: 6f1c2a7e-3b9d-4c1a-9e2f-0a1b2c3d4e5f
                    url: https://cool-thing-x7k2.orgo.dev
                    hostname: cool-thing-x7k2.orgo.dev
                    label: cool-thing-x7k2
                    port: 3000
                    created_at: '2026-10-05T18:00:00.000Z'
                    protected: false
        '401':
          description: Missing or invalid API key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: No access to this computer, or view-only access.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Computer not found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    PublicUrlList:
      type: object
      required:
        - enabled
        - public_urls
      properties:
        enabled:
          type: boolean
          description: >-
            `false` when public URLs are off for your account or this computer
            cannot have them.
        reason:
          type: string
          description: Why `enabled` is `false`, when the computer is the reason.
        base_domain:
          type: string
          example: orgo.dev
        limit:
          type: integer
          description: Most public URLs this computer can have. Negative means no limit.
        account_limit:
          type: integer
          description: >-
            Most public URLs the workspace owner can have across all their
            computers. Negative means no limit.
        account_used:
          type: integer
          description: How many the workspace owner has.
        public_urls:
          type: array
          items:
            $ref: '#/components/schemas/PublicUrl'
    Error:
      type: object
      description: >-
        The base error body. Every failure carries `error`; individual endpoints
        add the fields named in the schemas below.
      required:
        - error
      properties:
        error:
          type: string
          description: Human-readable message.
          example: Access denied
        code:
          type: string
          description: >-
            Machine-readable reason. Present on the failures that define one,
            absent otherwise.
    PublicUrl:
      type: object
      required:
        - id
        - url
        - hostname
        - label
        - port
        - created_at
        - protected
      properties:
        id:
          type: string
          format: uuid
        url:
          type: string
          format: uri
          description: The address to share.
          example: https://cool-thing-x7k2.orgo.dev
        hostname:
          type: string
          example: cool-thing-x7k2.orgo.dev
        label:
          type: string
          description: The part of the hostname before the base domain.
          example: cool-thing-x7k2
        port:
          type: integer
          minimum: 1
          maximum: 65535
          description: The port on the computer the URL serves.
        created_at:
          type: string
          format: date-time
        protected:
          type: boolean
          description: '`true` when visitors must enter a password first.'
        disabled:
          type: boolean
          description: >-
            Present and `true` only when Orgo support turned the URL off. It is
            not served and cannot be changed or removed.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: API key authentication. Get your key at orgo.ai/workspaces

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.