Talent

POST/api/v1/talent/curves

List_definitions

Authorization

bearer_token

AuthorizationBearer <token>

In: header

Conditions as filter[][]=. Conditions on different fields all apply. in (any of) and all (every one of, on fields holding several values) take a comma-separated list (\, for a literal comma). exists takes true or false. Datetimes are RFC 3339, now, or a time before now such as -30m, -6h or -7d.

q?string

Full-text search over this list's searchable fields.

Length1 <= length <= 200

sort?string

Comma-separated sort keys, - for descending, at most 1. Keys: version, name, created_at. Default: -created_at.

limit?integer

Rows per page, 1 to 100 (default 25).

Range1 <= value <= 100

cursor?string

The page.next_cursor of the previous page. Cannot be combined with page.

page?integer

A 1-based page number, for jumping. Cannot be combined with cursor.

Range1 <= value

total?boolean

Set to true to include the number of matching rows in page.total.

active_only?boolean

Only return active (latest published) versions

Response Body

`application/json`

curl -X GET "https://example.com/api/v1/talent/definitions"

{  "page": {    "has_more": true,    "next_cursor": "string",    "page": 0,    "total": 0  },  "trees": [    {      "active": true,      "created_at": "2019-08-24T14:15:22Z",      "created_by": "string",      "definition_id": "string",      "description": "string",      "exclusive_groups": [        {          "id": "string",          "label": "string",          "max_selected": 0        }      ],      "name": "string",      "nodes": [        {          "cost_per_rank": [            {              "amount": 0,              "currency": "string"            }          ],          "exclusive_group": "string",          "grants": null,          "id": "string",          "max_rank": 0,          "name": "string",          "prerequisites": null,          "tier": 0        }      ],      "point_currencies": [        "string"      ],      "respec": {        "full": null,        "partial": null      },      "tiers": [        {          "gate": null,          "tier": 0        }      ],      "tree_id": "string",      "updated_at": "2019-08-24T14:15:22Z",      "version": 0    }  ]}

POST/api/v1/talent/definitions

Create_definition

Authorization

bearer_token

AuthorizationBearer <token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

description?|

Optional description

exclusive_groups?array<>

Exclusive group declarations

name*string

Human-facing tree name

nodes*array<>

Talent nodes

point_currencies*array<string>

Point currencies this tree spends

respec?

Respec policy

tiers*array<>

Tier definitions with optional gates

tree_id*string

Stable identifier for the tree (e.g. "tree_pyromancer")

version?|

Tree version (defaults to 1)

Formatint32

Range0 <= value

Response Body

`application/json`

curl -X POST "https://example.com/api/v1/talent/definitions" \  -H "Content-Type: application/json" \  -d '{    "name": "string",    "nodes": [      {        "id": "string",        "name": "string",        "tier": 0      }    ],    "point_currencies": [      "string"    ],    "tiers": [      {        "tier": 0      }    ],    "tree_id": "string"  }'

{  "active": true,  "created_at": "2019-08-24T14:15:22Z",  "created_by": "string",  "definition_id": "string",  "description": "string",  "exclusive_groups": [    {      "id": "string",      "label": "string",      "max_selected": 0    }  ],  "name": "string",  "nodes": [    {      "cost_per_rank": [        {          "amount": 0,          "currency": "string"        }      ],      "exclusive_group": "string",      "grants": null,      "id": "string",      "max_rank": 0,      "name": "string",      "prerequisites": null,      "tier": 0    }  ],  "point_currencies": [    "string"  ],  "respec": {    "full": null,    "partial": null  },  "tiers": [    {      "gate": null,      "tier": 0    }  ],  "tree_id": "string",  "updated_at": "2019-08-24T14:15:22Z",  "version": 0}

POST/api/v1/talent/definitions/validate

Validate_definition

Authorization

bearer_token

AuthorizationBearer <token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

description?|

Optional description

exclusive_groups?array<>

Exclusive group declarations

name*string

Human-facing tree name

nodes*array<>

Talent nodes

point_currencies*array<string>

Point currencies this tree spends

respec?

Respec policy

tiers*array<>

Tier definitions with optional gates

tree_id*string

Stable identifier for the tree

Response Body

`application/json`

curl -X POST "https://example.com/api/v1/talent/definitions/validate" \  -H "Content-Type: application/json" \  -d '{    "name": "string",    "nodes": [      {        "id": "string",        "name": "string",        "tier": 0      }    ],    "point_currencies": [      "string"    ],    "tiers": [      {        "tier": 0      }    ],    "tree_id": "string"  }'

{  "issues": [    "string"  ],  "valid": true}

GET/api/v1/talent/definitions/{tree_id}

