API ReferenceView as MarkdownOpenAPI

Site settings

View as Markdown

The site's settings: its name and contact details, the menu, the home page, publishing and app settings, payments, delivery and taxes.

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.

64 endpoints in 11 parts: Companion App Settings, Consent, Gdpr, Home Page Settings, Mycontact, Pwa Settings, Rating Settings, Site Menu, Social Mode Settings, Social Moderation Settings, AI builder.

List all companion app settings

Returns the site's companion app settings, newest first unless a sort is given.

Admin token

Needs a site admin token.

Status codes

200 401 500

GET/companion-app-settings
curl -X GET 'http://www.allsport.bg/companion-app-settings?ionic=true' \
  -H 'Authorization: Bearer <TOKEN>'

Create a companion app setting

Create new companion_app_settings.

Admin token

Needs a site admin token.

Status codes

201 400 401 500

POST/companion-app-settings
curl -X POST 'http://www.allsport.bg/companion-app-settings?ionic=true' \
  -H 'Authorization: Bearer <TOKEN>'

Retrieve a companion app setting

Returns one companion app setting, found by its ID.

Admin token

Needs a site admin token.

Path parameters
idstringRequired

The ID of the companion app setting.

Status codes

200 401 404 500

GET/companion-app-settings/:id
curl -X GET 'http://www.allsport.bg/companion-app-settings/{id}?ionic=true' \
  -H 'Authorization: Bearer <TOKEN>'

Update a companion app setting

Update CompanionAppSettings by id.

Admin token

Needs a site admin token.

Path parameters
idstringRequired

The ID of the companion app setting.

Status codes

200 400 401 404 500

PATCH/companion-app-settings/:id
curl -X PATCH 'http://www.allsport.bg/companion-app-settings/{id}?ionic=true' \
  -H 'Authorization: Bearer <TOKEN>'

Delete a companion app setting

Delete CompanionAppSettings record by id.

Admin token

Needs a site admin token.

Path parameters
idstringRequired

The ID of the companion app setting.

Returns

Returns an empty answer on success.

Status codes

200 401 404 500

DELETE/companion-app-settings/:id
curl -X DELETE 'http://www.allsport.bg/companion-app-settings/{id}?ionic=true' \
  -H 'Authorization: Bearer <TOKEN>'

Accept an accept consent

Log agreement.

Public

Public - no token needed.

Parameters
typestring

The accept consent's type.

Status codes

201 400 500

POST/accept-consent
curl -X POST 'http://www.allsport.bg/accept-consent?ionic=true' \
  -H 'Content-Type: application/json' \
  -d '{ "type": "..." }'
Response
{
  "url": "example-item",
  "ip": "example",
  "_id": "6543210fedcba98765432100",
  "updatedAt": "2026-11-04T12:00:00.000Z",
  "createdAt": "2026-11-04T12:00:00.000Z"
}

Create a consent

Create new terms of use.

Admin token

Needs a site admin token.

Returns

Returns the Consent object.

Status codes

201 400 401 500

POST/consent
curl -X POST 'http://www.allsport.bg/consent?ionic=true' \
  -H 'Authorization: Bearer <TOKEN>'
Response
{
  "title": "Example",
  "text": "Text shown on the site.",
  "_id": "6543210fedcba98765432100"
}

Retrieve the GDPR text

Get the terms of use text.

Public

Public - no token needed.

Status codes

200 500

GET/gdpr-text
curl -X GET 'http://www.allsport.bg/gdpr-text?ionic=true'
Response
{
  "text": "Text shown on the site.",
  "_id": "6543210fedcba98765432100"
}

List all gdprs

Returns the site's gdprs, newest first unless a sort is given.

Admin token

Needs a site admin token.

Returns

Returns a list of Gdpr objects.

Status codes

200 401 500

GET/gdprs
curl -X GET 'http://www.allsport.bg/gdprs?ionic=true' \
  -H 'Authorization: Bearer <TOKEN>'
Response
[
  {
    "text": "Text shown on the site.",
    "_id": "6543210fedcba98765432100"
  }
]

Create a gdpr

Create new terms of use.

Admin token

Needs a site admin token.

Returns

Returns the Gdpr object.

Status codes

201 400 401 500

POST/gdprs
curl -X POST 'http://www.allsport.bg/gdprs?ionic=true' \
  -H 'Authorization: Bearer <TOKEN>'
Response
{
  "text": "Text shown on the site.",
  "_id": "6543210fedcba98765432100"
}

Retrieve a gdpr

Returns one gdpr, found by its ID.

Public

Public - no token needed.

Path parameters
idstringRequired

The ID of the gdpr.

Returns

Returns the Gdpr object.

Status codes

200 404 500

GET/gdprs/:id
curl -X GET 'http://www.allsport.bg/gdprs/{id}?ionic=true'
Response
{
  "text": "Text shown on the site.",
  "_id": "6543210fedcba98765432100"
}

Update a gdpr

Update terms of use by id.

Admin token

Needs a site admin token.

Path parameters
idstringRequired

The ID of the gdpr.

Returns

Returns the Gdpr object.

Status codes

200 400 401 404 500

PATCH/gdprs/:id
curl -X PATCH 'http://www.allsport.bg/gdprs/{id}?ionic=true' \
  -H 'Authorization: Bearer <TOKEN>'
Response
{
  "text": "Text shown on the site.",
  "_id": "6543210fedcba98765432100"
}

List all home page settings

Returns the site's home page settings, newest first unless a sort is given.

Admin token

Needs a site admin token.

Returns

Returns a list of HomePageSettings objects.

Status codes

200 401 500

GET/home-page-settings
curl -X GET 'http://www.allsport.bg/home-page-settings?ionic=true' \
  -H 'Authorization: Bearer <TOKEN>'
Response
[
  {
    "useDifferentLayoutForApp": false,
    "_id": "6543210fedcba98765432100",
    "updatedAt": "2026-11-04T12:00:00.000Z",
    "createdAt": "2026-11-04T12:00:00.000Z"
  }
]

Update a home page setting

Changes the fields sent; the others stay as they are.

Admin token

Needs a site admin token.

Path parameters
idstringRequired

The ID of the home page setting.

Parameters
useDifferentLayoutForAppboolean

Whether the home page setting is use different layout for app.

Returns

Returns the HomePageSettings object.

Status codes

200 400 401 500

PATCH/home-page-settings/:id
curl -X PATCH 'http://www.allsport.bg/home-page-settings/{id}?ionic=true' \
  -H 'Authorization: Bearer <TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{ "useDifferentLayoutForApp": "..." }'
Response
{
  "useDifferentLayoutForApp": false,
  "_id": "6543210fedcba98765432100",
  "updatedAt": "2026-11-04T12:00:00.000Z",
  "createdAt": "2026-11-04T12:00:00.000Z"
}

List all site contacts

Returns the site's site contacts, newest first unless a sort is given.

Public

Public - no token needed.

Status codes

200 500

