Retry failed domain registration

POST /api/v2/domains/{id}/actions/retry-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.

A 422 recovery response is cumulative: errors identifies only the fields still blocking this attempt, while recovery.fields and recovery.suggestedBody preserve the complete form and previously supplied values.

The action is idempotent after completion: replaying it for an already-active domain returns a completed 200 result without submitting another registry operation.

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

Authenticate with an API key in the Authorization: Bearer <token> header.

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

Authorization Bearer <token>

Accept application/json

Content-Type application/json

Body

optional

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. 5 fields

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. 10 fields

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. 10 fields

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. 10 fields

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. 10 fields

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

409 The domain is not waiting for registration, or another registration retry is still in progress. No body

No response body

422 Registration details are required before retrying. No body

No response body

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

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. 10 fields

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