Add to Queue

This endpoint allows you to add a user to the queue by submitting the required and optional details in the request body. Below are the details on how to use the /v1/queue/add endpoint.

🛠 Endpoint

POST https://api.fbot.cc/v1/queue/add

The following parameters can be included in the request body

Prop	Type	Default
`profile`	`string`	`Required`
`app_id`	`number`	`Optional`
`method`	`string`	`Optional`
`reason`	`string`	`Optional`
`match_id`	`string`	`Optional`
`post_url`	`string`	`Optional`
`custom_reason`	`string`	`Optional`

Example Request:

POST https://api.fbot.cc/v1/queue/add
Content-Type: application/json
Authorization: Bearer <your-frp-key>

{ 
    profile: '76561198000000000',                       /* Required */
    app_id: '753',                                       /* Optional */ /* steam app id */
    method: 'basic',                                     /* Optional */ /* "basic" | "advanced" */
    reason: 'community',                                 /* Optional */ /* "community" "cheating" */
    match_id: '76561198000000000',                       /* Optional */
    post_url: 'https://steamcommunity.com/.....',        /* Optional */ /* valid URL */
    custom_reason: 'This user doesnt support cat rights' /* Optional */ /* no longer than 120 characters */ 
}

🚀 Response

Upon successfully adding a user to the queue, the API will return a 200 OK response with the following structure:

{
  "success": true,
  "message": "User added to the queue with id 5f8xxxxxxxxxxxxxxxxxxxxxxxx",
  "data": {
    "id": "5f8xxxxxxxxxxxxxxxxxxxxxxxx",
    "user": {
      "steam_id": "76561198000000000",
      "name": "Sample User",
      "avatar": "https://steamcdn-a.akamaihd.net/avatars/sample.jpg"
    },
    "position": 5
  }
}

⚠️ Error Handling

If the request fails due to a missing required field or an invalid parameter, the response will look like this:

{
  "success": false,
  "message": "Missing or invalid fields"
}

Ensure that all required fields (steam_id) are provided and optional fields (if included) meet their validation criteria.

Add to Queue

🛠 Endpoint

Example Request:

🚀 Response

⚠️ Error Handling

On this page