GET/mycontacts
curl -X GET 'http://www.allsport.bg/mycontacts?ionic=true'
Response
{
  "zip_code": "example",
  "city": "example",
  "address": "example",
  "contact": "example",
  "email": "jane@example.com",
  "google_app": "example",
  "workhours": "example",
  "logo": "6543210fedcba98765432100",
  "site_name": "Example",
  "domain": "example",
  "stock_domain": "example",
  "isMarket": false,
  "forbidden_collections": [
    {
      "collection_id": "6543210fedcba98765432100",
      "_id": "6543210fedcba98765432100"
    }
  ],
  "isInit": false,
  "template": "0000",
  "lang": "en",
  "favicon": "6543210fedcba98765432100",
  "cacheEnabled": false,
  "has_completed_startup_prompt": true,
  "gmb_location": "example",
  "ga_property": "example",
  "site_generated_at": "2026-11-04T12:00:00.000Z",
  "admin_first_opened_at": "2026-11-04T12:00:00.000Z",
  "admin_last_opened_at": "2026-11-04T12:00:00.000Z",
  "allowedComponents": {
    "services": false,
    "products": false,
    "blogposts": false,
    "programs": false
  }
}

Create a site contact

Create new mycontacts.

Admin token

Needs a site admin token.

Status codes

201 400 401 500

POST/mycontacts
curl -X POST 'http://www.allsport.bg/mycontacts?ionic=true' \
  -H 'Authorization: Bearer <TOKEN>'
Response
{
  "zip_code": "example",
  "city": "example",
  "address": "example",
  "contact": "example",
  "email": "jane@example.com",
  "google_app": "example",
  "workhours": "example",
  "logo": "6543210fedcba98765432100",
  "site_name": "Example",
  "domain": "example",
  "stock_domain": "example",
  "isMarket": false,
  "forbidden_collections": [
    {
      "collection_id": "6543210fedcba98765432100",
      "_id": "6543210fedcba98765432100"
    }
  ],
  "isInit": false,
  "template": "0000",
  "lang": "en",
  "favicon": "6543210fedcba98765432100",
  "cacheEnabled": false,
  "has_completed_startup_prompt": true,
  "gmb_location": "example",
  "ga_property": "example",
  "site_generated_at": "2026-11-04T12:00:00.000Z",
  "admin_first_opened_at": "2026-11-04T12:00:00.000Z",
  "admin_last_opened_at": "2026-11-04T12:00:00.000Z",
  "allowedComponents": {
    "services": false,
    "products": false,
    "blogposts": false,
    "programs": false
  }
}

Retrieve a site contact

Returns one site contact, found by its ID.

Public

Public - no token needed.

Path parameters
idstringRequired

The ID of the site contact.

Status codes

200 404 500

GET/mycontacts/:id
curl -X GET 'http://www.allsport.bg/mycontacts/{id}?ionic=true'
Response
{
  "zip_code": "example",
  "city": "example",
  "address": "example",
  "contact": "example",
  "email": "jane@example.com",
  "google_app": "example",
  "workhours": "example",
  "logo": "6543210fedcba98765432100",
  "site_name": "Example",
  "domain": "example",
  "stock_domain": "example",
  "isMarket": false,
  "forbidden_collections": [
    {
      "collection_id": "6543210fedcba98765432100",
      "_id": "6543210fedcba98765432100"
    }
  ],
  "isInit": false,
  "template": "0000",
  "lang": "en",
  "favicon": "6543210fedcba98765432100",
  "cacheEnabled": false,
  "has_completed_startup_prompt": true,
  "gmb_location": "example",
  "ga_property": "example",
  "site_generated_at": "2026-11-04T12:00:00.000Z",
  "admin_first_opened_at": "2026-11-04T12:00:00.000Z",
  "admin_last_opened_at": "2026-11-04T12:00:00.000Z",
  "allowedComponents": {
    "services": false,
    "products": false,
    "blogposts": false,
    "programs": false
  }
}

Update a site contact

Update MyContact by id.

Admin token

Needs a site admin token.

Path parameters
idstringRequired

The ID of the site contact.

Parameters
gmb_locationstring

The site contact's Google Business Profile location.

ga_propertystring

The site contact's Google Analytics property.

google_appstring

The site contact's google app.

Status codes

200 400 401 404 500

PATCH/mycontacts/:id
curl -X PATCH 'http://www.allsport.bg/mycontacts/{id}?ionic=true' \
  -H 'Authorization: Bearer <TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{ "gmb_location": "...", "ga_property": "...", "google_app": "..." }'
Response
{
  "zip_code": "example",
  "city": "example",
  "address": "example",
  "contact": "example",
  "email": "jane@example.com",
  "google_app": "example",
  "workhours": "example",
  "logo": "6543210fedcba98765432100",
  "site_name": "Example",
  "domain": "example",
  "stock_domain": "example",
  "isMarket": false,
  "forbidden_collections": [
    {
      "collection_id": "6543210fedcba98765432100",
      "_id": "6543210fedcba98765432100"
    }
  ],
  "isInit": false,
  "template": "0000",
  "lang": "en",
  "favicon": "6543210fedcba98765432100",
  "cacheEnabled": false,
  "has_completed_startup_prompt": true,
  "gmb_location": "example",
  "ga_property": "example",
  "site_generated_at": "2026-11-04T12:00:00.000Z",
  "admin_first_opened_at": "2026-11-04T12:00:00.000Z",
  "admin_last_opened_at": "2026-11-04T12:00:00.000Z",
  "allowedComponents": {
    "services": false,
    "products": false,
    "blogposts": false,
    "programs": false
  }
}

Delete a site contact

Delete MyContact record by id.

Admin token

Needs a site admin token.

Path parameters
idstringRequired

The ID of the site contact.

Returns

Returns an empty answer on success.

Status codes

200 401 404 500

DELETE/mycontacts/:id
curl -X DELETE 'http://www.allsport.bg/mycontacts/{id}?ionic=true' \
  -H 'Authorization: Bearer <TOKEN>'

List all app settings

Returns the site's app settings, newest first unless a sort is given.

Admin token

Needs a site admin token.

Status codes

200 401 500

GET/pwa-settings
curl -X GET 'http://www.allsport.bg/pwa-settings?ionic=true' \
  -H 'Authorization: Bearer <TOKEN>'
Response
{
  "name": "Example",
  "short_name": "Example",
  "logo": "6543210fedcba98765432100",
  "background_color": "#3557c4",
  "description": "Text shown on the site.",
  "screenshots": [
    {
      "media": "6543210fedcba98765432100",
      "is_mobile_preview": false,
      "_id": "6543210fedcba98765432100"
    }
  ],
  "_id": "6543210fedcba98765432100",
  "updatedAt": "2026-11-04T12:00:00.000Z",
  "createdAt": "2026-11-04T12:00:00.000Z"
}

Create an app setting

Create new pwaSettings.

Admin token

Needs a site admin token.

Status codes

201 400 401 500

POST/pwa-settings
curl -X POST 'http://www.allsport.bg/pwa-settings?ionic=true' \
  -H 'Authorization: Bearer <TOKEN>'
