Skill builds are community-shareable ability loadouts. Each build stores the chosen hero, attribute, abilities, a title, description, and tags. Votes and favorites are tracked per Steam ID.
All POST endpoints require the Auth-Key header. See Server API Overview for authentication details.
POST /createSkillBuild Persists a new skill build to the database. Votes are initialised to zero and a Created timestamp is set automatically.
Request POST /createSkillBuild Auth-Key : <LodAuthKey> Content-Type : application/x-www-form-urlencoded data={ ... }
JSON-encoded skill build object. 64-bit Steam ID of the build author.
Internal hero name (e.g. npc_dota_hero_pudge).
Primary attribute: strength, agility, or intelligence.
Array of ability names included in the build.
Human-readable name for the build.
Optional longer description of the build.
Optional array of tag strings for filtering.
Example request body { "steamID" : "76561197966504115" , "heroName" : "npc_dota_hero_pudge" , "attribute" : "strength" , "abilities" : [ "pudge_meat_hook" , "pudge_rot" , "pudge_flesh_heap" , "pudge_dismember" ], "title" : "Classic Pudge" , "description" : "Standard hook-and-rot build." , "tags" : [ "hook" , "sustain" ] }
Response true if the build was created successfully.
Error message string. Empty on success.
{ "success" : true , "error" : "" }
POST /removeSkillBuild Deletes a skill build by ID. All UserFavorites rows referencing the build are deleted first.
Request POST /removeSkillBuild Auth-Key : <LodAuthKey> Content-Type : application/x-www-form-urlencoded data={ ... }
JSON-encoded removal request. Database ID of the skill build to delete.
Steam ID of the requesting player.
Example request body { "buildId" : 42 , "steamId" : "76561197966504115" }
Response Returns HTTP 200 with an empty body on success. Returns HTTP 401 if authentication fails.
GET /getSkillBuilds Returns an ordered, paginated list of all skill builds. Each build includes aggregated up-vote and down-vote Steam ID lists.
Request GET /getSkillBuilds?skip=0
Number of records to skip (0-based offset for pagination).
Response Array of skill build objects ordered by creation date (oldest first).
Ability names in the build.
Primary attribute (strength, agility, intelligence).
Steam IDs of players who upvoted.
Steam IDs of players who downvoted.
ISO 8601 creation timestamp.
Example response [ { "id" : 1 , "abilities" : [ "pudge_meat_hook" , "pudge_rot" , "pudge_flesh_heap" , "pudge_dismember" ], "attribute" : "strength" , "description" : "Standard hook-and-rot build." , "heroName" : "npc_dota_hero_pudge" , "steamID" : "76561197966504115" , "tags" : [ "hook" , "sustain" ], "title" : "Classic Pudge" , "votes_Up" : 5 , "votes_Down" : 1 , "upVoteIds" : [ "76561198000000001" , "76561198000000002" ], "downVoteIds" : [ "76561198000000003" ], "created" : "2024-01-15T10:30:00" } ]
POST /setFavoriteSkillBuild Adds or removes a skill build from a player’s favorites list.
Request POST /setFavoriteSkillBuild Auth-Key : <LodAuthKey> Content-Type : application/x-www-form-urlencoded data={ ... }
JSON-encoded favorite action. 1 to add to favorites, 0 to remove.
Database ID of the skill build.
64-bit Steam ID of the player.
Example request bodies // Add to favorites { "fav" : 1 , "id" : 42 , "steamID" : "76561197966504115" } // Remove from favorites { "fav" : 0 , "id" : 42 , "steamID" : "76561197966504115" }
Response HTTP 200 with an empty body on success.
POST /voteSkillBuild Casts an upvote or downvote on a skill build. Each Steam ID may only vote once per build — a second vote from the same player returns HTTP 400.
Request POST /voteSkillBuild Auth-Key : <LodAuthKey> Content-Type : application/x-www-form-urlencoded data={ ... }
JSON-encoded vote action. Database ID of the skill build to vote on.
64-bit Steam ID of the voter.
1 for upvote, 0 for downvote.
Example request bodies // Upvote { "id" : 2 , "steamID" : "76561197966504115" , "vote" : 1 } // Downvote { "id" : 2 , "steamID" : "76561197966504115" , "vote" : 0 }
Response Status Meaning 200 OKVote recorded successfully. 400 Bad RequestPlayer has already voted on this build. 401 UnauthorizedMissing or invalid Auth-Key header. 404 Not FoundNo skill build with the specified id.
GET /getFavoriteSkillBuilds Returns the list of skill build IDs that a player has favorited.
Request GET /getFavoriteSkillBuilds?steamId=76561197966504115&playerId=76561197966504115
64-bit Steam ID of the player whose favorites are being retrieved.
Alias for steamId. Accepted but currently unused by the query logic.
Response Array of integer build IDs.
