Tournament catalog

Approved tournament presets plus room-owned blind and payout structure authoring.

List approved tournament catalog

GET

https://api.pokerworks.io

/api/v1/management/tournament-catalog

List approved tournament catalog

List approved tournament catalog › Responses

TournamentCatalogResponse

object[] · required

catalogVersion

string · enum · required

Enum values:

2026-06-08.management-tournament-catalog.v2

object

string · enum · required

Enum values:

developer_tournament_catalog

object[] · required

object · required

object[] · minItems: 1 · required

GET/api/v1/management/tournament-catalog

curl https://api.pokerworks.io/api/v1/management/tournament-catalog \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "blindStructures": [
    {
      "blindStructureId": "blindStructureId",
      "estimatedDurationMinutes": 0.1,
      "isPremium": true,
      "levels": [
        {
          "ante": 0,
          "bigBlind": 1,
          "durationMinutes": 1,
          "levelNumber": 1,
          "smallBlind": 1
        }
      ],
      "name": "name",
      "provenance": null,
      "roomId": null,
      "scope": "approved_catalog"
    }
  ],
  "catalogVersion": "2026-06-08.management-tournament-catalog.v2",
  "object": "developer_tournament_catalog",
  "payoutStructures": [
    {
      "entries": [
        {
          "payoutPercent": 0,
          "position": 1
        }
      ],
      "isPremium": true,
      "maxPlayers": 1,
      "minPlayers": 1,
      "name": "name",
      "payoutStructureId": "payoutStructureId",
      "provenance": null,
      "roomId": null,
      "scope": "approved_catalog"
    }
  ],
  "support": {
    "authoring": "custom_structures",
    "createScope": "tournaments:create",
    "readScope": "tournament_structures:read",
    "structureCreateScope": "tournament_structures:create",
    "structureUpdateScope": "tournament_structures:update",
    "structuresAreReadOnly": true
  },
  "tournamentPresets": [
    {
      "blindStructureId": "blindStructureId",
      "description": "description",
      "key": "scheduled_mtt_nlhe_v1",
      "kind": "scheduled_mtt",
      "label": "label",
      "maxPlayers": 1,
      "payoutStructureId": "payoutStructureId",
      "variant": "nlhe"
    }
  ]
}

json

application/json

List tournament presets

GET

https://api.pokerworks.io

/api/v1/management/tournament-presets

List approved tournament presets

List tournament presets › Responses

TournamentPresetsResponse

catalogVersion

string · enum · required

Enum values:

2026-06-08.management-tournament-catalog.v2

object

string · enum · required

Enum values:

developer_tournament_presets

object · required

object[] · minItems: 1 · required

GET/api/v1/management/tournament-presets

curl https://api.pokerworks.io/api/v1/management/tournament-presets \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "catalogVersion": "2026-06-08.management-tournament-catalog.v2",
  "object": "developer_tournament_presets",
  "support": {
    "authoring": "custom_structures",
    "createScope": "tournaments:create",
    "readScope": "tournament_structures:read",
    "structureCreateScope": "tournament_structures:create",
    "structureUpdateScope": "tournament_structures:update",
    "structuresAreReadOnly": true
  },
  "tournamentPresets": [
    {
      "blindStructureId": "blindStructureId",
      "description": "description",
      "key": "scheduled_mtt_nlhe_v1",
      "kind": "scheduled_mtt",
      "label": "label",
      "maxPlayers": 1,
      "payoutStructureId": "payoutStructureId",
      "variant": "nlhe"
    }
  ]
}

json

application/json

Get tournament preset

GET

https://api.pokerworks.io

/api/v1/management/tournament-presets/{presetKey}

Get an approved tournament preset

Get tournament preset › path Parameters

presetKey

string · required

Parameter presetKey.

Get tournament preset › Responses

GetTournamentPresetResponse

catalogVersion

string · enum · required

Enum values:

2026-06-08.management-tournament-catalog.v2

object

string · enum · required

Enum values:

developer_tournament_preset

object · required

GET/api/v1/management/tournament-presets/{presetKey}