Response
{
  "name": "Example",
  "short_name": "Example",
  "logo": "6543210fedcba98765432100",
  "background_color": "#3557c4",
  "description": "Text shown on the site.",
  "screenshots": [
    {
      "media": "6543210fedcba98765432100",
      "is_mobile_preview": false,
      "_id": "6543210fedcba98765432100"
    }
  ],
  "_id": "6543210fedcba98765432100",
  "updatedAt": "2026-11-04T12:00:00.000Z",
  "createdAt": "2026-11-04T12:00:00.000Z"
}

Retrieve an app setting

Returns one app setting, found by its ID.

Admin token

Needs a site admin token.

Path parameters
idstringRequired

The ID of the app setting.

Status codes

200 401 404 500

GET/pwa-settings/:id
curl -X GET 'http://www.allsport.bg/pwa-settings/{id}?ionic=true' \
  -H 'Authorization: Bearer <TOKEN>'
Response
{
  "name": "Example",
  "short_name": "Example",
  "logo": "6543210fedcba98765432100",
  "background_color": "#3557c4",
  "description": "Text shown on the site.",
  "screenshots": [
    {
      "media": "6543210fedcba98765432100",
      "is_mobile_preview": false,
      "_id": "6543210fedcba98765432100"
    }
  ],
  "_id": "6543210fedcba98765432100",
  "updatedAt": "2026-11-04T12:00:00.000Z",
  "createdAt": "2026-11-04T12:00:00.000Z"
}

List all rating settings

Returns the site's rating settings, newest first unless a sort is given.

Public

Public - no token needed.

Returns

Returns a list of RatingSettings objects.

Status codes

200 500

GET/rating-settings
curl -X GET 'http://www.allsport.bg/rating-settings?ionic=true'
Response
[
  {
    "type": "example",
    "send": false,
    "days": 1,
    "title": "Example",
    "text1": "Text shown on the site.",
    "text2": "Text shown on the site.",
    "useCustomLink": false,
    "customLinkUrl": "example-item",
    "linkText": "example-item",
    "startDate": "2026-11-04T12:00:00.000Z",
    "_id": "6543210fedcba98765432100",
    "updatedAt": "2026-11-04T12:00:00.000Z",
    "createdAt": "2026-11-04T12:00:00.000Z"
  }
]

Create a rating setting

Creates a rating setting from the fields sent.

User token

Needs the token of a signed-in user.

Returns

Returns the RatingSettings object.

Status codes

201 400 401 500

POST/rating-settings/
curl -X POST 'http://www.allsport.bg/rating-settings/?ionic=true' \
  -H 'Authorization: Bearer <TOKEN>'
Response
{
  "type": "example",
  "send": false,
  "days": 1,
  "title": "Example",
  "text1": "Text shown on the site.",
  "text2": "Text shown on the site.",
  "useCustomLink": false,
  "customLinkUrl": "example-item",
  "linkText": "example-item",
  "startDate": "2026-11-04T12:00:00.000Z",
  "_id": "6543210fedcba98765432100",
  "updatedAt": "2026-11-04T12:00:00.000Z",
  "createdAt": "2026-11-04T12:00:00.000Z"
}

Update a rating setting

Changes the fields sent; the others stay as they are.

User token

Needs the token of a signed-in user.

Path parameters
idstringRequired

The ID of the rating setting.

Parameters
sendboolean

Whether the rating setting is send.

Returns

Returns the RatingSettings object.

Status codes

200 400 401 500

PATCH/rating-settings/:id
curl -X PATCH 'http://www.allsport.bg/rating-settings/{id}?ionic=true' \
  -H 'Authorization: Bearer <TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{ "send": "..." }'
Response
{
  "type": "example",
  "send": false,
  "days": 1,
  "title": "Example",
  "text1": "Text shown on the site.",
  "text2": "Text shown on the site.",
  "useCustomLink": false,
  "customLinkUrl": "example-item",
  "linkText": "example-item",
  "startDate": "2026-11-04T12:00:00.000Z",
  "_id": "6543210fedcba98765432100",
  "updatedAt": "2026-11-04T12:00:00.000Z",
  "createdAt": "2026-11-04T12:00:00.000Z"
}

List all rating settings

Returns the site's rating settings, newest first unless a sort is given.

User token

Needs the token of a signed-in user.

Path parameters
typestringRequired

The rating setting's type.

Returns

Returns a list of RatingSettings objects.

Status codes

200 401 500

GET/rating-settings/:type
curl -X GET 'http://www.allsport.bg/rating-settings/{type}?ionic=true' \
  -H 'Authorization: Bearer <TOKEN>'
Response
[
  {
    "type": "example",
    "send": false,
    "days": 1,
    "title": "Example",
    "text1": "Text shown on the site.",
    "text2": "Text shown on the site.",
    "useCustomLink": false,
    "customLinkUrl": "example-item",
    "linkText": "example-item",
    "startDate": "2026-11-04T12:00:00.000Z",
    "_id": "6543210fedcba98765432100",
    "updatedAt": "2026-11-04T12:00:00.000Z",
    "createdAt": "2026-11-04T12:00:00.000Z"
  }
]

List all possible site menus

Returns the site's possible site menus, newest first unless a sort is given.

Public

Public - no token needed.

Returns

Returns a list of SiteMenu objects.

Status codes

200 500

GET/all_possible_site_menus
curl -X GET 'http://www.allsport.bg/all_possible_site_menus?ionic=true'
Response
[
  {
    "title": "Example",
    "url": "example-item",
    "position": 1,
    "submenus": [
      {
        "title": "Example",
        "url": "example-item",
        "position": 1,
        "_id": "6543210fedcba98765432100"
      }
    ],
    "customDropdown": false,
    "customDropdownId": "6543210fedcba98765432100",
    "sideMenu": false,
    "sidemenus": [
      {
        "title": "Example",
        "submenus": [],
        "_id": "6543210fedcba98765432100"
      }
    ],
    "icon": "example",
    "_id": "6543210fedcba98765432100"
  }
]

List all site menus

Returns the site's site menus, newest first unless a sort is given.

Public

Public - no token needed.

Returns

Returns a list of SiteMenu objects.

Status codes

200 500

GET/site_menus
curl -X GET 'http://www.allsport.bg/site_menus?ionic=true'
Response
[
  {
    "title": "Example",
    "url": "example-item",
    "position": 1,
    "submenus": [
      {
        "title": "Example",
        "url": "example-item",
        "position": 1,
        "_id": "6543210fedcba98765432100"
      }
    ],
    "customDropdown": false,
    "customDropdownId": "6543210fedcba98765432100",
    "sideMenu": false,
    "sidemenus": [
      {
        "title": "Example",
        "submenus": [],
        "_id": "6543210fedcba98765432100"
      }
    ],
    "icon": "example",
    "_id": "6543210fedcba98765432100"
  }
]

Create a site menu

Create new site_menu.

Admin token

Needs a site admin token.

