Skip to main content
POST
Create player

idem-key (required)

Client-generated unique string for this create. Send it as header idem-key (or Idempotency-Key).
  • Same key again → 409 Conflict (Idempotency key already used); no second player is created.
  • New player → always generate a new key (UUID recommended).
Use the generator below to create an idem-key you can paste into Try it. See Concepts → Idempotency key for the full definition.

Authorizations

Authorization
string
header
required

Public integration API key (bb_live_...). Not a login JWT.

Headers

idem-key
string
required

Client-generated unique string for this create intent (UUID recommended). Also accepted as Idempotency-Key. Same key reused after a successful create → 409 Conflict (Idempotency key already used). Missing → 400.

Example:

"550e8400-e29b-41d4-a716-446655440000"

Path Parameters

teamId
string
required
Example:

"507f1f77bcf86cd799439011"

Body

application/json
name
string
required
Example:

"Alex Johnson"

email
string<email>
position
string[]
Example:

Response

Player created

message
string
Example:

"API key revoked successfully!"