Serpo.one

ডেভেলপার API

REST বা MCP দিয়ে প্রকল্প, লক্ষ্য, পরীক্ষা, সময়সূচি ও নিজের প্রোভাইডার পরিচয়পত্র পরিচালনা করুন।

OpenAPI 3.1 JSON · অপারেশন · ত্রুটি · MCP

পরিচয় যাচাই

বর্তমান পাসওয়ার্ড দিয়ে API ও MCP-তে মেয়াদযুক্ত টোকেন তৈরি করুন। একবার কপি করে গোপন রাখুন। প্রতি অনুরোধে Authorization: Bearer TOKEN ও Accept: application/json পাঠান। সেশন কুকি এই API-তে পরিচয় যাচাই করতে পারে না। প্রত্যাহার সঙ্গে সঙ্গে কার্যকর। অ্যাকাউন্ট সক্রিয় ও ইমেইল যাচাইকৃত হতে হবে। API-তে প্রশাসকের ব্যবহারকারী হিসেবে প্রবেশ নেই।

curl 'https://serpo.one/api/v1/projects' \
  -H 'Authorization: Bearer TOKEN' -H 'Accept: application/json'

সফল JSON {"data": ...}-এর মধ্যে থাকে। সংগ্রহ data-র ভিতরে Laravel পেজিনেশন ব্যবহার করে: data.data, data.current_page, data.last_page, data.total। page ≥ 1 এবং per_page 1 থেকে 100 রাখুন (ডিফল্ট 25)। অন্য অ্যাকাউন্টের ID-তে 404 আসে। গোপন তথ্য শুধু পরিচয়পত্র PUT-এ নেওয়া হয়, কখনো ফেরত দেওয়া হয় না। ব্যালেন্স ক্যাশ থাকে; রিফ্রেশ সীমিত ব্যাকগ্রাউন্ড কাজ সারিতে রাখে।

সশুল্ক পরীক্ষা ও পুনরায় চেষ্টা

রান তৈরিতে confirm_paid: true এবং অনন্য Idempotency-Key হেডার বা idempotency_key ফিল্ড লাগে। নতুন রান ছাড়া প্রতিক্রিয়া ফিরে পেতে একই কী ও হুবহু বডি দিন; একই কীতে বদলানো ইনপুটে 409 আসে। কী অ্যাকাউন্টের এবং অ্যাকাউন্ট মোছা পর্যন্ত থাকে। লক্ষ্য ও সেটিং স্থির হয়। প্রোভাইডার খরচ নিতে পারে; অনিশ্চিত অনুরোধ আবার চালাতে retry_uncertain: true দিয়ে সম্ভাব্য দ্বিগুণ খরচ স্বীকার করতে হবে। সময়সূচি তৈরিতেও confirm_paid: true ও ইডেমপোটেন্সি কী লাগে।

curl -X POST 'https://serpo.one/api/v1/projects/1/runs' \
  -H 'Authorization: Bearer TOKEN' -H 'Content-Type: application/json' \
  -H 'Accept: application/json' -H 'Idempotency-Key: check-2026-11-20-001' \
  -d '{"confirm_paid":true,"settings":{"depth":10}}'

CSV এক্সপোর্ট পৃষ্ঠায় ভাগ করা; X-Total-Pages পৃষ্ঠার সংখ্যা দেয়। সম্পূর্ণ এক্সপোর্টে প্রতিটি পৃষ্ঠা নিন। সূত্রের মতো সেল এস্কেপ করা হয়। তারিখ ISO 8601 UTC-তে; সময়সূচিতে স্পষ্ট IANA সময় অঞ্চল লাগে। ISO দিন সোমবার=1 থেকে রবিবার=7। দিবালোক সংরক্ষণে অনুপস্থিত বা দ্ব্যর্থক পুনরাবৃত্ত সময় বাদ যায়; একবারের দ্ব্যর্থক সময়ে স্পষ্ট অফসেট লাগে।

অপারেশন

GET /api/v1/frequency — frequency.list

অনুমতি: frequency:read

POST /api/v1/frequency — frequency.create