Returns

Returns the SiteMenu object.

Status codes

201 400 401 500

POST/site_menus
curl -X POST 'http://www.allsport.bg/site_menus?ionic=true' \
  -H 'Authorization: Bearer <TOKEN>'
Response
{
  "title": "Example",
  "url": "example-item",
  "position": 1,
  "submenus": [
    {
      "title": "Example",
      "url": "example-item",
      "position": 1,
      "_id": "6543210fedcba98765432100"
    }
  ],
  "customDropdown": false,
  "customDropdownId": "6543210fedcba98765432100",
  "sideMenu": false,
  "sidemenus": [
    {
      "title": "Example",
      "submenus": [],
      "_id": "6543210fedcba98765432100"
    }
  ],
  "icon": "example",
  "_id": "6543210fedcba98765432100"
}

Retrieve a site menu

Returns one site menu, found by its ID.

Public

Public - no token needed.

Path parameters
idstringRequired

The ID of the site menu.

Returns

Returns the SiteMenu object.

Status codes

200 404 500

GET/site_menus/:id
curl -X GET 'http://www.allsport.bg/site_menus/{id}?ionic=true'
Response
{
  "title": "Example",
  "url": "example-item",
  "position": 1,
  "submenus": [
    {
      "title": "Example",
      "url": "example-item",
      "position": 1,
      "_id": "6543210fedcba98765432100"
    }
  ],
  "customDropdown": false,
  "customDropdownId": "6543210fedcba98765432100",
  "sideMenu": false,
  "sidemenus": [
    {
      "title": "Example",
      "submenus": [],
      "_id": "6543210fedcba98765432100"
    }
  ],
  "icon": "example",
  "_id": "6543210fedcba98765432100"
}

Update a site menu

Update SiteMenu by id.

Admin token

Needs a site admin token.

Path parameters
idstringRequired

The ID of the site menu.

Returns

Returns the SiteMenu object.

Status codes

200 400 401 404 500

PATCH/site_menus/:id
curl -X PATCH 'http://www.allsport.bg/site_menus/{id}?ionic=true' \
  -H 'Authorization: Bearer <TOKEN>'
Response
{
  "title": "Example",
  "url": "example-item",
  "position": 1,
  "submenus": [
    {
      "title": "Example",
      "url": "example-item",
      "position": 1,
      "_id": "6543210fedcba98765432100"
    }
  ],
  "customDropdown": false,
  "customDropdownId": "6543210fedcba98765432100",
  "sideMenu": false,
  "sidemenus": [
    {
      "title": "Example",
      "submenus": [],
      "_id": "6543210fedcba98765432100"
    }
  ],
  "icon": "example",
  "_id": "6543210fedcba98765432100"
}

Delete a site menu

Delete SiteMenu record by id.

Admin token

Needs a site admin token.

Path parameters
idstringRequired

The ID of the site menu.

Returns

Returns an empty answer on success.

Status codes

200 401 404 500

DELETE/site_menus/:id
curl -X DELETE 'http://www.allsport.bg/site_menus/{id}?ionic=true' \
  -H 'Authorization: Bearer <TOKEN>'

Retrieve the site menu

Returns the site menu.

Public

Public - no token needed.

Status codes

200 500

GET/site_menus/ionic
curl -X GET 'http://www.allsport.bg/site_menus/ionic?ionic=true'
Response
{
  "name": "Example",
  "parent_collection": "6543210fedcba98765432100",
  "picture": "6543210fedcba98765432100",
  "about_page": "6543210fedcba98765432100",
  "match_to_option": false,
  "is_color": false,
  "color": "#3557c4",
  "position": 1,
  "items": [
    "6543210fedcba98765432101"
  ],
  "thumbnail": "6543210fedcba98765432100",
  "_id": "6543210fedcba98765432100"
}

List all social mode settings

Returns the site's social mode settings, newest first unless a sort is given.

Public

Public - no token needed.

Returns

Returns a list of SocialModeSettings objects.

Status codes

200 500

GET/social-mode-settings
curl -X GET 'http://www.allsport.bg/social-mode-settings?ionic=true'
Response
[
  {
    "social_mode": false,
    "allow_products": false,
    "allow_services": false,
    "allow_services_stp": false,
    "allow_blogposts": false,
    "allow_programs": false,
    "allow_programs_stp": false,
    "allow_posts": false,
    "allow_ai": false,
    "allow_bites": false,
    "allow_long_videos": false,
    "allow_explore": false,
    "allow_online_payments": false,
    "allow_price_plans": false,
    "allow_boosting_posts": false,
    "allow_single_ai": false,
    "merchant_agreement": "6543210fedcba98765432100",
    "verification_popup": "6543210fedcba98765432100",
    "commission": 1,
    "home_page": "home",
    "allow_google_login": true,
    "use_cdn_for_medias": false,
    "cdn_for_medias": "example",
    "use_cdn_for_microservices": false,
    "navigation_pages": {
      "bites": false,
      "long_videos": false,
      "vouchers": false,
      "store": false,
      "programs": false,
      "services": false,
      "blogposts": false,
      "subscription": false,
      "playlists": false,
      "partners": false,
      "contacts": false,
      "tracker": false
    }
  }
]

Create a social mode setting

Create new SocialModeSettings.

Admin token

Needs a site admin token.

Returns

Returns the SocialModeSettings object.

Status codes

201 400 401 500

POST/social-mode-settings
curl -X POST 'http://www.allsport.bg/social-mode-settings?ionic=true' \
  -H 'Authorization: Bearer <TOKEN>'
Response
{
  "social_mode": false,
  "allow_products": false,
  "allow_services": false,
  "allow_services_stp": false,
  "allow_blogposts": false,
  "allow_programs": false,
  "allow_programs_stp": false,
  "allow_posts": false,
  "allow_ai": false,
  "allow_bites": false,
  "allow_long_videos": false,
  "allow_explore": false,
  "allow_online_payments": false,
  "allow_price_plans": false,
  "allow_boosting_posts": false,
  "allow_single_ai": false,
  "merchant_agreement": "6543210fedcba98765432100",
  "verification_popup": "6543210fedcba98765432100",
  "commission": 1,
  "home_page": "home",
  "allow_google_login": true,
  "use_cdn_for_medias": false,
  "cdn_for_medias": "example",
  "use_cdn_for_microservices": false,
  "navigation_pages": {
    "bites": false,
    "long_videos": false,
    "vouchers": false,
    "store": false,
    "programs": false,
    "services": false,
    "blogposts": false,
    "subscription": false,
    "playlists": false,
    "partners": false,
    "contacts": false,
    "tracker": false
  }
}

Update a social mode setting

Update SocialModeSettings by id.

Admin token

Needs a site admin token.

Path parameters
idstringRequired

The ID of the social mode setting.

Returns

Returns the SocialModeSettings object.

Status codes

200 400 401 404 500

PATCH/social-mode-settings/:id
curl -X PATCH 'http://www.allsport.bg/social-mode-settings/{id}?ionic=true' \
  -H 'Authorization: Bearer <TOKEN>'