curl https://api.pokerworks.io/api/v1/management/tournament-presets/:presetKey \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "catalogVersion": "2026-06-08.management-tournament-catalog.v2",
  "object": "developer_tournament_preset",
  "support": {
    "authoring": "custom_structures",
    "createScope": "tournaments:create",
    "readScope": "tournament_structures:read",
    "structureCreateScope": "tournament_structures:create",
    "structureUpdateScope": "tournament_structures:update",
    "structuresAreReadOnly": true
  },
  "tournamentPreset": {
    "blindStructureId": "blindStructureId",
    "description": "description",
    "key": "scheduled_mtt_nlhe_v1",
    "kind": "scheduled_mtt",
    "label": "label",
    "maxPlayers": 1,
    "payoutStructureId": "payoutStructureId",
    "variant": "nlhe"
  }
}

json

application/json

List blind structures

GET

https://api.pokerworks.io

/api/v1/management/blind-structures

List approved blind structures

List blind structures › Responses

BlindStructuresResponse

object[] · required

catalogVersion

string · enum · required

Enum values:

2026-06-08.management-tournament-catalog.v2

object

string · enum · required

Enum values:

developer_blind_structures

object · required

GET/api/v1/management/blind-structures

curl https://api.pokerworks.io/api/v1/management/blind-structures \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "blindStructures": [
    {
      "blindStructureId": "blindStructureId",
      "estimatedDurationMinutes": 0.1,
      "isPremium": true,
      "levels": [
        {
          "ante": 0,
          "bigBlind": 1,
          "durationMinutes": 1,
          "levelNumber": 1,
          "smallBlind": 1
        }
      ],
      "name": "name",
      "provenance": null,
      "roomId": null,
      "scope": "approved_catalog"
    }
  ],
  "catalogVersion": "2026-06-08.management-tournament-catalog.v2",
  "object": "developer_blind_structures",
  "support": {
    "authoring": "custom_structures",
    "readScope": "tournament_structures:read",
    "structureCreateScope": "tournament_structures:create",
    "structureUpdateScope": "tournament_structures:update",
    "structuresAreReadOnly": true
  }
}

json

application/json

Create blind structure

POST

https://api.pokerworks.io

/api/v1/management/blind-structures

Create a room-owned blind structure

Create blind structure › Request Body

CreateBlindStructureRequest

object[] · minItems: 1 · required

name

string · minLength: 1 · maxLength: 128 · required

roomId

string · minLength: 1 · maxLength: 160 · required

estimatedDurationMinutes

integer | null

object

Create blind structure › Responses

GetBlindStructureResponse

object · required

catalogVersion

string · enum · required

Enum values:

2026-06-08.management-tournament-catalog.v2

object

string · enum · required

Enum values:

developer_blind_structure

object · required

POST/api/v1/management/blind-structures

curl https://api.pokerworks.io/api/v1/management/blind-structures \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "estimatedDurationMinutes": 0.1,
  "levels": [
    {
      "ante": 0,
      "bigBlind": 1,
      "durationMinutes": 1,
      "levelNumber": 1,
      "smallBlind": 1
    }
  ],
  "name": "name",
  "provenance": {
    "checksum": "checksum",
    "exportedAt": "2024-08-25T15:00:00Z",
    "referenceId": "referenceId",
    "source": "manual",
    "sourceVersion": "sourceVersion",
    "tool": "unknown"
  },
  "roomId": "roomId"
}'

Example Request Body

{
  "estimatedDurationMinutes": 0.1,
  "levels": [
    {
      "ante": 0,
      "bigBlind": 1,
      "durationMinutes": 1,
      "levelNumber": 1,
      "smallBlind": 1
    }
  ],
  "name": "name",
  "provenance": {
    "checksum": "checksum",
    "exportedAt": "2024-08-25T15:00:00Z",
    "referenceId": "referenceId",
    "source": "manual",
    "sourceVersion": "sourceVersion",
    "tool": "unknown"
  },
  "roomId": "roomId"
}

json

Example Responses