অনুমতি: frequency:write

{
    "type": "object",
    "properties": {
        "queries": {
            "type": "array",
            "items": {
                "type": "string",
                "maxLength": 400
            },
            "minItems": 1,
            "maxItems": 1000
        },
        "project": {
            "type": "integer",
            "minimum": 1
        },
        "keyword_ids": {
            "type": "array",
            "items": {
                "type": "integer",
                "minimum": 1
            },
            "minItems": 1,
            "maxItems": 1000,
            "uniqueItems": true
        },
        "provider": {
            "enum": [
                "xmlriver",
                "xmlstock"
            ]
        },
        "modes": {
            "type": "array",
            "items": {
                "enum": [
                    "broad",
                    "phrase",
                    "exact"
                ]
            },
            "minItems": 1,
            "maxItems": 3,
            "uniqueItems": true
        },
        "region": {
            "type": [
                "integer",
                "null"
            ],
            "minimum": 0,
            "maximum": 2147483647
        },
        "device": {
            "enum": [
                "all",
                "desktop",
                "phone",
                "tablet"
            ]
        },
        "period": {
            "enum": [
                "month",
                "week",
                "day"
            ]
        },
        "start": {
            "type": [
                "string",
                "null"
            ],
            "format": "date"
        },
        "end": {
            "type": [
                "string",
                "null"
            ],
            "format": "date"
        },
        "threads": {
            "type": "integer",
            "minimum": 1,
            "maximum": 10
        },
        "confirm_paid": {
            "type": "boolean",
            "const": true
        },
        "idempotency_key": {
            "type": "string",
            "maxLength": 100,
            "pattern": "^[a-zA-Z0-9._:-]+$"
        }
    },
    "required": [
        "modes",
        "confirm_paid"
    ],
    "additionalProperties": false
}
GET /api/v1/frequency/{batch} — frequency.show

অনুমতি: frequency:read

GET /api/v1/frequency/{batch}/results — frequency.results

অনুমতি: frequency:read

GET /api/v1/frequency/{batch}/export — frequency.export

অনুমতি: frequency:read

POST /api/v1/frequency/{batch}/cancel — frequency.cancel

অনুমতি: frequency:write

POST /api/v1/frequency/{batch}/retry — frequency.retry

অনুমতি: frequency:write

{
    "type": "object",
    "properties": {
        "confirm_paid": {
            "type": "boolean",
            "const": true
        },
        "retry_uncertain": {
            "type": "boolean",
            "const": true
        },
        "idempotency_key": {
            "type": "string",
            "maxLength": 100,
            "pattern": "^[a-zA-Z0-9._:-]+$"
        }
    },
    "required": [
        "confirm_paid"
    ],
    "additionalProperties": false
}
POST /api/v1/account/password — account.password

অনুমতি: account:write

{
    "type": "object",
    "properties": {
        "current_password": {
            "type": "string",
            "maxLength": 72,
            "writeOnly": true
        },
        "password": {
            "type": "string",
            "maxLength": 72,
            "writeOnly": true,
            "minLength": 12
        },
        "password_confirmation": {
            "type": "string",
            "maxLength": 72,
            "writeOnly": true
        },
        "revoke_other_tokens": {
            "type": "boolean",
            "default": false
        }
    },
    "required": [
        "current_password",
        "password",
        "password_confirmation"
    ],
    "additionalProperties": false
}
GET /api/v1/tokens — tokens.list

অনুমতি: tokens:read

POST /api/v1/tokens — tokens.issue

অনুমতি:

