Middle-earth API

Bear a ring

PUT/rings/{ring_id}/bearer

Assigns a bearer to a ring.

Request

Path parameters

  • ring_id string Required

    The ring's identifier.

Bodyapplication/json

  • bearer_id string Required

    The new bearer.

  • willing boolean conditional

    Whether the bearer takes the ring willingly.

    Set to true when the bearer accepts the ring of their own free will. Required for rings of kind elven; ignored for others.

    Defaultfalse

Example request

cURL
curl -X PUT 'https://api.middle-earth.example/v3/rings/<ring_id>/bearer' \
  -H 'Content-Type: application/json' \
  -d '{
  "bearer_id": "string",
  "willing": false
}'

Response

The updated ring.

Body

  • id string Required

    Unique identifier.

  • kind string <RingKind> Required

    The kind of ring.

    Allowed valueselvendwarvenhumanone

  • metal string <Metal> Required

    Metal the ring is made from.

    Allowed valuesgoldsilvermithriliron

  • status string Required

    Where the ring is right now.

    Allowed valuesforgedwornlostdestroyed

  • bearer_id string

    null while the ring is unworn or lost.

  • inscription object <Inscription>

    Text inscribed on the ring.

  • corruption_level integer

    A value from 0 to 100 that grows each day a ring is worn. The One Ring starts at 60.

  • forged_at string date-time

    When the ring was forged.

Example response

application/json

Json
{
  "id": "string",
  "kind": "elven",
  "metal": "gold",
  "status": "forged",
  "bearer_id": "string",
  "inscription": {
    "text": "string",
    "language": "black_speech",
    "visible_when_heated": false
  },
  "corruption_level": 0,
  "forged_at": "2024-01-01T00:00:00Z"
}