Response
{
  "social_mode": false,
  "allow_products": false,
  "allow_services": false,
  "allow_services_stp": false,
  "allow_blogposts": false,
  "allow_programs": false,
  "allow_programs_stp": false,
  "allow_posts": false,
  "allow_ai": false,
  "allow_bites": false,
  "allow_long_videos": false,
  "allow_explore": false,
  "allow_online_payments": false,
  "allow_price_plans": false,
  "allow_boosting_posts": false,
  "allow_single_ai": false,
  "merchant_agreement": "6543210fedcba98765432100",
  "verification_popup": "6543210fedcba98765432100",
  "commission": 1,
  "home_page": "home",
  "allow_google_login": true,
  "use_cdn_for_medias": false,
  "cdn_for_medias": "example",
  "use_cdn_for_microservices": false,
  "navigation_pages": {
    "bites": false,
    "long_videos": false,
    "vouchers": false,
    "store": false,
    "programs": false,
    "services": false,
    "blogposts": false,
    "subscription": false,
    "playlists": false,
    "partners": false,
    "contacts": false,
    "tracker": false
  }
}

Delete a social mode setting

Delete SocialModeSettings record by id.

Admin token

Needs a site admin token.

Path parameters
idstringRequired

The ID of the social mode setting.

Returns

Returns an empty answer on success.

Status codes

200 401 404 500

DELETE/social-mode-settings/:id
curl -X DELETE 'http://www.allsport.bg/social-mode-settings/{id}?ionic=true' \
  -H 'Authorization: Bearer <TOKEN>'

Retrieve the unlocked content

Returns the unlocked content.

Optional user

Works without a token; with a user token the answer is personal.

Status codes

200 500

GET/unlocked-content
curl -X GET 'http://www.allsport.bg/unlocked-content?ionic=true'
Response
{
  "social_mode": false,
  "allow_products": false,
  "allow_services": false,
  "allow_services_stp": false,
  "allow_blogposts": false,
  "allow_programs": false,
  "allow_programs_stp": false,
  "allow_posts": false,
  "allow_ai": false,
  "allow_bites": false,
  "allow_long_videos": false,
  "allow_explore": false,
  "allow_online_payments": false,
  "allow_price_plans": false,
  "allow_boosting_posts": false,
  "allow_single_ai": false,
  "merchant_agreement": "6543210fedcba98765432100",
  "verification_popup": "6543210fedcba98765432100",
  "commission": 1,
  "home_page": "home",
  "allow_google_login": true,
  "use_cdn_for_medias": false,
  "cdn_for_medias": "example",
  "use_cdn_for_microservices": false,
  "navigation_pages": {
    "bites": false,
    "long_videos": false,
    "vouchers": false,
    "store": false,
    "programs": false,
    "services": false,
    "blogposts": false,
    "subscription": false,
    "playlists": false,
    "partners": false,
    "contacts": false,
    "tracker": false
  }
}

Connect the social

Connect the social.

User token

Needs the token of a signed-in user.

Parameters
pageIdstring

The social's page id.

grantedScopesstring

The social's granted scopes.

deleteCommentsstring

The social's delete comments.

Status codes

200 400 401 500

POST/social/connect
curl -X POST 'http://www.allsport.bg/social/connect?ionic=true' \
  -H 'Authorization: Bearer <TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{ "pageId": "...", "grantedScopes": "...", "deleteComments": "..." }'
Response
{
  "platform": "facebook",
  "page_id": "example",
  "page_name": "Example",
  "connected_by": "6543210fedcba98765432100",
  "last_polled_at": "2026-11-04T12:00:00.000Z",
  "replies_disabled_at": "2026-11-04T12:00:00.000Z",
  "enabled": false,
  "auto_threshold": 0.9,
  "custom_instructions": "example",
  "auto_action": false,
  "allow_auto_delete": false,
  "auto_reply": false,
  "auto_post_replies": false,
  "reply_instructions": "example",
  "notify_new_comments": false,
  "start_date": "2026-11-04T12:00:00.000Z",
  "message_instructions": "example",
  "granted_scopes": [
    "example"
  ],
  "instagram_user_id": "example",
  "instagram_username": "Example",
  "_id": "6543210fedcba98765432100",
  "updatedAt": "2026-11-04T12:00:00.000Z",
  "createdAt": "2026-11-04T12:00:00.000Z",
  "sources": {
    "facebook_posts": false,
    "facebook_reviews": false,
    "instagram_comments": false,
    "facebook_messages": false,
    "instagram_messages": false
  }
}

Disconnect the social

Disconnect the social.

User token

Needs the token of a signed-in user.

Parameters
deleteCommentsstring

The social's delete comments.

Status codes

200 400 401 404 500

POST/social/disconnect
curl -X POST 'http://www.allsport.bg/social/disconnect?ionic=true' \
  -H 'Authorization: Bearer <TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{ "deleteComments": "..." }'
Response
{
  "platform": "facebook",
  "page_id": "example",
  "page_name": "Example",
  "connected_by": "6543210fedcba98765432100",
  "last_polled_at": "2026-11-04T12:00:00.000Z",
  "replies_disabled_at": "2026-11-04T12:00:00.000Z",
  "enabled": false,
  "auto_threshold": 0.9,
  "custom_instructions": "example",
  "auto_action": false,
  "allow_auto_delete": false,
  "auto_reply": false,
  "auto_post_replies": false,
  "reply_instructions": "example",
  "notify_new_comments": false,
  "start_date": "2026-11-04T12:00:00.000Z",
  "message_instructions": "example",
  "granted_scopes": [
    "example"
  ],
  "instagram_user_id": "example",
  "instagram_username": "Example",
  "_id": "6543210fedcba98765432100",
  "updatedAt": "2026-11-04T12:00:00.000Z",
  "createdAt": "2026-11-04T12:00:00.000Z",
  "sources": {
    "facebook_posts": false,
    "facebook_reviews": false,
    "instagram_comments": false,
    "facebook_messages": false,
    "instagram_messages": false
  }
}

Retrieve the social

Returns the social. TEMPORARY. Delete once Instagram messages are settled. Asks Graph the conversations question directly, with the stored Page token and none of our own filtering, across both platforms and both folders. The sync reports zero Instagram conversations while Messenger returns thirteen from the same call and the same token; this shows what Meta actually answers, including the raw error when it refuses rather than returning empty.

User token

Needs the token of a signed-in user.

Status codes

200 400 401 404 500

GET/social/messages-probe
curl -X GET 'http://www.allsport.bg/social/messages-probe?ionic=true' \
  -H 'Authorization: Bearer <TOKEN>'