{
    "type": "object",
    "properties": {
        "email": {
            "type": "string",
            "format": "email",
            "maxLength": 255
        },
        "password": {
            "type": "string",
            "maxLength": 72,
            "writeOnly": true
        },
        "name": {
            "type": "string",
            "maxLength": 100
        },
        "abilities": {
            "type": "array",
            "items": {
                "enum": [
                    "account:read",
                    "account:write",
                    "admin:read",
                    "admin:write",
                    "frequency:read",
                    "frequency:write",
                    "nullable|regex:/^[+-]\\d{2}:\\d{2}$/",
                    "nullable|string|max:2048",
                    "projects:read",
                    "projects:write",
                    "providers:read",
                    "providers:write",
                    "required|array|min:1|max:100",
                    "required|array|min:1|max:1000",
                    "required|array|min:1|max:20",
                    "required|integer|min:1|distinct",
                    "required|integer|min:1|max:365",
                    "required|string|max:100",
                    "required|string|max:30",
                    "required|string|max:400",
                    "runs:read",
                    "runs:write",
                    "schedules:read",
                    "schedules:write",
                    "sometimes|array|min:1|max:100",
                    "sometimes|integer|min:1|max:100",
                    "sometimes|integer|min:1|max:100000",
                    "sometimes|nullable|string|max:255",
                    "sometimes|required|string|max:120",
                    "tokens:read",
                    "tokens:write"
                ]
            },
            "minItems": 1,
            "maxItems": 20,
            "uniqueItems": true
        },
        "expires_in_days": {
            "type": "integer",
            "minimum": 1,
            "maximum": 365
        }
    },
    "required": [
        "email",
        "password",
        "name",
        "abilities",
        "expires_in_days"
    ],
    "additionalProperties": false
}
DELETE /api/v1/tokens/{token} — tokens.revoke

অনুমতি: tokens:write

GET /api/v1/admin/settings — admin.settings

অনুমতি: admin:read

PATCH /api/v1/admin/settings — admin.settings_update

অনুমতি: admin:write

{
    "type": "object",
    "properties": {
        "enabled": {
            "type": "boolean"
        },
        "start": {
            "type": "string",
            "pattern": "^([01][0-9]|2[0-3]):[0-5][0-9]$"
        },
        "end": {
            "type": "string",
            "pattern": "^([01][0-9]|2[0-3]):[0-5][0-9]$"
        }
    },
    "required": [],
    "additionalProperties": false,
    "minProperties": 1
}
GET /api/v1/admin/users — admin.users

অনুমতি: admin:read

GET /api/v1/admin/users/{user} — admin.user

অনুমতি: admin:read

PATCH /api/v1/admin/users/{user}/status — admin.status

অনুমতি: admin:write

{
    "type": "object",
    "properties": {
        "is_active": {
            "type": "boolean"
        }
    },
    "required": [
        "is_active"
    ],
    "additionalProperties": false
}
GET /api/v1/admin/statistics — admin.statistics

অনুমতি: admin:read

GET /api/v1/admin/users/{user}/balances — admin.balances

অনুমতি: admin:read

GET /api/v1/runs/{run}/download — runs.download

অনুমতি: runs:read

GET /api/v1/account — account.show

অনুমতি: account:read

PATCH /api/v1/account — account.update

অনুমতি: account:write

{
    "type": "object",
    "properties": {
        "name": {
            "type": "string",
            "maxLength": 120
        },
        "locale": {
            "enum": [
                "en",
                "ru",
                "kk",
                "es",
                "pt",
                "de",
                "fr",
                "it",
                "pl",
                "tr",
                "uk",
                "zh",
                "ja",
                "ko",
                "ar",
                "hi",
                "id",
                "vi",
                "th",
                "nl",
                "bn",
                "ur",
                "fa",
                "cs"
            ]
        },
        "timezone": {
            "type": "string",
            "maxLength": 80
        },
        "settings": {
            "$ref": "#/components/schemas/RankSettings"
        }
    },
    "required": [],
    "additionalProperties": false
}

অনুরোধের বডির উদাহরণ:

{
    "locale": "en",
    "timezone": "Europe/Moscow"
}
GET /api/v1/projects — projects.list

অনুমতি: projects:read

POST /api/v1/projects — projects.create

অনুমতি: projects:write

{
    "type": "object",
    "properties": {
        "name": {
            "type": "string",
            "maxLength": 120
        },
        "settings": {
            "$ref": "#/components/schemas/RankSettings"
        }
    },
    "required": [
        "name"
    ],
    "additionalProperties": false
}