{
  "blindStructure": {
    "blindStructureId": "blindStructureId",
    "estimatedDurationMinutes": 0.1,
    "isPremium": true,
    "levels": [
      {
        "ante": 0,
        "bigBlind": 1,
        "durationMinutes": 1,
        "levelNumber": 1,
        "smallBlind": 1
      }
    ],
    "name": "name",
    "provenance": null,
    "roomId": null,
    "scope": "approved_catalog"
  },
  "catalogVersion": "2026-06-08.management-tournament-catalog.v2",
  "object": "developer_blind_structure",
  "support": {
    "authoring": "custom_structures",
    "readScope": "tournament_structures:read",
    "structureCreateScope": "tournament_structures:create",
    "structureUpdateScope": "tournament_structures:update",
    "structuresAreReadOnly": true
  }
}

json

application/json

Get blind structure

GET

https://api.pokerworks.io

/api/v1/management/blind-structures/{blindStructureId}

Get an approved blind structure

Get blind structure › path Parameters

blindStructureId

string · required

Parameter blindStructureId.

Get blind structure › Responses

GetBlindStructureResponse

object · required

catalogVersion

string · enum · required

Enum values:

2026-06-08.management-tournament-catalog.v2

object

string · enum · required

Enum values:

developer_blind_structure

object · required

GET/api/v1/management/blind-structures/{blindStructureId}

curl https://api.pokerworks.io/api/v1/management/blind-structures/:blindStructureId \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "blindStructure": {
    "blindStructureId": "blindStructureId",
    "estimatedDurationMinutes": 0.1,
    "isPremium": true,
    "levels": [
      {
        "ante": 0,
        "bigBlind": 1,
        "durationMinutes": 1,
        "levelNumber": 1,
        "smallBlind": 1
      }
    ],
    "name": "name",
    "provenance": null,
    "roomId": null,
    "scope": "approved_catalog"
  },
  "catalogVersion": "2026-06-08.management-tournament-catalog.v2",
  "object": "developer_blind_structure",
  "support": {
    "authoring": "custom_structures",
    "readScope": "tournament_structures:read",
    "structureCreateScope": "tournament_structures:create",
    "structureUpdateScope": "tournament_structures:update",
    "structuresAreReadOnly": true
  }
}

json

application/json

Update blind structure

PATCH

https://api.pokerworks.io

/api/v1/management/blind-structures/{blindStructureId}

Update a room-owned blind structure

Update blind structure › path Parameters

blindStructureId

string · required

Parameter blindStructureId.

Update blind structure › Request Body

UpdateBlindStructureRequest

estimatedDurationMinutes

integer | null

object[] · minItems: 1

name

string · minLength: 1 · maxLength: 128

provenance

object | null

Update blind structure › Responses

GetBlindStructureResponse

object · required

catalogVersion

string · enum · required

Enum values:

2026-06-08.management-tournament-catalog.v2

object

string · enum · required

Enum values:

developer_blind_structure

object · required

PATCH/api/v1/management/blind-structures/{blindStructureId}

curl https://api.pokerworks.io/api/v1/management/blind-structures/:blindStructureId \
  --request PATCH \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "estimatedDurationMinutes": 0.1,
  "levels": [
    {
      "ante": 0,
      "bigBlind": 1,
      "durationMinutes": 1,
      "levelNumber": 1,
      "smallBlind": 1
    }
  ],
  "name": "name",
  "provenance": {
    "checksum": "checksum",
    "exportedAt": "2024-08-25T15:00:00Z",
    "referenceId": "referenceId",
    "source": "manual",
    "sourceVersion": "sourceVersion",
    "tool": "unknown"
  }
}'

Example Request Body

{
  "estimatedDurationMinutes": 0.1,
  "levels": [
    {
      "ante": 0,
      "bigBlind": 1,
      "durationMinutes": 1,
      "levelNumber": 1,
      "smallBlind": 1
    }
  ],
  "name": "name",
  "provenance": {
    "checksum": "checksum",
    "exportedAt": "2024-08-25T15:00:00Z",
    "referenceId": "referenceId",
    "source": "manual",
    "sourceVersion": "sourceVersion",
    "tool": "unknown"
  }
}

json

Example Responses

