Paths

Replaces all paths (and their talents) for a tree in a single call. Requires authentication. See Authentication.

Base URL: https://api.reallifetalenttree.com

---

Replace paths

PUT /api/v1/trees/:id/paths
Content-Type: application/json

Replaces the full paths array for the given tree. Send all paths you want to keep — any paths not included are deleted.

Request body:

{
  "paths": [
    {
      "id": "uuid-or-new-id",
      "name": "Frontend",
      "displayOrder": 0,
      "talents": [
        {
          "id": "uuid-or-new-id",
          "name": "React",
          "level": 5,
          "iconUrl": "https://cdn.simpleicons.org/react",
          "description": "Production-grade React including concurrent features.",
          "displayOrder": 0
        }
      ]
    }
  ]
}

Field reference:

Field	Type	Required	Description
paths[].id	string	Yes	UUID. Use a new UUID for new paths.
paths[].name	string	Yes	Display name of the path (e.g. "Frontend").
paths[].displayOrder	number	Yes	Zero-based render order.
paths[].talents[].id	string	Yes	UUID. Use a new UUID for new talents.
paths[].talents[].name	string	Yes	Talent display name.
paths[].talents[].level	1|2|3|4|5	Yes	Proficiency level.
paths[].talents[].iconUrl	string	No	URL to an icon image.
paths[].talents[].description	string	No	Popup body text.
paths[].talents[].displayOrder	number	Yes	Zero-based render order within the path.

Response: The updated TalentTree object (including the new paths) wrapped in { data, meta }.

curl:

curl -X PUT https://api.reallifetalenttree.com/api/v1/trees/TREE_ID/paths \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "paths": [{
      "id": "00000000-0000-0000-0000-000000000001",
      "name": "Frontend",
      "displayOrder": 0,
      "talents": [{
        "id": "00000000-0000-0000-0000-000000000002",
        "name": "React",
        "level": 5,
        "displayOrder": 0
      }]
    }]
  }'