Response
{
  "platform": "facebook",
  "page_id": "example",
  "page_name": "Example",
  "connected_by": "6543210fedcba98765432100",
  "last_polled_at": "2026-11-04T12:00:00.000Z",
  "replies_disabled_at": "2026-11-04T12:00:00.000Z",
  "enabled": false,
  "auto_threshold": 0.9,
  "custom_instructions": "example",
  "auto_action": false,
  "allow_auto_delete": false,
  "auto_reply": false,
  "auto_post_replies": false,
  "reply_instructions": "example",
  "notify_new_comments": false,
  "start_date": "2026-11-04T12:00:00.000Z",
  "message_instructions": "example",
  "granted_scopes": [
    "example"
  ],
  "instagram_user_id": "example",
  "instagram_username": "Example",
  "_id": "6543210fedcba98765432100",
  "updatedAt": "2026-11-04T12:00:00.000Z",
  "createdAt": "2026-11-04T12:00:00.000Z",
  "sources": {
    "facebook_posts": false,
    "facebook_reviews": false,
    "instagram_comments": false,
    "facebook_messages": false,
    "instagram_messages": false
  }
}

Retrieve the social

Returns the social.

User token

Needs the token of a signed-in user.

Query parameters
limitstring

How many results to return.

Status codes

200 401 404 500

GET/social/queue
curl -X GET 'http://www.allsport.bg/social/queue?ionic=true&limit=...' \
  -H 'Authorization: Bearer <TOKEN>'
Response
{
  "platform": "facebook",
  "page_id": "example",
  "page_name": "Example",
  "connected_by": "6543210fedcba98765432100",
  "last_polled_at": "2026-11-04T12:00:00.000Z",
  "replies_disabled_at": "2026-11-04T12:00:00.000Z",
  "enabled": false,
  "auto_threshold": 0.9,
  "custom_instructions": "example",
  "auto_action": false,
  "allow_auto_delete": false,
  "auto_reply": false,
  "auto_post_replies": false,
  "reply_instructions": "example",
  "notify_new_comments": false,
  "start_date": "2026-11-04T12:00:00.000Z",
  "message_instructions": "example",
  "granted_scopes": [
    "example"
  ],
  "instagram_user_id": "example",
  "instagram_username": "Example",
  "_id": "6543210fedcba98765432100",
  "updatedAt": "2026-11-04T12:00:00.000Z",
  "createdAt": "2026-11-04T12:00:00.000Z",
  "sources": {
    "facebook_posts": false,
    "facebook_reviews": false,
    "instagram_comments": false,
    "facebook_messages": false,
    "instagram_messages": false
  }
}

Approve the social

Approve the social.

User token

Needs the token of a signed-in user.

Path parameters
idstringRequired

The ID of the social.

Parameters
reply_messagestring

The social's reply message.

actionstring

The social's action.

Status codes

200 400 401 404 410 500

POST/social/queue/:id/approve
curl -X POST 'http://www.allsport.bg/social/queue/{id}/approve?ionic=true' \
  -H 'Authorization: Bearer <TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{ "reply_message": "...", "action": "..." }'
Response
{
  "platform": "facebook",
  "page_id": "example",
  "page_name": "Example",
  "connected_by": "6543210fedcba98765432100",
  "last_polled_at": "2026-11-04T12:00:00.000Z",
  "replies_disabled_at": "2026-11-04T12:00:00.000Z",
  "enabled": false,
  "auto_threshold": 0.9,
  "custom_instructions": "example",
  "auto_action": false,
  "allow_auto_delete": false,
  "auto_reply": false,
  "auto_post_replies": false,
  "reply_instructions": "example",
  "notify_new_comments": false,
  "start_date": "2026-11-04T12:00:00.000Z",
  "message_instructions": "example",
  "granted_scopes": [
    "example"
  ],
  "instagram_user_id": "example",
  "instagram_username": "Example",
  "_id": "6543210fedcba98765432100",
  "updatedAt": "2026-11-04T12:00:00.000Z",
  "createdAt": "2026-11-04T12:00:00.000Z",
  "sources": {
    "facebook_posts": false,
    "facebook_reviews": false,
    "instagram_comments": false,
    "facebook_messages": false,
    "instagram_messages": false
  }
}

Create a social

Creates a social from the fields sent.

User token

Needs the token of a signed-in user.

Path parameters
idstringRequired

The ID of the social.

Status codes

200 400 401 404 500

POST/social/queue/:id/regenerate-reply
curl -X POST 'http://www.allsport.bg/social/queue/{id}/regenerate-reply?ionic=true' \
  -H 'Authorization: Bearer <TOKEN>'
Response
{
  "platform": "facebook",
  "page_id": "example",
  "page_name": "Example",
  "connected_by": "6543210fedcba98765432100",
  "last_polled_at": "2026-11-04T12:00:00.000Z",
  "replies_disabled_at": "2026-11-04T12:00:00.000Z",
  "enabled": false,
  "auto_threshold": 0.9,
  "custom_instructions": "example",
  "auto_action": false,
  "allow_auto_delete": false,
  "auto_reply": false,
  "auto_post_replies": false,
  "reply_instructions": "example",
  "notify_new_comments": false,
  "start_date": "2026-11-04T12:00:00.000Z",
  "message_instructions": "example",
  "granted_scopes": [
    "example"
  ],
  "instagram_user_id": "example",
  "instagram_username": "Example",
  "_id": "6543210fedcba98765432100",
  "updatedAt": "2026-11-04T12:00:00.000Z",
  "createdAt": "2026-11-04T12:00:00.000Z",
  "sources": {
    "facebook_posts": false,
    "facebook_reviews": false,
    "instagram_comments": false,
    "facebook_messages": false,
    "instagram_messages": false
  }
}

Reject the social

Reject the social.

User token

Needs the token of a signed-in user.

Path parameters
idstringRequired

The ID of the social.

Status codes

200 400 401 404 500

POST/social/queue/:id/reject
curl -X POST 'http://www.allsport.bg/social/queue/{id}/reject?ionic=true' \
  -H 'Authorization: Bearer <TOKEN>'
Response
{
  "platform": "facebook",
  "kind": "comment",
  "conversation_id": "example",
  "window_expires_at": "2026-11-04T12:00:00.000Z",
  "page_id": "example",
  "comment_id": "example",
  "post_id": "example",
  "post_url": "example-item",
  "post_message": "example",
  "post_links": [
    {
      "url": "example-item",
      "title": "Example"
    }
  ],
  "parent_id": "example",
  "page_replied": false,
  "post_type": "organic",
  "message": "example",
  "author_id": "example",
  "author_name": "Example",
  "comment_created_at": "2026-11-04T12:00:00.000Z",
  "suggested_action": "example",
  "reply_message": "example",
  "status": "new",
  "action_taken": "example",
  "actioned_by": "example",
  "actioned_at": "2026-11-04T12:00:00.000Z",
  "reply_comment_id": "example",
  "classification": {
    "category": "example",
    "score": 0,
    "should_reply": false,
    "answer_available": false,
    "reasoning": "example",
    "language": "en"
  },
  "credits": {
    "classify": 0,
    "reply": 0
  }
}

Undo the social

Undo the social.

User token

Needs the token of a signed-in user.

Path parameters
idstringRequired

The ID of the social.

Status codes

