End a hold

End a hold taken by ANY key on this account — holds are account-scoped, not key-scoped. `released` gives the listing back; `registered` records that you registered the name yourself, which triggers an availability re-check and retires the listing if it now resolves. Either way the listing is available to other accounts immediately, and you cannot hold that same listing again for 30 days. `expired` is not accepted — that outcome belongs to the clock.

DELETE/api/v1/holds/{id}

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path parameters

idstringrequired

Request body

outcome"released" | "registered"default: released

Available options: released, registered

Responses

The hold has ended.

ended_atstring (date-time)required

holdsobjectrequired

outcome"released" | "registered"required

Available options: released, registered

registration"available" | "taken" | "unknown" | null

Only on a `registered` release: what the re-check found. `taken` means the name now resolves; `unknown` means no answer, which is not the same as available.

Available options: available, taken, unknown, null

curl --request DELETE \
  --url "https://getrevised.com/api/v1/holds/ID" \
  --header "Authorization: Bearer YOUR_API_KEY"

const res = await fetch("https://getrevised.com/api/v1/holds/ID", {
  method: "DELETE",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY"
  },
});
const data = await res.json();

import requests

headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}

r = requests.delete("https://getrevised.com/api/v1/holds/ID", headers=headers)
r.raise_for_status()
data = r.json()

{
  "ended_at": "2023-11-07T05:31:56Z",
  "holds": {
    "active": 123,
    "hold_hours": 123,
    "limit": 123,
    "plan": "<string>"
  },
  "outcome": "released",
  "registration": "available"
}

{
  "error": {
    "available_at": "2023-11-07T05:31:56Z",
    "code": "forbidden",
    "expires_at": "2023-11-07T05:31:56Z",
    "hold_code": "ALREADY_EXTENDED",
    "limit": 123,
    "message": "<string>",
    "resets_at": "2023-11-07T05:31:56Z",
    "reveal_code": "FEATURED_REQUIRES_PRO"
  }
}

{
  "error": {
    "available_at": "2023-11-07T05:31:56Z",
    "code": "forbidden",
    "expires_at": "2023-11-07T05:31:56Z",
    "hold_code": "ALREADY_EXTENDED",
    "limit": 123,
    "message": "<string>",
    "resets_at": "2023-11-07T05:31:56Z",
    "reveal_code": "FEATURED_REQUIRES_PRO"
  }
}

{
  "error": {
    "available_at": "2023-11-07T05:31:56Z",
    "code": "forbidden",
    "expires_at": "2023-11-07T05:31:56Z",
    "hold_code": "ALREADY_EXTENDED",
    "limit": 123,
    "message": "<string>",
    "resets_at": "2023-11-07T05:31:56Z",
    "reveal_code": "FEATURED_REQUIRES_PRO"
  }
}

{
  "error": {
    "available_at": "2023-11-07T05:31:56Z",
    "code": "forbidden",
    "expires_at": "2023-11-07T05:31:56Z",
    "hold_code": "ALREADY_EXTENDED",
    "limit": 123,
    "message": "<string>",
    "resets_at": "2023-11-07T05:31:56Z",
    "reveal_code": "FEATURED_REQUIRES_PRO"
  }
}

{
  "error": {
    "available_at": "2023-11-07T05:31:56Z",
    "code": "forbidden",
    "expires_at": "2023-11-07T05:31:56Z",
    "hold_code": "ALREADY_EXTENDED",
    "limit": 123,
    "message": "<string>",
    "resets_at": "2023-11-07T05:31:56Z",
    "reveal_code": "FEATURED_REQUIRES_PRO"
  }
}

{
  "error": {
    "available_at": "2023-11-07T05:31:56Z",
    "code": "forbidden",
    "expires_at": "2023-11-07T05:31:56Z",
    "hold_code": "ALREADY_EXTENDED",
    "limit": 123,
    "message": "<string>",
    "resets_at": "2023-11-07T05:31:56Z",
    "reveal_code": "FEATURED_REQUIRES_PRO"
  }
}