POST /v4/challenges/{challengeId}/join

POST

https://api.kickbase.com/v4/challenges/{challengeId}/join

Join a Challenge

Allows the authenticated user to join an existing challenge by its ID.

Authentication

This endpoint requires a Bearer token passed via the {{token}} variable:

Authorization: Bearer {{token}}

Path Variable

Variable	Description
`challengeId`	The unique ID of the challenge to join

Headers

Header	Value
`Content-Type`	`application/json`
`Accept`	`application/json`

Request Body

The request body must be a JSON object with the following fields:

Field	Type	Description	Example
`lud`	object	Lineup data for the challenge entry	`{"lt": "4-4-2", "pls": ["1234"]}`
`lud.lt`	string	The lineup/formation type	`"4-4-2"`
`lud.pls`	array of strings	List of player IDs in the lineup	`["1234"]`
`pi`	string	Player/participant identifier	`"1234"`
`gid`	string	Group or game identifier	`"1234"`

Example Body:

{
  "lud": {
    "lt": "4-4-2",
    "pls": ["1234"]
  },
  "pi": "1234",
  "gid": "1234"
}

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Header Params

Body Params application/json

Examples

Responses

🟢200

application/json

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.kickbase.com/v4/challenges/ut sit nisi aliquip eiusmod/join' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "lud": {
        "lt": "4-4-2",
        "pls": [
            "1234"
        ]
    },
    "pi": "1234",
    "gid": "1234"
}'

Response Example

{}

GET /v4/challenges/{challengeId}/top10

POST /v4/challenges/join

POST /v4/challenges/{challengeId}/join

Join a Challenge#

Authentication#

Path Variable#

Headers#