Player relationships API

Talo's player relationships API is the easiest way to build friends lists, follower systems, party invites and other social features that need player-to-player connections.

Endpoints

---

List subscriptions from players who have subscribed to the current player

read:playerRelationships

GET https://api.trytalo.com/v1/players/relationships/subscribers

Headers

Key	Required	Description
x-talo-alias	❌ No	The ID of the player's alias

Route params

None available

Query keys

Key	Required	Description
aliasId	❌ No	Filter by a specific subscriber alias ID
confirmed	❌ No	Filter by confirmation status (true or false)
page	❌ No	Page number for pagination (default: 0)
relationshipType	❌ No	Filter by relationship type (unidirectional or bidirectional)

Sample response

{ ... }

---

List subscriptions where the current player is the subscriber

read:playerRelationships

GET https://api.trytalo.com/v1/players/relationships/subscriptions

Headers

Key	Required	Description
x-talo-alias	❌ No	The ID of the player's alias

Route params

None available

Query keys

Key	Required	Description
aliasId	❌ No	Filter by a specific subscribed-to alias ID
confirmed	❌ No	Filter by confirmation status (true or false)
page	❌ No	Page number for pagination (default: 0)
relationshipType	❌ No	Filter by relationship type (unidirectional or bidirectional)

Sample response

{ ... }

---

Create a subscription request to another player

write:playerRelationships

POST https://api.trytalo.com/v1/players/relationships

Headers

Key	Required	Description
x-talo-alias	❌ No	The ID of the player's alias

Route params

None available

Query keys

None available

Body keys

Key	Required	Description
aliasId	✅ Yes	The ID of the player alias to subscribe to
relationshipType	✅ Yes	The type of relationship: "unidirectional" or "bidirectional"

Sample request

{ ... }

Sample response

{ ... }

---

Confirm a pending subscription request

write:playerRelationships

PUT https://api.trytalo.com/v1/players/relationships/:id/confirm

Headers

Key	Required	Description
x-talo-alias	❌ No	The ID of the player's alias

Route params

Key	Required	Description
id	✅ Yes	The ID of the subscription request to confirm

Query keys

None available

Body keys

None available

Sample response

{ ... }

---

Delete a subscription (unsubscribe from a player)

write:playerRelationships

DELETE https://api.trytalo.com/v1/players/relationships/:id

Headers

Key	Required	Description
x-talo-alias	❌ No	The ID of the player's alias

Route params

Key	Required	Description
id	✅ Yes	The ID of the subscription to delete

Query keys

None available

Body keys

None available

---