domains

Turn a bought domain’s auto-renew on or off

Changed on

Body: { "auto_renew": true | false }. Auto-renew is on when a domain is bought (off when it is adopted from another environment). Orgo renews the domain in its last 14 days, from the payer’s Orgo credits, and emails the payer 30 days before with the day the price is taken and the price. Turning it on (even when it is on) makes you the payer from the next renewal on, and clears a no_payer or insufficient_credits renewal_error so the next daily run tries again; a renewal already held stays with its payer. Turning it off gives back any credits held for a renewal not yet sent; one already sent to the registry finishes, and the answer says renewal_state "renewing". Off, the domain expires at expires_at and may become available to others. Write access, with a session or an account-wide key: a workspace-scoped key gets 403 ACCOUNT_KEY_REQUIRED, since turning it on spends your credits.

patch/api/projects/{id}/domains/{domainId}

Request

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

Path parameters

idstring uuid required

Workspace id.

domainIdstring uuid required

A domain bought through Orgo: its id in GET /api/projects/{id}/domains.

Request body

auto_renewboolean required

Response

{ domain }

Example response

{
  "domain": {
    "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"
      }
    ]
  }
}

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

    • 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

    • 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

    • 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

    • info

      added the non-success response with the status