Skip to content
Dice Chess Bot APIDice Chess Bot API

Create a challenge

POST
/bot/challenge
curl --request POST \
  --url https://play-api.jc.id.lv/bot/challenge \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "team": "example", "name": "example", "timeControl": { "Unlimited": {} } }'

Authorizations

Section titled “Authorizations”

Request Bodyrequired

Section titled “Request Bodyrequired”
Media typeapplication/json
object
team
required
string
name
required
string
timeControl

Optional — the server defaults an omitted time control to Unlimited.

object
One of:

A single-key time-control wrapper.

object
Unlimited
required
object
Examplegenerated
{
  "team": "example",
  "name": "example",
  "timeControl": {
    "Unlimited": {}
  }
}

Responses

Section titled “Responses”

201

Section titled “201”

Challenge created.

Media typeapplication/json
object
id
required
string
challenger
required
One of:

A participant’s identity as a single-key wrapper.

object
Guest
required
object
id
string
target
required
One of:

A participant’s identity as a single-key wrapper.

object
Guest
required
object
id
string
timeControl
required
One of:

A single-key time-control wrapper.

object
Unlimited
required
object
targetOnline

Advisory — whether the target holds an account stream.

boolean
Examplegenerated
{
  "id": "example",
  "challenger": {
    "Guest": {
      "id": "example"
    }
  },
  "target": {
    "Guest": {
      "id": "example"
    }
  },
  "timeControl": {
    "Unlimited": {}
  },
  "targetOnline": true
}

400

Section titled “400”

Challenging yourself.

429

Section titled “429”

Too many pending challenges.