200 400 401 404 500

POST/social/queue/:id/undo
curl -X POST 'http://www.allsport.bg/social/queue/{id}/undo?ionic=true' \
  -H 'Authorization: Bearer <TOKEN>'
Response
{
  "platform": "facebook",
  "page_id": "example",
  "page_name": "Example",
  "connected_by": "6543210fedcba98765432100",
  "last_polled_at": "2026-11-04T12:00:00.000Z",
  "replies_disabled_at": "2026-11-04T12:00:00.000Z",
  "enabled": false,
  "auto_threshold": 0.9,
  "custom_instructions": "example",
  "auto_action": false,
  "allow_auto_delete": false,
  "auto_reply": false,
  "auto_post_replies": false,
  "reply_instructions": "example",
  "notify_new_comments": false,
  "start_date": "2026-11-04T12:00:00.000Z",
  "message_instructions": "example",
  "granted_scopes": [
    "example"
  ],
  "instagram_user_id": "example",
  "instagram_username": "Example",
  "_id": "6543210fedcba98765432100",
  "updatedAt": "2026-11-04T12:00:00.000Z",
  "createdAt": "2026-11-04T12:00:00.000Z",
  "sources": {
    "facebook_posts": false,
    "facebook_reviews": false,
    "instagram_comments": false,
    "facebook_messages": false,
    "instagram_messages": false
  }
}

List all socials

Returns the site's socials, newest first unless a sort is given.

User token

Needs the token of a signed-in user.

Status codes

200 401 404 500

GET/social/settings
curl -X GET 'http://www.allsport.bg/social/settings?ionic=true' \
  -H 'Authorization: Bearer <TOKEN>'
Response
{
  "platform": "facebook",
  "page_id": "example",
  "page_name": "Example",
  "connected_by": "6543210fedcba98765432100",
  "last_polled_at": "2026-11-04T12:00:00.000Z",
  "replies_disabled_at": "2026-11-04T12:00:00.000Z",
  "enabled": false,
  "auto_threshold": 0.9,
  "custom_instructions": "example",
  "auto_action": false,
  "allow_auto_delete": false,
  "auto_reply": false,
  "auto_post_replies": false,
  "reply_instructions": "example",
  "notify_new_comments": false,
  "start_date": "2026-11-04T12:00:00.000Z",
  "message_instructions": "example",
  "granted_scopes": [
    "example"
  ],
  "instagram_user_id": "example",
  "instagram_username": "Example",
  "_id": "6543210fedcba98765432100",
  "updatedAt": "2026-11-04T12:00:00.000Z",
  "createdAt": "2026-11-04T12:00:00.000Z",
  "sources": {
    "facebook_posts": false,
    "facebook_reviews": false,
    "instagram_comments": false,
    "facebook_messages": false,
    "instagram_messages": false
  }
}

Update the social

Changes the fields sent; the others stay as they are.

User token

Needs the token of a signed-in user.

Parameters
clear_replies_disabledstring

The social's clear replies disabled.

Status codes

200 400 401 404 500

PATCH/social/settings
curl -X PATCH 'http://www.allsport.bg/social/settings?ionic=true' \
  -H 'Authorization: Bearer <TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{ "clear_replies_disabled": "..." }'
Response
{
  "platform": "facebook",
  "page_id": "example",
  "page_name": "Example",
  "connected_by": "6543210fedcba98765432100",
  "last_polled_at": "2026-11-04T12:00:00.000Z",
  "replies_disabled_at": "2026-11-04T12:00:00.000Z",
  "enabled": false,
  "auto_threshold": 0.9,
  "custom_instructions": "example",
  "auto_action": false,
  "allow_auto_delete": false,
  "auto_reply": false,
  "auto_post_replies": false,
  "reply_instructions": "example",
  "notify_new_comments": false,
  "start_date": "2026-11-04T12:00:00.000Z",
  "message_instructions": "example",
  "granted_scopes": [
    "example"
  ],
  "instagram_user_id": "example",
  "instagram_username": "Example",
  "_id": "6543210fedcba98765432100",
  "updatedAt": "2026-11-04T12:00:00.000Z",
  "createdAt": "2026-11-04T12:00:00.000Z",
  "sources": {
    "facebook_posts": false,
    "facebook_reviews": false,
    "instagram_comments": false,
    "facebook_messages": false,
    "instagram_messages": false
  }
}

Change the status of a social

Change the status of a social.

User token

Needs the token of a signed-in user.

Status codes

200 401 500

GET/social/status
curl -X GET 'http://www.allsport.bg/social/status?ionic=true' \
  -H 'Authorization: Bearer <TOKEN>'
Response
{
  "platform": "facebook",
  "page_id": "example",
  "page_name": "Example",
  "connected_by": "6543210fedcba98765432100",
  "last_polled_at": "2026-11-04T12:00:00.000Z",
  "replies_disabled_at": "2026-11-04T12:00:00.000Z",
  "enabled": false,
  "auto_threshold": 0.9,
  "custom_instructions": "example",
  "auto_action": false,
  "allow_auto_delete": false,
  "auto_reply": false,
  "auto_post_replies": false,
  "reply_instructions": "example",
  "notify_new_comments": false,
  "start_date": "2026-11-04T12:00:00.000Z",
  "message_instructions": "example",
  "granted_scopes": [
    "example"
  ],
  "instagram_user_id": "example",
  "instagram_username": "Example",
  "_id": "6543210fedcba98765432100",
  "updatedAt": "2026-11-04T12:00:00.000Z",
  "createdAt": "2026-11-04T12:00:00.000Z",
  "sources": {
    "facebook_posts": false,
    "facebook_reviews": false,
    "instagram_comments": false,
    "facebook_messages": false,
    "instagram_messages": false
  }
}

Sync the social

Pull the page's recent comments now, instead of waiting for the. scheduled run. Same function the cron calls, so a manual sync and an automatic one cannot drift apart.

User token

Needs the token of a signed-in user.

Status codes

200 400 401 402 404 500

POST/social/sync
curl -X POST 'http://www.allsport.bg/social/sync?ionic=true' \
  -H 'Authorization: Bearer <TOKEN>'
Response
{
  "platform": "facebook",
  "page_id": "example",
  "page_name": "Example",
  "connected_by": "6543210fedcba98765432100",
  "last_polled_at": "2026-11-04T12:00:00.000Z",
  "replies_disabled_at": "2026-11-04T12:00:00.000Z",
  "enabled": false,
  "auto_threshold": 0.9,
  "custom_instructions": "example",
  "auto_action": false,
  "allow_auto_delete": false,
  "auto_reply": false,
  "auto_post_replies": false,
  "reply_instructions": "example",
  "notify_new_comments": false,
  "start_date": "2026-11-04T12:00:00.000Z",
  "message_instructions": "example",
  "granted_scopes": [
    "example"
  ],
  "instagram_user_id": "example",
  "instagram_username": "Example",
  "_id": "6543210fedcba98765432100",
  "updatedAt": "2026-11-04T12:00:00.000Z",
  "createdAt": "2026-11-04T12:00:00.000Z",
  "sources": {
    "facebook_posts": false,
    "facebook_reviews": false,
    "instagram_comments": false,
    "facebook_messages": false,
    "instagram_messages": false
  }
}

