Turn ON or OFF ads

POST

https://appapi.bots.business/v2/user/iterations/toggle_ads

Use this endpoint to enable or disable advertisements in your bot. When ads are enabled, you receive increased iteration limits and potential earnings, but advertisements will be displayed to your bot's users.

Request

Query Params

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://appapi.bots.business/v2/user/iterations/toggle_ads?api_key=UKDZu-c68cubrIbniuE2P_nWj0p5r4IHARNrAV-I'

Responses

🟢200Success

application/json

Body

Example

{
    "id": 238460,
    "limit": 7500,
    "progress": 477,
    "quotum_type_id": 1,
    "user_id": 22425807,
    "started_at": "2025-10-23T13:48:40.419Z",
    "created_at": "2023-11-30T04:02:45.971Z",
    "updated_at": "2025-10-28T04:47:12.877Z",
    "extra_points": 46,
    "ended_at": "2025-11-23T13:48:40.419Z",
    "paid_cycles_count": 0,
    "have_ads": false,
    "quotum_type": {
        "id": 1,
        "name": "IterationQuota",
        "base_limit": 7500,
        "payment_plan_id": 1,
        "created_at": "2018-12-17T04:44:36.388Z",
        "updated_at": "2025-04-08T14:16:12.369Z",
        "ads_limit": 3000000
    }
}

🟠401

🟠404

🟢200needremove

Get iteration usage

Get payment plan