Retry failed domain registration

Retry a failed pending registration. Send an empty body for plain retries, send recoveryValues for extension-specific details, or send profileUpdated: true after updating profile-targeted fields in account settings. Successful responses are wrapperless; validation, ownership, payment, and state failures use Problem Details. When a background status-sync job is queued, the optional operation object contains a public job ID and poll URL; refresh the domain after that job completes instead of immediately reloading stale local state.

Domains & DNS Domains

Authentication

Required API scope: write:domains

Use Authorization: Bearer <token> for API keys. Dashboard sessions may also use hostup_session.

Context

Related endpoints

POST /api/v2/domains/{id}/actions/renew Renew a domain POST /api/v2/domains/{id}/actions/update-epp Save EPP code for transfer POST /api/v2/domains/{id}/actions/request-epp Request an EPP code

Path Parameters

id string required Example: dom_01hxa3b4c5d6e7f8g9h0j1k2m3

Public domain ID. Get it from GET /api/v2/domains `data[].id`. Do not invent this value; use the exact ID returned by the referenced API response.

Headers

Accept Example

Content-Type Example

Body

required

application/json

recoveryValues object

Extension-specific correction values keyed by lifecycle recovery field key. Do not send profile-targeted fields here; update account settings and use profileUpdated instead.

profileUpdated boolean

True after the caller has updated profile-targeted fields in account settings and wants the retry to use freshly fetched account details.

Responses

200 Registration retry outcome.

domainId string required · Example: dom_abc123

registrationStatus string · enum required · Example: submitted

queued

submitted

completed

failed

reason string | null required · Example: Domain registered. Account status sync is still in progress.

outcome object

operation object

Present when a background status-sync job was queued so clients can refresh only after local domain status is up to date.

operation.status string · enum required · Example: in_progress

in_progress

operation.jobId string required · Example: dbj_01hxa3b4c5d6e7f8g9h0j1k2m3

Public job ID. Domain retry status jobs use the `dbj_...` prefix.

operation.pollUrl string required · Example: /api/jobs/dbj_01hxa3b4c5d6e7f8g9h0j1k2m3

400 Invalid request. The response body is an RFC 7807 Problem Details document.

type string · Example: https://developer.hostup.se/errors/invalid_request

title string · Example: Validation failed

status integer · Example: 400

detail string · Example: The request body failed validation.

code string · Example: invalid_request

Stable machine-readable code. Branch on this field, not on `detail`.

instance string · Example: /api/v2/orders

requestId string · Example: req_01hxa3b4c5d6e7f8g9h0j1k2m3

timestamp string · Example: 2026-04-27T12:34:56.000Z

errors array<object>

Field-level validation errors when `code` is `invalid_request`.

errors[].pointer string required · Example: /items/0/eppCode

errors[].detail string required · Example: `eppCode` is required for this transfer.

errors[].code string required · Example: missing_required

extensions object

401 Unauthorized. Authentication is required.

type string · Example: https://developer.hostup.se/errors/invalid_request

title string · Example: Validation failed

status integer · Example: 400

detail string · Example: The request body failed validation.

code string · Example: invalid_request

Stable machine-readable code. Branch on this field, not on `detail`.

instance string · Example: /api/v2/orders

requestId string · Example: req_01hxa3b4c5d6e7f8g9h0j1k2m3

timestamp string · Example: 2026-04-27T12:34:56.000Z

errors array<object>

Field-level validation errors when `code` is `invalid_request`.

errors[].pointer string required · Example: /items/0/eppCode

errors[].detail string required · Example: `eppCode` is required for this transfer.

errors[].code string required · Example: missing_required

extensions object

403 Forbidden. The caller lacks a required scope or does not own the resource.

type string · Example: https://developer.hostup.se/errors/invalid_request

title string · Example: Validation failed

status integer · Example: 400

detail string · Example: The request body failed validation.

code string · Example: invalid_request

Stable machine-readable code. Branch on this field, not on `detail`.

instance string · Example: /api/v2/orders

requestId string · Example: req_01hxa3b4c5d6e7f8g9h0j1k2m3

timestamp string · Example: 2026-04-27T12:34:56.000Z

errors array<object>