অনুরোধের বডির উদাহরণ:

{
    "name": "Example",
    "settings": {
        "depth": 10
    }
}
GET /api/v1/projects/{project} — projects.show

অনুমতি: projects:read

PATCH /api/v1/projects/{project} — projects.update

অনুমতি: projects:write

{
    "type": "object",
    "properties": {
        "name": {
            "type": "string",
            "maxLength": 120
        },
        "settings": {
            "$ref": "#/components/schemas/RankSettings"
        }
    },
    "required": [],
    "additionalProperties": false
}
DELETE /api/v1/projects/{project} — projects.delete

অনুমতি: projects:write

POST /api/v1/projects/{project}/domains/import — domains.import

অনুমতি: projects:write

{
    "type": "object",
    "properties": {
        "format": {
            "enum": [
                "txt",
                "csv",
                "json"
            ]
        },
        "mode": {
            "enum": [
                "append",
                "replace"
            ]
        },
        "content": {
            "type": "string",
            "maxLength": 2000000
        }
    },
    "required": [
        "format",
        "mode",
        "content"
    ],
    "additionalProperties": false
}
POST /api/v1/projects/{project}/domains/bulk-delete — domains.bulk_delete

অনুমতি: projects:write

{
    "type": "object",
    "properties": {
        "ids": {
            "type": "array",
            "items": {
                "type": "integer",
                "minimum": 1
            },
            "minItems": 1,
            "maxItems": 1000,
            "uniqueItems": true
        }
    },
    "required": [
        "ids"
    ],
    "additionalProperties": false
}
POST /api/v1/projects/{project}/keywords/import — keywords.import

অনুমতি: projects:write

{
    "type": "object",
    "properties": {
        "format": {
            "enum": [
                "txt",
                "csv",
                "json"
            ]
        },
        "mode": {
            "enum": [
                "append",
                "replace"
            ]
        },
        "content": {
            "type": "string",
            "maxLength": 2000000
        }
    },
    "required": [
        "format",
        "mode",
        "content"
    ],
    "additionalProperties": false
}
POST /api/v1/projects/{project}/keywords/bulk-delete — keywords.bulk_delete

অনুমতি: projects:write

{
    "type": "object",
    "properties": {
        "ids": {
            "type": "array",
            "items": {
                "type": "integer",
                "minimum": 1
            },
            "minItems": 1,
            "maxItems": 1000,
            "uniqueItems": true
        }
    },
    "required": [
        "ids"
    ],
    "additionalProperties": false
}
GET /api/v1/projects/{project}/domains — domains.list

অনুমতি: projects:read

POST /api/v1/projects/{project}/domains — domains.create

অনুমতি: projects:write

{
    "type": "object",
    "properties": {
        "domain": {
            "type": "string",
            "maxLength": 2048
        },
        "group": {
            "type": "string",
            "maxLength": 255
        }
    },
    "required": [
        "domain"
    ],
    "additionalProperties": false
}

অনুরোধের বডির উদাহরণ:

{
    "domain": "example.com"
}
PATCH /api/v1/projects/{project}/domains/{item} — domains.update

অনুমতি: projects:write

{
    "type": "object",
    "properties": {
        "domain": {
            "type": "string",
            "maxLength": 2048
        },
        "group": {
            "type": "string",
            "maxLength": 255
        }
    },
    "required": [
        "domain"
    ],
    "additionalProperties": false
}
DELETE /api/v1/projects/{project}/domains/{item} — domains.delete

অনুমতি: projects:write

GET /api/v1/projects/{project}/keywords — keywords.list

অনুমতি: projects:read

POST /api/v1/projects/{project}/keywords — keywords.create

অনুমতি: projects:write

{
    "type": "object",
    "properties": {
        "query": {
            "type": "string",
            "maxLength": 400
        },
        "domain": {
            "type": [
                "string",
                "null"
            ],
            "maxLength": 2048
        },
        "group": {
            "type": "string",
            "maxLength": 255
        }
    },
    "required": [
        "query"
    ],
    "additionalProperties": false
}