Get_definition

Authorization

bearer_token

AuthorizationBearer <token>

In: header

Path Parameters

tree_id*string

Response Body

`application/json`

curl -X GET "https://example.com/api/v1/talent/definitions/string"

{  "active": true,  "created_at": "2019-08-24T14:15:22Z",  "created_by": "string",  "definition_id": "string",  "description": "string",  "exclusive_groups": [    {      "id": "string",      "label": "string",      "max_selected": 0    }  ],  "name": "string",  "nodes": [    {      "cost_per_rank": [        {          "amount": 0,          "currency": "string"        }      ],      "exclusive_group": "string",      "grants": null,      "id": "string",      "max_rank": 0,      "name": "string",      "prerequisites": null,      "tier": 0    }  ],  "point_currencies": [    "string"  ],  "respec": {    "full": null,    "partial": null  },  "tiers": [    {      "gate": null,      "tier": 0    }  ],  "tree_id": "string",  "updated_at": "2019-08-24T14:15:22Z",  "version": 0}

PUT/api/v1/talent/definitions/{tree_id}

Publish_version

Authorization

bearer_token

AuthorizationBearer <token>

In: header

Path Parameters

tree_id*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

description?|

Optional description

exclusive_groups?array<>

Exclusive group declarations

migration*

Declarative migration plan from the prior version

name*string

Human-facing tree name

nodes*array<>

Talent nodes

point_currencies*array<string>

Point currencies this tree spends

respec?

Respec policy

tiers*array<>

Tier definitions with optional gates

tree_id*string

Stable identifier for the tree

version?|

New version (defaults to migration.from_version + 1)

Formatint32

Range0 <= value

Response Body

`application/json`

curl -X PUT "https://example.com/api/v1/talent/definitions/string" \  -H "Content-Type: application/json" \  -d '{    "migration": {      "from_version": 0    },    "name": "string",    "nodes": [      {        "id": "string",        "name": "string",        "tier": 0      }    ],    "point_currencies": [      "string"    ],    "tiers": [      {        "tier": 0      }    ],    "tree_id": "string"  }'

{  "active": true,  "created_at": "2019-08-24T14:15:22Z",  "created_by": "string",  "definition_id": "string",  "description": "string",  "exclusive_groups": [    {      "id": "string",      "label": "string",      "max_selected": 0    }  ],  "name": "string",  "nodes": [    {      "cost_per_rank": [        {          "amount": 0,          "currency": "string"        }      ],      "exclusive_group": "string",      "grants": null,      "id": "string",      "max_rank": 0,      "name": "string",      "prerequisites": null,      "tier": 0    }  ],  "point_currencies": [    "string"  ],  "respec": {    "full": null,    "partial": null  },  "tiers": [    {      "gate": null,      "tier": 0    }  ],  "tree_id": "string",  "updated_at": "2019-08-24T14:15:22Z",  "version": 0}

DELETE/api/v1/talent/definitions/{tree_id}/versions/{version}

Delete_definition

Authorization

bearer_token

AuthorizationBearer <token>

In: header

Path Parameters

tree_id*string

version*integer

Formatint32

Range0 <= value

Response Body

`application/json`

curl -X DELETE "https://example.com/api/v1/talent/definitions/string/versions/0"

{  "message": "string",  "tree_id": "string",  "version": 0}

GET/api/v1/talent/me/wallet

Get_wallet

Authorization

bearer_token

AuthorizationBearer <token>

In: header

Response Body

`application/json`

curl -X GET "https://example.com/api/v1/talent/me/wallet"

{  "balances": {    "property1": 0,    "property2": 0  },  "user_id": "string",  "xp": [    {      "current_level": 0,      "curve_id": "string",      "total_xp": 0    }  ]}

POST/api/v1/talent/xp/events

Ingest_xp

Authorization

bearer_token

AuthorizationBearer <token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

amount*integer

Experience amount earned

Formatint64

Range0 <= value

curve_id*string

Curve used to convert experience into points

idempotency_key?|

Optional idempotency key to make ingestion safe to retry

source?|

Optional source label (e.g. "quest:quest_forge_apprentice")

Response Body

`application/json`

curl -X POST "https://example.com/api/v1/talent/xp/events" \  -H "Content-Type: application/json" \  -d '{    "amount": 0,    "curve_id": "string"  }'

{  "granted": {    "property1": 0,    "property2": 0  },  "idempotent": true,  "new_level": 0,  "old_level": 0}

POST/api/v1/talent/{tree_id}/allocate

Allocate

Authorization

bearer_token

AuthorizationBearer <token>

In: header

Path Parameters

tree_id*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