Field-level validation errors when `code` is `invalid_request`.

errors[].pointer string required · Example: /items/0/eppCode

errors[].detail string required · Example: `eppCode` is required for this transfer.

errors[].code string required · Example: missing_required

extensions object

404 Not found. The resource does not exist or is not owned by the caller.

type string · Example: https://developer.hostup.se/errors/invalid_request

title string · Example: Validation failed

status integer · Example: 400

detail string · Example: The request body failed validation.

code string · Example: invalid_request

Stable machine-readable code. Branch on this field, not on `detail`.

instance string · Example: /api/v2/orders

requestId string · Example: req_01hxa3b4c5d6e7f8g9h0j1k2m3

timestamp string · Example: 2026-04-27T12:34:56.000Z

errors array<object>

Field-level validation errors when `code` is `invalid_request`.

errors[].pointer string required · Example: /items/0/eppCode

errors[].detail string required · Example: `eppCode` is required for this transfer.

errors[].code string required · Example: missing_required

extensions object

422 Registration details are required before retrying.

No response body

429 Rate limited. Retry after the limit resets. 429 responses include `Retry-After` seconds plus `X-RateLimit-*` headers.

type string · Example: https://developer.hostup.se/errors/invalid_request

title string · Example: Validation failed

status integer · Example: 400

detail string · Example: The request body failed validation.

code string · Example: invalid_request

Stable machine-readable code. Branch on this field, not on `detail`.

instance string · Example: /api/v2/orders

requestId string · Example: req_01hxa3b4c5d6e7f8g9h0j1k2m3

timestamp string · Example: 2026-04-27T12:34:56.000Z

errors array<object>

Field-level validation errors when `code` is `invalid_request`.

errors[].pointer string required · Example: /items/0/eppCode

errors[].detail string required · Example: `eppCode` is required for this transfer.

errors[].code string required · Example: missing_required

extensions object

500 Internal error. Retry later or contact support if the issue persists.

type string · Example: https://developer.hostup.se/errors/invalid_request

title string · Example: Validation failed

status integer · Example: 400

detail string · Example: The request body failed validation.

code string · Example: invalid_request

Stable machine-readable code. Branch on this field, not on `detail`.

instance string · Example: /api/v2/orders

requestId string · Example: req_01hxa3b4c5d6e7f8g9h0j1k2m3

timestamp string · Example: 2026-04-27T12:34:56.000Z

errors array<object>

Field-level validation errors when `code` is `invalid_request`.

errors[].pointer string required · Example: /items/0/eppCode

errors[].detail string required · Example: `eppCode` is required for this transfer.

errors[].code string required · Example: missing_required

extensions object

POST https://cloud.hostup.se/api/v2/domains/{id}/actions/retry-registration

For AI assistants

View as Markdown

Scenario

cURL

curl -X POST "https://cloud.hostup.se/api/v2/domains/dom_01hxa3b4c5d6e7f8g9h0j1k2m3/actions/retry-registration" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Response

{
  "domainId": "dom_abc123",
  "registrationStatus": "submitted",
  "reason": "Domain registered. Account status sync is still in progress.",
  "operation": {
    "status": "in_progress",
    "jobId": "dbj_01hxa3b4c5d6e7f8g9h0j1k2m3",
    "pollUrl": "/api/jobs/dbj_01hxa3b4c5d6e7f8g9h0j1k2m3"
  }
}

{
  "type": "object",
  "properties": {
    "domainId": {
      "type": "string"
    },
    "registrationStatus": {
      "type": "string",
      "enum": [
        "queued",
        "submitted",
        "completed",
        "failed"
      ]
    },
    "reason": {
      "type": "string | null"
    },
    "outcome": {
      "type": "object"
    },
    "operation": {
      "type": "object",
      "description": "Present when a background status-sync job was queued so clients can refresh only after local domain status is up to date.",
      "properties": {
        "status": {
          "type": "string",
          "enum": [
            "in_progress"
          ]
        },
        "jobId": {
          "type": "string",
          "description": "Public job ID. Domain retry status jobs use the `dbj_...` prefix."
        },
        "pollUrl": {
          "type": "string"
        }
      }
    }
  }
}

Request Body Retry without extra details