domains

Renew a bought domain now

Changed on

Renews the domain for its term (renewal_years) at once, from 30 days before it expires (409 RENEWAL_NOT_DUE before that, with the date). The price (renewal_cents) always comes from your own Orgo credits: credits another member has held for this renewal go back to them first. Send expected_price_cents, the price you were shown: another price answers 409 PRICE_CHANGED with price_cents and charges nothing. Auto-renew need not be on. 200 with the domain, its expires_at moved on. A try that fails leaves nothing behind: when the registry refuses, your credits are given back (502 RENEWAL_FAILED), and neither that nor short credits change when auto-renew tries next. When its answer is lost, the domain shows renewing until the registry confirms (502 RENEWAL_UNKNOWN); nothing is ever charged twice. An expired domain is not renewed here (409 DOMAIN_EXPIRED). Write access, with a session or an account-wide key; 5 an hour per person; one at a time per domain.

post/api/projects/{id}/domains/{domainId}/renew

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

expected_price_centsinteger

The renewal_cents you were shown.

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 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

      endpoint added