Changes the status or destination of the fellowship's current quest.
Request
Path parameters
fellowship_id string Required
The fellowship's identifier.
Bodyapplication/json
status string
Allowed valuestravellingsplitdisbandedvictorious
reason string
Required when status is present
curl -X PATCH 'https://api.middle-earth.example/v3/fellowships/<fellowship_id>/quest' \
-H 'Content-Type: application/json' \
-d '{
"status": "travelling",
"destination": "string",
"reason": "string"
}'
Response
The updated fellowship.
Body
members array of objects <Member> Required
members.id string Required
members.name string Required
members.race string <Race> Required
Allowed valueshobbitelfdwarfmanwizard
members.status string Required
Changes automatically as the fellowship travels. Use Update a quest to change a quest instead.
Allowed valuesactivewoundedfallenabandoned
members.skills array of strings
Free-form skill tags, for example stealth, swordsmanship or riddles. Used when matching members to quests.
members.home object <Region>
A place in Middle-earth. Regions nest, so the Shire can sit inside Eriador.
members.home.name string Required
members.home.settlement string
Optional settlement within the region.
members.home.parent object <Region>
The enclosing region. A region may nest to any depth, for example the Shire inside Eriador.
Defined above at members.home
members.traits oneOf
Traits specific to the member's race.
members.traits.kind string Required
members.traits.second_breakfasts integer
Meals taken per day beyond breakfast.
members.traits.pipe_weed_brand string
Preferred brand of pipe-weed.
members.created_at string date-time
When the record was created.
quest object <Quest> Required
quest.title string Required
What the fellowship is trying to do.
quest.destination string Required
quest.deadline_days integer
Days allowed to complete the quest.
Default365
status string
Current state of the fellowship.
Allowed valuesformingtravellingsplitdisbandedvictorious
application/json
{
"id": "string",
"name": "string",
"members": [
{
"id": "string",
"name": "string",
"race": "hobbit",
"status": "active",
"skills": [
"string"
],
"home": {
"name": "string",
"settlement": "string",
"parent": null
},
"traits": {
"kind": "hobbit",
"second_breakfasts": 0,
"pipe_weed_brand": "string"
},
"created_at": "2024-01-01T00:00:00Z"
}
],
"quest": {
"title": "string",
"destination": "string",
"deadline_days": 365
},
"status": "forming"
}
