Raid. Respawn. Rebuild. Repeat.

Raidlands 10X Clan API Docs

Public clan API authentication, rate limits, and request shapes for websites, bots, and Discord tools.

Authentication

Steam-linked API keys

Create keys from the Clans page while signed in with Steam. The secret is shown once, stored only as a hash, and resolves back to that SteamID64 on every request.

Headers

Authorization: Bearer rcl_your_key_here
Accept: application/json
Content-Type: application/json

You can also send X-Raidlands-Api-Key. If a request includes steam_id64, it must match the Steam account that owns the key.

Rate limit

60 requests / minute / key

Rate-limited responses return HTTP 429 and Retry-After: 60. Keep Discord bots behind a small queue when many commands fire at once.

Read state

Resolve the linked clan

Use this endpoint to show the caller's clan, role, roster, invites, allies, stale-state flag, and role-allowed actions.

GET https://raidlands.net/api/clans/me.phpAuthorization: Bearer rcl_your_key_here

{
  "ok": true,
  "context": {
    "player": {"steam_id64": "7656119..."},
    "role": "owner",
    "allowed_actions": ["invite", "withdraw_invite", "kick", "promote", "demote", "disband"],
    "clan": {
      "tag": "RAID",
      "is_stale": false,
      "members": []
    }
  }
}

Queue actions

Manage clan changes

Write calls use the same clan rules players see on Raidlands. The game server claims queued actions, applies them in Rust, and posts the result back.

Invite player

POST https://raidlands.net/api/clans/action.phpAuthorization: Bearer rcl_your_key_here

{
  "steam_id64": "7656119...",
  "action": "invite",
  "target_steam_id64": "7656119...",
  "target_display_name": "Player"
}

Owner actions

{
  "action": "promote",
  "target_steam_id64": "7656119..."
}

{
  "action": "disband",
  "confirm_clan_tag": "RAID"
}

Allowed actions

Safety model

Members can read their synced clan state but cannot queue management actions.
Moderators can invite, withdraw invites, and kick regular members.
Owners can also promote, demote, and disband.
Actions are rejected when the latest game-server snapshot is older than ten minutes.
Disband requires confirm_clan_tag to match the synced clan tag.