{
  "blindStructure": {
    "blindStructureId": "blindStructureId",
    "estimatedDurationMinutes": 0.1,
    "isPremium": true,
    "levels": [
      {
        "ante": 0,
        "bigBlind": 1,
        "durationMinutes": 1,
        "levelNumber": 1,
        "smallBlind": 1
      }
    ],
    "name": "name",
    "provenance": null,
    "roomId": null,
    "scope": "approved_catalog"
  },
  "catalogVersion": "2026-06-08.management-tournament-catalog.v2",
  "object": "developer_blind_structure",
  "support": {
    "authoring": "custom_structures",
    "readScope": "tournament_structures:read",
    "structureCreateScope": "tournament_structures:create",
    "structureUpdateScope": "tournament_structures:update",
    "structuresAreReadOnly": true
  }
}

json

application/json

List payout structures

GET

https://api.pokerworks.io

/api/v1/management/payout-structures

List approved payout structures

List payout structures › Responses

PayoutStructuresResponse

catalogVersion

string · enum · required

Enum values:

2026-06-08.management-tournament-catalog.v2

object

string · enum · required

Enum values:

developer_payout_structures

object[] · required

object · required

GET/api/v1/management/payout-structures

curl https://api.pokerworks.io/api/v1/management/payout-structures \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "catalogVersion": "2026-06-08.management-tournament-catalog.v2",
  "object": "developer_payout_structures",
  "payoutStructures": [
    {
      "entries": [
        {
          "payoutPercent": 0,
          "position": 1
        }
      ],
      "isPremium": true,
      "maxPlayers": 1,
      "minPlayers": 1,
      "name": "name",
      "payoutStructureId": "payoutStructureId",
      "provenance": null,
      "roomId": null,
      "scope": "approved_catalog"
    }
  ],
  "support": {
    "authoring": "custom_structures",
    "readScope": "tournament_structures:read",
    "structureCreateScope": "tournament_structures:create",
    "structureUpdateScope": "tournament_structures:update",
    "structuresAreReadOnly": true
  }
}

json

application/json

Create payout structure

POST

https://api.pokerworks.io

/api/v1/management/payout-structures

Create a room-owned payout structure

Create payout structure › Request Body

CreatePayoutStructureRequest

object[] · minItems: 1 · required

maxPlayers

integer · min: 2 · max: 10000 · required

minPlayers

integer · min: 1 · max: 10000 · required

name

string · minLength: 1 · maxLength: 128 · required

roomId

string · minLength: 1 · maxLength: 160 · required

object

Create payout structure › Responses

GetPayoutStructureResponse

catalogVersion

string · enum · required

Enum values:

2026-06-08.management-tournament-catalog.v2

object

string · enum · required

Enum values:

developer_payout_structure

object · required

POST/api/v1/management/payout-structures

curl https://api.pokerworks.io/api/v1/management/payout-structures \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "entries": [
    {
      "payoutPercent": 1,
      "position": 1
    }
  ],
  "maxPlayers": 2,
  "minPlayers": 1,
  "name": "name",
  "provenance": {
    "checksum": "checksum",
    "exportedAt": "2024-08-25T15:00:00Z",
    "referenceId": "referenceId",
    "source": "manual",
    "sourceVersion": "sourceVersion",
    "tool": "unknown"
  },
  "roomId": "roomId"
}'

Example Request Body

{
  "entries": [
    {
      "payoutPercent": 1,
      "position": 1
    }
  ],
  "maxPlayers": 2,
  "minPlayers": 1,
  "name": "name",
  "provenance": {
    "checksum": "checksum",
    "exportedAt": "2024-08-25T15:00:00Z",
    "referenceId": "referenceId",
    "source": "manual",
    "sourceVersion": "sourceVersion",
    "tool": "unknown"
  },
  "roomId": "roomId"
}

json

Example Responses

{
  "catalogVersion": "2026-06-08.management-tournament-catalog.v2",
  "object": "developer_payout_structure",
  "payoutStructure": {
    "entries": [
      {
        "payoutPercent": 0,
        "position": 1
      }
    ],
    "isPremium": true,
    "maxPlayers": 1,
    "minPlayers": 1,
    "name": "name",
    "payoutStructureId": "payoutStructureId",
    "provenance": null,
    "roomId": null,
    "scope": "approved_catalog"
  },
  "support": {
    "authoring": "custom_structures",
    "readScope": "tournament_structures:read",
    "structureCreateScope": "tournament_structures:create",
    "structureUpdateScope": "tournament_structures:update",
    "structuresAreReadOnly": true
  }
}