অনুরোধের বডির উদাহরণ:

{
    "query": "example search",
    "group": "Primary"
}
PATCH /api/v1/projects/{project}/keywords/{item} — keywords.update

অনুমতি: projects:write

{
    "type": "object",
    "properties": {
        "query": {
            "type": "string",
            "maxLength": 400
        },
        "domain": {
            "type": [
                "string",
                "null"
            ],
            "maxLength": 2048
        },
        "group": {
            "type": "string",
            "maxLength": 255
        }
    },
    "required": [
        "query"
    ],
    "additionalProperties": false
}
DELETE /api/v1/projects/{project}/keywords/{item} — keywords.delete

অনুমতি: projects:write

GET /api/v1/providers — providers.list

অনুমতি: providers:read

PUT /api/v1/providers/{provider}/credentials — credentials.put

অনুমতি: providers:write

{
    "type": "object",
    "properties": {
        "provider_user": {
            "type": "string",
            "maxLength": 255,
            "writeOnly": true
        },
        "api_key": {
            "type": "string",
            "maxLength": 2000,
            "writeOnly": true
        },
        "frequency_api_key": {
            "type": "string",
            "maxLength": 2000,
            "writeOnly": true,
            "deprecated": true,
            "description": "Deprecated compatibility alias for api_key for both providers; conflicting values return 422."
        },
        "balance_api_key": {
            "type": "string",
            "maxLength": 2000,
            "writeOnly": true,
            "deprecated": true,
            "description": "Deprecated compatibility alias for api_key for both providers; conflicting values return 422; never returned."
        }
    },
    "required": [],
    "additionalProperties": false,
    "description": "Both XMLRiver and XMLStock use one api_key for SERP, Wordstat and balance. Legacy frequency_api_key and balance_api_key are aliases only; conflicting values and masked placeholders return 422. Blank or omitted keys preserve the saved primary key. provider_user is required for first connection; blank or omitted provider_user preserves the saved ID. Masked IDs are rejected."
}

অনুরোধের বডির উদাহরণ:

{
    "provider_user": "123",
    "api_key": "REPLACE_WITH_PROVIDER_KEY"
}
DELETE /api/v1/providers/{provider}/credentials — credentials.delete

অনুমতি: providers:write

GET /api/v1/balances — balances.list

অনুমতি: providers:read

POST /api/v1/balances/refresh — balances.refresh

অনুমতি: providers:write

GET /api/v1/runs — runs.list

অনুমতি: runs:read

POST /api/v1/projects/{project}/runs — runs.create

অনুমতি: runs:write

{
    "type": "object",
    "properties": {
        "confirm_paid": {
            "type": "boolean",
            "const": true
        },
        "idempotency_key": {
            "type": "string",
            "maxLength": 100,
            "pattern": "^[a-zA-Z0-9._:-]+$"
        },
        "settings": {
            "$ref": "#/components/schemas/RankSettings"
        },
        "keyword_id": {
            "type": "integer",
            "minimum": 1
        },
        "domain_ids": {
            "type": "array",
            "items": {
                "type": "integer",
                "minimum": 1
            },
            "minItems": 1,
            "maxItems": 100,
            "uniqueItems": true
        }
    },
    "required": [
        "confirm_paid"
    ],
    "additionalProperties": false
}

অনুরোধের বডির উদাহরণ:

{
    "confirm_paid": true,
    "idempotency_key": "check-001",
    "settings": {
        "depth": 10
    }
}
GET /api/v1/runs/{run} — runs.show

অনুমতি: runs:read

GET /api/v1/runs/{run}/results — runs.results

অনুমতি: runs:read

GET /api/v1/runs/{run}/export — runs.export

অনুমতি: runs:read

POST /api/v1/runs/{run}/pause — runs.pause

অনুমতি: runs:write

POST /api/v1/runs/{run}/resume — runs.resume

অনুমতি: runs:write

{
    "type": "object",
    "properties": {
        "retry_uncertain": {
            "type": "boolean",
            "const": true
        }
    },
    "required": [],
    "additionalProperties": false
}

