Donations are fundraising campaigns: a story, an optional target amount, predefined amounts to give and add-on options such as a gift.
Endpoints that need a token: the site owner creates it in their admin (Developers > API reference). AI assistants: how to ask the user for one.
8 endpoints in 2 parts: Donation, AI builder.
Returns the site's donations, newest first unless a sort is given.
Needs a signed-in user whose plan grants access.
Only donations with this published.
Only donations with this completed.
The order of the results.
Only results in this collection.
How many results to skip - for paging.
Only donations with this where.
Returns a list of Donation objects.
curl -X GET 'http://debate.bg/donations?ionic=true&published=...&completed=...&sortBy=...' \ -H 'Authorization: Bearer <TOKEN>'
[
{
"enabled": false,
"has_shippable_items": false,
"medias": [
{
"media": "6543210fedcba98765432100",
"gcs_url": "example-item",
"gcs_480_30_url": "example-item",
"gcs_720_30_url": "example-item",
"gcs_1080_30_url": "example-item",
"duration": 1,
"vimeo_uri": "example",
"vimeo_picture": "example",
"vimeo_url": "example-item",
"youtube_url": "example-item",
"youtube_picture": "example",
"thumbnail": "example",
"_id": "6543210fedcba98765432100"
}
],
"url": "example-item",
"static_url": "example-item",
"title": "Example",
"description": "Text shown on the site.",
"about_page": "6543210fedcba98765432100",
"collection_id": "6543210fedcba98765432100",
"topics": [
{
"collection_id": "6543210fedcba98765432100",
"_id": "6543210fedcba98765432100"
}
],
"owner_id": "6543210fedcba98765432100",
"options": [
{
"name": "Example",
"options": [],
"_id": "6543210fedcba98765432100"
}
],
"_id": "6543210fedcba98765432100",
"updatedAt": "2026-11-04T12:00:00.000Z",
"createdAt": "2026-11-04T12:00:00.000Z",
"target_amount": {
"enabled": false,
"amount": 0
},
"predefined_amounts": {
"enabled": false,
"amounts": "example"
}
}
]Creates a donation from the fields sent.
Needs a site admin token.
Name of the campaign, required.
Returns the Donation object.
curl -X POST 'http://debate.bg/donations?ionic=true' \
-H 'Authorization: Bearer <TOKEN>' \
-H 'Content-Type: application/json' \
-d '{ "title": "..." }'{
"enabled": false,
"has_shippable_items": false,
"medias": [
{
"media": "6543210fedcba98765432100",
"gcs_url": "example-item",
"gcs_480_30_url": "example-item",
"gcs_720_30_url": "example-item",
"gcs_1080_30_url": "example-item",
"duration": 1,
"vimeo_uri": "example",
"vimeo_picture": "example",
"vimeo_url": "example-item",
"youtube_url": "example-item",
"youtube_picture": "example",
"thumbnail": "example",
"_id": "6543210fedcba98765432100"
}
],
"url": "example-item",
"static_url": "example-item",
"title": "Example",
"description": "Text shown on the site.",
"about_page": "6543210fedcba98765432100",
"collection_id": "6543210fedcba98765432100",
"topics": [
{
"collection_id": "6543210fedcba98765432100",
"_id": "6543210fedcba98765432100"
}
],
"owner_id": "6543210fedcba98765432100",
"options": [
{
"name": "Example",
"options": [],
"_id": "6543210fedcba98765432100"
}
],
"_id": "6543210fedcba98765432100",
"updatedAt": "2026-11-04T12:00:00.000Z",
"createdAt": "2026-11-04T12:00:00.000Z",
"target_amount": {
"enabled": false,
"amount": 0
},
"predefined_amounts": {
"enabled": false,
"amounts": "example"
}
}Changes the fields sent; the others stay as they are.
Needs a site admin token.
The ID of the donation.
Returns the Donation object.
curl -X PATCH 'http://debate.bg/donations/{id}?ionic=true' \
-H 'Authorization: Bearer <TOKEN>'{
"enabled": false,
"has_shippable_items": false,
"medias": [
{
"media": "6543210fedcba98765432100",
"gcs_url": "example-item",
"gcs_480_30_url": "example-item",
"gcs_720_30_url": "example-item",
"gcs_1080_30_url": "example-item",
"duration": 1,
"vimeo_uri": "example",
"vimeo_picture": "example",
"vimeo_url": "example-item",
"youtube_url": "example-item",
"youtube_picture": "example",
"thumbnail": "example",
"_id": "6543210fedcba98765432100"
}
],
"url": "example-item",
"static_url": "example-item",
"title": "Example",
"description": "Text shown on the site.",
"about_page": "6543210fedcba98765432100",
"collection_id": "6543210fedcba98765432100",
"topics": [
{
"collection_id": "6543210fedcba98765432100",
"_id": "6543210fedcba98765432100"
}
],
"owner_id": "6543210fedcba98765432100",
"options": [
{
"name": "Example",
"options": [],
"_id": "6543210fedcba98765432100"
}
],
"_id": "6543210fedcba98765432100",
"updatedAt": "2026-11-04T12:00:00.000Z",
"createdAt": "2026-11-04T12:00:00.000Z",
"target_amount": {
"enabled": false,
"amount": 0
},
"predefined_amounts": {
"enabled": false,
"amounts": "example"
}
}Deletes the donation. This cannot be undone.
Needs a site admin token.
The ID of the donation.
Returns an empty answer on success.
curl -X DELETE 'http://debate.bg/donations/{id}?ionic=true' \
-H 'Authorization: Bearer <TOKEN>'Returns one donation, found by its URL slug.
Pages limited to some users check the token when one is sent.
The donation's URL slug, as in its address on the site.
Only donations with this session id.
Returns the Donation object.
curl -X GET 'http://debate.bg/donations/{url}?ionic=true&sessionId=...'{
"enabled": false,
"has_shippable_items": false,
"medias": [
{
"media": "6543210fedcba98765432100",
"gcs_url": "example-item",
"gcs_480_30_url": "example-item",
"gcs_720_30_url": "example-item",
"gcs_1080_30_url": "example-item",
"duration": 1,
"vimeo_uri": "example",
"vimeo_picture": "example",
"vimeo_url": "example-item",
"youtube_url": "example-item",
"youtube_picture": "example",
"thumbnail": "example",
"_id": "6543210fedcba98765432100"
}
],
"url": "example-item",
"static_url": "example-item",
"title": "Example",
"description": "Text shown on the site.",
"about_page": "6543210fedcba98765432100",
"collection_id": "6543210fedcba98765432100",
"topics": [
{
"collection_id": "6543210fedcba98765432100",
"_id": "6543210fedcba98765432100"
}
],
"owner_id": "6543210fedcba98765432100",
"options": [
{
"name": "Example",
"options": [],
"_id": "6543210fedcba98765432100"
}
],
"_id": "6543210fedcba98765432100",
"updatedAt": "2026-11-04T12:00:00.000Z",
"createdAt": "2026-11-04T12:00:00.000Z",
"target_amount": {
"enabled": false,
"amount": 0
},
"predefined_amounts": {
"enabled": false,
"amounts": "example"
}
}Create a donation from a prompt, written by the AI builder.
Needs the token of a signed-in user.
What the AI should do with the donation, in plain words - any language.
The AI chat this request belongs to; its history and language carry over. Leave it out to start a new chat.
Which version of the AI builder to use; leave it out for the current one.
The ID of the donation to change.
curl -X POST 'http://debate.bg/create-new-donation?ionic=true' \
-H 'Authorization: Bearer <TOKEN>' \
-H 'Content-Type: application/json' \
-d '{ "prompt": "...", "chatId": "...", "aiVersion": "...", "item_id": "..." }'{
"chat_id": "6543210fedcba98765432100",
"role": "user",
"text": "Text shown on the site.",
"target_url": "example-item",
"action": "RESPONSE",
"options": [
"example"
],
"medias": [
{
"media": "6543210fedcba98765432100",
"gcs_url": "example-item",
"gemini_uri": "example",
"gemini_interaction_id": "example",
"_id": "6543210fedcba98765432100"
}
],
"products": [
"6543210fedcba98765432101"
],
"services": [
"6543210fedcba98765432101"
],
"blogposts": [
"6543210fedcba98765432101"
],
"programs": [
"6543210fedcba98765432101"
],
"suggestions": [
{
"text": "Text shown on the site.",
"route": "example",
"item_id": "6543210fedcba98765432100",
"medias": [],
"picture": "6543210fedcba98765432100",
"_id": "6543210fedcba98765432100"
}
],
"is_system": false,
"_id": "6543210fedcba98765432100",
"updatedAt": "2026-11-04T12:00:00.000Z",
"createdAt": "2026-11-04T12:00:00.000Z",
"data": {
"object": "example",
"object_type": "example",
"edit_summary": "example",
"edit_diff": "example",
"undo_record": "example",
"hero_animation_offer": "example",
"preview_state": "example",
"pending_credit_cost": 0,
"target_restore": "example",
"media_request": "example",
"item_request": "example",
"reference_request": "example"
}
}Use it to create a new donation or fundraising campaign from scratch or a prompt.
Needs the token of a signed-in user.
What the AI should do with the donation, in plain words - any language.
The AI chat this request belongs to; its history and language carry over. Leave it out to start a new chat.
curl -X POST 'http://debate.bg/generate-donation?ionic=true' \
-H 'Authorization: Bearer <TOKEN>' \
-H 'Content-Type: application/json' \
-d '{ "prompt": "...", "chatId": "..." }'Use it to edit or update an existing donation campaign.
Needs the token of a signed-in user.
What the AI should do with the donation, in plain words - any language.
The current donation, as JSON - the AI changes it and returns the result.
The AI chat this request belongs to; its history and language carry over. Leave it out to start a new chat.
The ID of the donation to change.
The donation's item ids.
curl -X POST 'http://debate.bg/modify-donation?ionic=true' \
-H 'Authorization: Bearer <TOKEN>' \
-H 'Content-Type: application/json' \
-d '{ "prompt": "...", "item_data": "...", "chatId": "...", "item_id": "...", "item_ids": "..." }'