Extend a hold

Take the one extension this hold is allowed. The window extends from where it was going to end, not from now. A second attempt refuses with `hold_code` `ALREADY_EXTENDED`.

POST/api/v1/holds/{id}/extend

Take the one extension this hold is allowed. The window extends from where it was going to end, not from now. A second attempt refuses with `hold_code` `ALREADY_EXTENDED`.

Authorizations

Authorizationstringheaderrequired

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

Path parameters

idstringrequired

Responses

The extended hold.

holdobjectrequired

holdsobjectrequired

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

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

import requests

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

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

{
  "hold": {
    "can_extend": true,
    "expires_at": "2023-11-07T05:31:56Z",
    "extend_hours": 123,
    "held_at": "2023-11-07T05:31:56Z",
    "id": "<string>",
    "listing_id": "<string>"
  },
  "holds": {
    "active": 123,
    "hold_hours": 123,
    "limit": 123,
    "plan": "<string>"
  }
}

{
  "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"
  }
}