ORorgo
domains

A workspace’s domains: its free names and the domains it bought through Orgo

Changed on

Answers { enabled: false, ... } where domains are not enabled for the account. free_names are the workspace’s public URLs (names under Orgo’s domain), with the workspace owner’s cap across all their computers (limit, negative for none; used). domains are the domains the workspace bought, each with pointed: the names on it that serve a computer, and its renewal. can_buy is whether this caller may buy here (write access, with a session or an account-wide key). renewals_enabled is whether renewals run here at all (Renew now, POST .../domains/{domainId}/renew, included). last_contact is the registrant this caller bought with last, to fill in the next purchase (null for a workspace-scoped key). A purchase the registry has not confirmed yet (pending) is checked again here, up to 3 a request. Any member may read it, with a session, an account-wide key or a key for this workspace.

get/api/projects/{id}/domains

Request

  • Base URL
    https://www.orgo.ai
  • Auth
    HTTP bearer

Path parameters

idstring uuid required

Workspace id.

Response

The domains.

enabledboolean required

False where domains are not enabled for the account; everything else is then empty.

registrarboolean required

Domains can be searched and bought here.

can_buyboolean required

This caller may buy for this workspace (write access, a session or an account-wide key).

renewals_enabledboolean required

Renewals run in this environment, Renew now (POST /api/projects/{id}/domains/{domainId}/renew) included. Where they don’t, a domain expires at expires_at whatever auto_renew says.

Example response

{
  "free_names": {
    "base_domain": "orgo.dev",
    "names": [
      {
        "url": "https://cool-thing-x7k2.orgo.dev",
        "hostname": "cool-thing-x7k2.orgo.dev",
        "label": "cool-thing-x7k2"
      }
    ]
  },
  "domains": [
    {
      "id": "5c1e2d3f-4a5b-4c6d-8e7f-9a0b1c2d3e4f",
      "domain": "orgo.agency",
      "status": "active",
      "expires_at": "2027-10-21T18:00:00.000Z",
      "created_at": "2026-10-21T18:00:00.000Z",
      "auto_renew": true,
      "renewal_cents": 2099,
      "renewal_years": 1,
      "renewal_paid_by": "you",
      "renewal_state": "scheduled",
      "renewal_error": null,
      "pointed": [
        {
          "domain": "app.orgo.agency",
          "computer_id": "6f1c2a7e-3b9d-4c1a-9e2f-0a1b2c3d4e5f",
          "computer_name": "web-1",
          "status": "active"
        }
      ]
    }
  ],
  "last_contact": {
    "phone": "+1.4155550123",
    "country": "US"
  }
}

Changes

  • 60e768a2bb9dRevision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

  • 8a1b0f4a5fd8Revision changes
    • info

      added the required property /////// to the response with the status