Create a location with AI

Create a location from a prompt, written by the AI builder.

Admin token

Needs a site admin token.

Parameters
promptstring

What the AI should do with the location, in plain words - any language.

chatIdstring

The AI chat this request belongs to; its history and language carry over. Leave it out to start a new chat.

aiVersionstring

Which version of the AI builder to use; leave it out for the current one.

item_idstring

The ID of the location to change.

Status codes

200 401 500

POST/create-new-location
curl -X POST 'http://www.allsport.bg/create-new-location?ionic=true' \
  -H 'Authorization: Bearer <TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{ "prompt": "...", "chatId": "...", "aiVersion": "...", "item_id": "..." }'
Response
{
  "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"
  }
}

Generate a location with AI

Use it to create a new physical store location or partner business listing (name, address, city, contact info).

Admin token

Needs a site admin token.

Parameters
promptstring

What the AI should do with the location, in plain words - any language.

chatIdstring

The AI chat this request belongs to; its history and language carry over. Leave it out to start a new chat.

Status codes

200 401 500

POST/generate-location
curl -X POST 'http://www.allsport.bg/generate-location?ionic=true' \
  -H 'Authorization: Bearer <TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{ "prompt": "...", "chatId": "..." }'

Generate a privacy policy with AI

Use it for a privacy policy page for your site, optionally together with the site's cookie consent banner.

Admin token

Needs a site admin token.

Parameters
promptstring

What the AI should do with the privacy policy, in plain words - any language.

chatIdstring

The AI chat this request belongs to; its history and language carry over. Leave it out to start a new chat.

aiVersionstring

Which version of the AI builder to use; leave it out for the current one.

socketIdstring

The privacy policy's socket id.

include_consentstring

Whether to also create the cookie consent banner and link it to this privacy policy.

Status codes

200 401 500

POST/generate-privacy-policy
curl -X POST 'http://www.allsport.bg/generate-privacy-policy?ionic=true' \
  -H 'Authorization: Bearer <TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{ "prompt": "...", "chatId": "...", "aiVersion": "...", "socketId": "...", "include_consent": "..." }'

Modify a location with AI

Use it to edit or update an existing physical location or partner business entry.

Admin token

Needs a site admin token.

Parameters
promptstring

What the AI should do with the location, in plain words - any language.

item_datastring

The current location, as JSON - the AI changes it and returns the result.

chatIdstring

The AI chat this request belongs to; its history and language carry over. Leave it out to start a new chat.

item_idstring

The ID of the location to change.

item_idsstring

The location's item ids.

Status codes

200 401 500

POST/modify-location
curl -X POST 'http://www.allsport.bg/modify-location?ionic=true' \
  -H 'Authorization: Bearer <TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{ "prompt": "...", "item_data": "...", "chatId": "...", "item_id": "...", "item_ids": "..." }'

Modify a rating setting with AI

Use it to set up or configure automated review/rating request emails.

Admin token

Needs a site admin token.

Parameters
promptstring

What the AI should do with the rating setting, in plain words - any language.

chatIdstring

The AI chat this request belongs to; its history and language carry over. Leave it out to start a new chat.

Status codes

200 401 500

POST/modify-rating-settings
curl -X POST 'http://www.allsport.bg/modify-rating-settings?ionic=true' \
  -H 'Authorization: Bearer <TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{ "prompt": "...", "chatId": "..." }'

Modify a site contact with AI

Use it to update site contact info such as site name, address, city, zip code, email, phone, working hours, or language.

Admin token

Needs a site admin token.

Parameters
promptstring

What the AI should do with the site contact, in plain words - any language.

chatIdstring

The AI chat this request belongs to; its history and language carry over. Leave it out to start a new chat.

Status codes

200 401 500

POST/modify-site-contacts
curl -X POST 'http://www.allsport.bg/modify-site-contacts?ionic=true' \
  -H 'Authorization: Bearer <TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{ "prompt": "...", "chatId": "..." }'

Modify a site navigation with AI

Use it to add or remove a navigation menu link, rename one, or change where it points.

Admin token

Needs a site admin token.

Parameters
promptstring

What the AI should do with the site navigation, in plain words - any language.

chatIdstring

The AI chat this request belongs to; its history and language carry over. Leave it out to start a new chat.

Status codes

200 401 500

POST/modify-site-navigation
curl -X POST 'http://www.allsport.bg/modify-site-navigation?ionic=true' \
  -H 'Authorization: Bearer <TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{ "prompt": "...", "chatId": "..." }'

Update a rating setting with AI

Update a rating setting from a prompt, written by the AI builder.

Admin token

Needs a site admin token.

Parameters
promptstring

What the AI should do with the rating setting, in plain words - any language.

chatIdstring

The AI chat this request belongs to; its history and language carry over. Leave it out to start a new chat.

aiVersionstring

Which version of the AI builder to use; leave it out for the current one.

rating_typestring

The rating setting's rating type.

Status codes

200 401 500

POST/update-rating-settings-ai
curl -X POST 'http://www.allsport.bg/update-rating-settings-ai?ionic=true' \
  -H 'Authorization: Bearer <TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{ "prompt": "...", "chatId": "...", "aiVersion": "...", "rating_type": "..." }'
Response
{
  "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"
  }
}

Update a site contact with AI

Update a site contact from a prompt, written by the AI builder.

Admin token

Needs a site admin token.

Parameters
promptstring

What the AI should do with the site contact, in plain words - any language.

chatIdstring

The AI chat this request belongs to; its history and language carry over. Leave it out to start a new chat.

aiVersionstring

Which version of the AI builder to use; leave it out for the current one.

item_idstring

The ID of the site contact to change.

Status codes

200 401 500

POST/update-site-contacts
curl -X POST 'http://www.allsport.bg/update-site-contacts?ionic=true' \
  -H 'Authorization: Bearer <TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{ "prompt": "...", "chatId": "...", "aiVersion": "...", "item_id": "..." }'
Response
{
  "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"
  }
}

Update a site navigation with AI

Update a site navigation from a prompt, written by the AI builder.

Admin token

Needs a site admin token.

Parameters
promptstring

What the AI should do with the site navigation, in plain words - any language.

chatIdstring

The AI chat this request belongs to; its history and language carry over. Leave it out to start a new chat.

aiVersionstring

Which version of the AI builder to use; leave it out for the current one.

item_idstring

The ID of the site navigation to change.

Status codes

200 401 500

POST/update-site-navigation
curl -X POST 'http://www.allsport.bg/update-site-navigation?ionic=true' \
  -H 'Authorization: Bearer <TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{ "prompt": "...", "chatId": "...", "aiVersion": "...", "item_id": "..." }'
Response
{
  "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"
  }
}
↑↓ Navigate↵ GoEsc Close