idempotency_key?|

Optional idempotency key

node_id*string

Node to allocate ranks into

ranks?integer

Number of ranks to allocate

Formatint32

Range0 <= value

Response Body

`application/json`

curl -X POST "https://example.com/api/v1/talent/string/allocate" \  -H "Content-Type: application/json" \  -d '{    "node_id": "string"  }'

{  "exclusive_selections": {    "property1": "string",    "property2": "string"  },  "highest_tier_unlocked": 0,  "points_spent": {    "property1": 0,    "property2": 0  },  "ranks": {    "property1": 0,    "property2": 0  },  "tree_id": "string",  "tree_version": 0,  "user_id": "string"}

GET/api/v1/talent/{tree_id}/analytics/archetypes

Archetype_analytics

Authorization

bearer_token

AuthorizationBearer <token>

In: header

Path Parameters

tree_id*string

Response Body

`application/json`

curl -X GET "https://example.com/api/v1/talent/string/analytics/archetypes"

{  "archetypes": [    {      "population": 0,      "selections": [        {          "group": "string",          "node_id": "string"        }      ],      "share": 0.1,      "signature": "string"    }  ],  "total_population": 0,  "tree_id": "string",  "tree_version": 0}

GET/api/v1/talent/{tree_id}/analytics/paths

Path_analytics

Authorization

bearer_token

AuthorizationBearer <token>

In: header

Path Parameters

tree_id*string

Response Body

`application/json`

curl -X GET "https://example.com/api/v1/talent/string/analytics/paths"

{  "nodes": [    {      "name": "string",      "node_id": "string",      "tier": 0,      "total_ranks_allocated": 0    }  ],  "tree_id": "string"}

POST/api/v1/talent/{tree_id}/respec

Respec

Authorization

bearer_token

AuthorizationBearer <token>

In: header

Path Parameters

tree_id*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

full?boolean

When true, perform a full respec (clears all ranks)

node_id?|

Node to partially respec (required when full is false)

ranks?integer

Ranks to remove during a partial respec

Formatint32

Range0 <= value

Response Body

`application/json`

curl -X POST "https://example.com/api/v1/talent/string/respec" \  -H "Content-Type: application/json" \  -d '{}'

{  "exclusive_selections": {    "property1": "string",    "property2": "string"  },  "highest_tier_unlocked": 0,  "points_spent": {    "property1": 0,    "property2": 0  },  "ranks": {    "property1": 0,    "property2": 0  },  "tree_id": "string",  "tree_version": 0,  "user_id": "string"}

GET/api/v1/talent/{tree_id}/state

Get_state

Authorization

bearer_token

AuthorizationBearer <token>

In: header

Path Parameters

tree_id*string

Response Body

`application/json`

curl -X GET "https://example.com/api/v1/talent/string/state"

{  "nodes": [    {      "affordable": true,      "current_rank": 0,      "excluded_by": "string",      "max_rank": 0,      "node_id": "string",      "prerequisites_met": true,      "tier_locked": true    }  ],  "state": {    "exclusive_selections": {      "property1": "string",      "property2": "string"    },    "highest_tier_unlocked": 0,    "points_spent": {      "property1": 0,      "property2": 0    },    "ranks": {      "property1": 0,      "property2": 0    },    "tree_id": "string",    "tree_version": 0,    "user_id": "string"  },  "tree_id": "string",  "tree_version": 0}

GET/api/v1/talent/{tree_id}/users/{user_id}/state

Get_user_state

Authorization

bearer_token

AuthorizationBearer <token>

In: header

Path Parameters

tree_id*string

user_id*string

Response Body

`application/json`

curl -X GET "https://example.com/api/v1/talent/string/users/string/state"

{  "nodes": [    {      "affordable": true,      "current_rank": 0,      "excluded_by": "string",      "max_rank": 0,      "node_id": "string",      "prerequisites_met": true,      "tier_locked": true    }  ],  "state": {    "exclusive_selections": {      "property1": "string",      "property2": "string"    },    "highest_tier_unlocked": 0,    "points_spent": {      "property1": 0,      "property2": 0    },    "ranks": {      "property1": 0,      "property2": 0    },    "tree_id": "string",    "tree_version": 0,    "user_id": "string"  },  "tree_id": "string",  "tree_version": 0}

Talent

201application/json

400

403

409

200application/json

404

200application/json

400

201application/json

400

403

409

200application/json

403

200application/json

404

201application/json

400

403

404

200application/json

403

404

200application/json

200application/json

400

404

200application/json

400

404

409

200application/json

403

404

200application/json

403

404

200application/json

400

404

409

200application/json

404

200application/json

403

404

On this page

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`