generated: '2026-08-09'
method: generated
source: openapi/appsmax-rest-api-v1-openapi-original.json + https://appsmax.ru/developers/
api: AppsMax REST API v1
base_url: https://telegram.appsmax.ru/api/v1
note: >-
  Generated by API Evangelist, not published by AppsMax. Every step is grounded in an
  operationId that exists verbatim in the provider's published OpenAPI 3.0.3 contract; no
  operation, parameter or error code below was invented.

skills:
  - file: appsmax-rest-api-v1-capture-customer-request.md
    name: Capture a customer request into AppsMax
    api: openapi/appsmax-rest-api-v1-openapi-original.json
    operations: [getCurrentApiContext, listBots, createApplication, syncApplicationTags, getApplication]
    scopes: [applications:write, applications:read, bots:read]
    consequence: write

  - file: appsmax-rest-api-v1-sync-subscribers.md
    name: Sync subscribers into AppsMax
    api: openapi/appsmax-rest-api-v1-openapi-original.json
    operations: [getCurrentApiContext, listBots, listSubscribers, upsertSubscriber, getSubscriber, updateSubscriber]
    scopes: [subscribers:read, subscribers:write, bots:read]
    consequence: write

  - file: appsmax-rest-api-v1-draft-and-launch-campaign.md
    name: Draft and launch an AppsMax campaign
    api: openapi/appsmax-rest-api-v1-openapi-original.json
    operations: [getCurrentApiContext, listBots, listSubscribers, createCampaign, getCampaign, runCampaign, listCampaigns]
    scopes: [campaigns:write, campaigns:read, subscribers:read, bots:read]
    consequence: high
    human_in_the_loop: required

  - file: appsmax-rest-api-v1-inventory-bot-estate.md
    name: Inventory an AppsMax bot estate
    api: openapi/appsmax-rest-api-v1-openapi-original.json
    operations: [ping, getCurrentApiContext, listOrganizations, listBots, getBot, listBotConnections, listMiniapps, listFunnels, listInteractiveMenuItems]
    scopes: [organizations:read, bots:read, connections:read, miniapps:read, funnels:read, interactive_menu:read]
    consequence: read

coverage:
  operations_in_spec: 21
  operations_referenced_by_a_skill: 21

shared_rules:
  auth: 'Authorization: Bearer $APPSMAX_API_TOKEN (fallback header X-Api-Token); never in a query string'
  token_issuance: console-only — a human creates it in the AppsMax cabinet under Данные → Интеграции → API
  access_gate: REST API is included in the paid Profi plan or granted as an individual access right
  rate_limit: 60 requests/minute per token by default; campaign create and run are limited further
  idempotency: Idempotency-Key on createApplication and createCampaign only
  errors: errors/appsmax-rest-api-v1-problem-types.yml
  conventions: conventions/appsmax-rest-api-v1-conventions.yml
  scopes: scopes/appsmax-rest-api-v1-scopes.yml