json

application/json

Get payout structure

GET

https://api.pokerworks.io

/api/v1/management/payout-structures/{payoutStructureId}

Get an approved payout structure

Get payout structure › path Parameters

payoutStructureId

string · required

Parameter payoutStructureId.

Get payout structure › Responses

GetPayoutStructureResponse

catalogVersion

string · enum · required

Enum values:

2026-06-08.management-tournament-catalog.v2

object

string · enum · required

Enum values:

developer_payout_structure

object · required

GET/api/v1/management/payout-structures/{payoutStructureId}

curl https://api.pokerworks.io/api/v1/management/payout-structures/:payoutStructureId \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "catalogVersion": "2026-06-08.management-tournament-catalog.v2",
  "object": "developer_payout_structure",
  "payoutStructure": {
    "entries": [
      {
        "payoutPercent": 0,
        "position": 1
      }
    ],
    "isPremium": true,
    "maxPlayers": 1,
    "minPlayers": 1,
    "name": "name",
    "payoutStructureId": "payoutStructureId",
    "provenance": null,
    "roomId": null,
    "scope": "approved_catalog"
  },
  "support": {
    "authoring": "custom_structures",
    "readScope": "tournament_structures:read",
    "structureCreateScope": "tournament_structures:create",
    "structureUpdateScope": "tournament_structures:update",
    "structuresAreReadOnly": true
  }
}

json

application/json

Update payout structure

PATCH

https://api.pokerworks.io

/api/v1/management/payout-structures/{payoutStructureId}

Update a room-owned payout structure

Update payout structure › path Parameters

payoutStructureId

string · required

Parameter payoutStructureId.

Update payout structure › Request Body

UpdatePayoutStructureRequest

object[] · minItems: 1

maxPlayers

integer · min: 2 · max: 10000

minPlayers

integer · min: 1 · max: 10000

name

string · minLength: 1 · maxLength: 128

provenance

object | null

Update payout structure › Responses

GetPayoutStructureResponse

catalogVersion

string · enum · required

Enum values:

2026-06-08.management-tournament-catalog.v2

object

string · enum · required

Enum values:

developer_payout_structure

object · required

PATCH/api/v1/management/payout-structures/{payoutStructureId}

curl https://api.pokerworks.io/api/v1/management/payout-structures/:payoutStructureId \
  --request PATCH \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "entries": [
    {
      "payoutPercent": 1,
      "position": 1
    }
  ],
  "maxPlayers": 2,
  "minPlayers": 1,
  "name": "name",
  "provenance": {
    "checksum": "checksum",
    "exportedAt": "2024-08-25T15:00:00Z",
    "referenceId": "referenceId",
    "source": "manual",
    "sourceVersion": "sourceVersion",
    "tool": "unknown"
  }
}'

Example Request Body

{
  "entries": [
    {
      "payoutPercent": 1,
      "position": 1
    }
  ],
  "maxPlayers": 2,
  "minPlayers": 1,
  "name": "name",
  "provenance": {
    "checksum": "checksum",
    "exportedAt": "2024-08-25T15:00:00Z",
    "referenceId": "referenceId",
    "source": "manual",
    "sourceVersion": "sourceVersion",
    "tool": "unknown"
  }
}

json

Example Responses

{
  "catalogVersion": "2026-06-08.management-tournament-catalog.v2",
  "object": "developer_payout_structure",
  "payoutStructure": {
    "entries": [
      {
        "payoutPercent": 0,
        "position": 1
      }
    ],
    "isPremium": true,
    "maxPlayers": 1,
    "minPlayers": 1,
    "name": "name",
    "payoutStructureId": "payoutStructureId",
    "provenance": null,
    "roomId": null,
    "scope": "approved_catalog"
  },
  "support": {
    "authoring": "custom_structures",
    "readScope": "tournament_structures:read",
    "structureCreateScope": "tournament_structures:create",
    "structureUpdateScope": "tournament_structures:update",
    "structuresAreReadOnly": true
  }
}

json

application/json

Rooms Tournaments