অনুরোধের বডির উদাহরণ:

{
    "retry_uncertain": true
}
POST /api/v1/runs/{run}/cancel — runs.cancel

অনুমতি: runs:write

GET /api/v1/schedules — schedules.list

অনুমতি: schedules:read

POST /api/v1/schedules — schedules.create

অনুমতি: schedules:write

{
    "type": "object",
    "properties": {
        "project_ids": {
            "type": "array",
            "items": {
                "type": "integer",
                "minimum": 1
            },
            "minItems": 1,
            "maxItems": 100,
            "uniqueItems": true
        },
        "domain_ids": {
            "type": "object",
            "additionalProperties": {
                "type": "array",
                "items": {
                    "type": "integer",
                    "minimum": 1
                },
                "minItems": 1,
                "maxItems": 100,
                "uniqueItems": true
            }
        },
        "settings": {
            "$ref": "#/components/schemas/RankSettings"
        },
        "frequency": {
            "enum": [
                "daily",
                "weekly"
            ]
        },
        "weekdays": {
            "type": "array",
            "items": {
                "type": "integer",
                "minimum": 1,
                "maximum": 7
            },
            "uniqueItems": true
        },
        "local_time": {
            "type": "string",
            "pattern": "^\\d{2}:\\d{2}$"
        },
        "timezone": {
            "type": "string",
            "maxLength": 80
        },
        "enabled": {
            "type": "boolean"
        },
        "confirm_paid": {
            "type": "boolean",
            "const": true
        },
        "idempotency_key": {
            "type": "string",
            "maxLength": 100,
            "pattern": "^[a-zA-Z0-9._:-]+$"
        }
    },
    "required": [
        "project_ids",
        "frequency",
        "local_time",
        "timezone",
        "confirm_paid"
    ],
    "additionalProperties": false
}

অনুরোধের বডির উদাহরণ:

{
    "idempotency_key": "schedule-001",
    "project_ids": [
        1
    ],
    "frequency": "weekly",
    "weekdays": [
        1,
        3,
        5
    ],
    "local_time": "09:00",
    "timezone": "Europe/Moscow",
    "enabled": true,
    "confirm_paid": true
}
GET /api/v1/schedules/once — schedules.once_list

অনুমতি: schedules:read

POST /api/v1/schedules/once — schedules.once

অনুমতি: schedules:write

{
    "type": "object",
    "properties": {
        "project_ids": {
            "type": "array",
            "items": {
                "type": "integer",
                "minimum": 1
            },
            "minItems": 1,
            "maxItems": 100,
            "uniqueItems": true
        },
        "settings": {
            "$ref": "#/components/schemas/RankSettings"
        },
        "scheduled_for": {
            "type": "string",
            "maxLength": 30
        },
        "timezone": {
            "type": "string",
            "maxLength": 80
        },
        "offset": {
            "type": "string",
            "pattern": "^[+-]\\d{2}:\\d{2}$"
        },
        "confirm_paid": {
            "type": "boolean",
            "const": true
        },
        "idempotency_key": {
            "type": "string",
            "maxLength": 100,
            "pattern": "^[a-zA-Z0-9._:-]+$"
        }
    },
    "required": [
        "project_ids",
        "scheduled_for",
        "timezone",
        "confirm_paid"
    ],
    "additionalProperties": false
}

অনুরোধের বডির উদাহরণ:

{
    "idempotency_key": "once-001",
    "project_ids": [
        1
    ],
    "scheduled_for": "2027-01-20T09:00",
    "timezone": "Europe/Moscow",
    "confirm_paid": true
}
GET /api/v1/schedules/once/{schedule} — schedules.once_show

অনুমতি: schedules:read

PATCH /api/v1/schedules/once/{schedule} — schedules.once_update

অনুমতি: schedules:write

{
    "type": "object",
    "properties": {
        "scheduled_for": {
            "type": "string",
            "maxLength": 30
        },
        "timezone": {
            "type": "string",
            "maxLength": 80
        },
        "offset": {
            "type": "string",
            "pattern": "^[+-]\\d{2}:\\d{2}$"
        }
    },
    "required": [
        "scheduled_for",
        "timezone"
    ],
    "additionalProperties": false
}
DELETE /api/v1/schedules/once/{schedule} — schedules.once_delete

