API reference

Members & links

An Epic account link ties a Discord member to their Epic Games account. Verified links gate tournament signups, customs participation, and stats.

All paths are relative to https://api.zyron.pro/api/v1/guilds/:guildId.

List links

GET/guilds/:guildId/links

Field	Type	Description
`search`	`string`	Query parameter — filter by Epic name or Discord ID.
`page`	`number`	Query parameter — 1-based page number. Default `1`.
`limit`	`number`	Query parameter — results per page.

json

{
  "total": 412,
  "page": 1,
  "limit": 50,
  "users": [
    {
      "discordId": "222222222222222222",
      "epicId": "a1b2c3d4e5f60718293a4b5c6d7e8f90",
      "epicName": "Ninja",
      "platform": "PC",
      "inputMethod": "KBM",
      "verificationMethod": "code",
      "linkedAt": "2026-06-01T18:22:04.000Z"
    }
  ]
}

Get one link

GET/guilds/:guildId/links/:discordId

Returns the link for one Discord member. Responds 404 not_found if the member has no linked Epic account.

Create a link

POST/guilds/:guildId/links

Creates a verified link with verificationMethod: "api", grants the member the verified role, and fires the member.verified webhook. Returns 201 Created with the new link.

Field	Type	Description
`discordId`required	`string`	The Discord member to link.
`epicId`required	`string`	The Epic account ID (lowercase 32-character hex).
`epicName`required	`string`	The Epic display name.
`platform`	`string`	Optional platform, e.g. `PC`, `PS5`, `Xbox`, `Switch`.
`inputMethod`	`string`	Optional input method, e.g. `KBM` or `Controller`.

curl -X POST https://api.zyron.pro/api/v1/guilds/123456789012345678/links \
  -H "Authorization: Bearer zyr_your_guild_key" \
  -H "Content-Type: application/json" \
  -d '{
    "discordId": "222222222222222222",
    "epicId": "a1b2c3d4e5f60718293a4b5c6d7e8f90",
    "epicName": "Ninja",
    "platform": "PC",
    "inputMethod": "KBM"
  }'

json

{
  "discordId": "222222222222222222",
  "epicId": "a1b2c3d4e5f60718293a4b5c6d7e8f90",
  "epicName": "Ninja",
  "platform": "PC",
  "inputMethod": "KBM",
  "verificationMethod": "api",
  "linkedAt": "2026-07-10T09:15:31.000Z"
}

This bypasses Epic verification

POST /links skips Zyron's in-game verification flow entirely — the link is trusted as-is. Only link accounts you have verified yourself; a wrong link puts the member into tournaments and customs under someone else's Epic identity.

Conflict cases: 409 conflict when the member already has a link or the Epic account is already linked to another member; 403 forbidden when the guild's registered-members cap is reached.

Delete a link

DELETE/guilds/:guildId/links/:discordId

Removes the member's Epic link (and fires the member.unlinked webhook). Responds 404 not_found if there is no link.

Errors

400 invalid_request for a malformed epicId or missing required fields; 404 not_found for an unlinked member; 409 conflict for duplicate links; 403 forbidden at the members cap. See Errors.