অনুমতি: schedules:write

GET /api/v1/schedules/{schedule} — schedules.show

অনুমতি: schedules:read

PATCH /api/v1/schedules/{schedule} — schedules.update

অনুমতি: schedules:write

{
    "type": "object",
    "properties": {
        "project_ids": {
            "type": "array",
            "items": {
                "type": "integer",
                "minimum": 1
            },
            "minItems": 1,
            "maxItems": 100,
            "uniqueItems": true
        },
        "domain_ids": {
            "type": "object",
            "additionalProperties": {
                "type": "array",
                "items": {
                    "type": "integer",
                    "minimum": 1
                },
                "minItems": 1,
                "maxItems": 100,
                "uniqueItems": true
            }
        },
        "settings": {
            "$ref": "#/components/schemas/RankSettings"
        },
        "frequency": {
            "enum": [
                "daily",
                "weekly"
            ]
        },
        "weekdays": {
            "type": "array",
            "items": {
                "type": "integer",
                "minimum": 1,
                "maximum": 7
            },
            "uniqueItems": true
        },
        "local_time": {
            "type": "string",
            "pattern": "^\\d{2}:\\d{2}$"
        },
        "timezone": {
            "type": "string",
            "maxLength": 80
        },
        "enabled": {
            "type": "boolean"
        },
        "confirm_paid": {
            "type": "boolean",
            "const": true
        },
        "idempotency_key": {
            "type": "string",
            "maxLength": 100,
            "pattern": "^[a-zA-Z0-9._:-]+$"
        }
    },
    "required": [],
    "additionalProperties": false
}
DELETE /api/v1/schedules/{schedule} — schedules.delete

অনুমতি: schedules:write

GET /api/v1/healthz — health.show

অনুমতি:

ত্রুটি ও সীমা

401: Bearer টোকেন নেই, মেয়াদ শেষ বা প্রত্যাহার করা। 403: অনুমতি কম বা অ্যাকাউন্ট নিষ্ক্রিয়/অযাচাইকৃত। 404: রিসোর্স অনুপলব্ধ, অন্য অ্যাকাউন্টের রিসোর্সও। 409: ইডেমপোটেন্সি দ্বন্দ্ব। 422: ইনপুট অবৈধ; errors ফিল্ড অনুযায়ী থাকে। 429: অনুরোধের সীমা পেরিয়েছে; Retry-After মানুন ও বিরতি বাড়ান। প্রতিক্রিয়া হারিয়েছে বলে সশুল্ক পুনঃচেষ্টায় নতুন ইডেমপোটেন্সি কী দেবেন না।

{"message":"The name field is required.","errors":{"name":["The name field is required."]}}

MCP

একই Bearer টোকেন দিয়ে Streamable HTTP-তে /mcp যুক্ত করুন। tools/list থেকে সঠিক টুল স্কিমা জানুন। নাম ওপরের অপারেশন ID অনুযায়ী; runs.start মানে runs.create। প্রোভাইডারের গোপন তথ্য ও টোকেন প্রশাসন MCP-তে নেই; অ্যাকাউন্ট বা পরিচয়পত্র REST এন্ডপয়েন্ট ব্যবহার করুন। পড়া ও লেখার অনুমতি আলাদা। সশুল্ক তৈরিতে সম্মতি ও ইডেমপোটেন্সি কী লাগে। পরিচয়পত্র কখনো ফেরত দেওয়া হয় না। MCP ক্লায়েন্টের তথ্য বদলানোর দরকার হলেই লেখার অনুমতি দিন।

curl -X POST 'https://serpo.one/mcp' \
 -H 'Authorization: Bearer TOKEN' -H 'Content-Type: application/json' \
 -H 'Accept: application/json, text/event-stream' \
 -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-11-25","capabilities":{},"clientInfo":{"name":"my-client","version":"1.0"}}}'