Snegikom API
Playground + docs

Snegikom API

In short: create a key in the API section, choose the right access level, take one of the examples below, replace your domain and key, and you are ready to start.

This page brings together everything you need to connect the Snegikom API to your service, server, or working flow: one-off requests, saved tasks, device lists, and actions that may need human approval.

All examples below can be tested directly in the API test mode inside the control panel.

Run
LLM + API
One-off calls, scenarios and real-world actions through a single API surface.
Auth
Bearer keys
Full-access, single-task, and view-only keys with clear permission boundaries for safer integrations.
Surface
Docs + playground
Read the contract here, then validate the same call instantly inside Dashboard → API.
Navigation
Requests
table and examples
Integration note
Authorization: Bearer <API_KEY>
Use the docs as your contract surface and the dashboard playground as your verification surface before wiring production automations.
Product surface
Closer to dashboard style
This page now mirrors the softer premium cards, glows and spacing rhythm used across the rest of the Snegikom dashboard.
v1

Request table

A quick view of what the request is, which key it needs, and what it is for.

Search
Shown: 9
MethodPathKeyPermissionsUsed for
POST/api/v1/runFull-access keyrunA one-off text request.
POST/api/v1/scenarios/:id/runSingle-task keyscenario:run · runStart one specific Scheduler task.
GET/api/v1/scenarios/:id/historySingle-task key or view-only keyscenario:history · historyRun history for that task.
GET/api/v1/devices/listFull-access keydevices:read · history · runList of devices available in the current workspace.
POST/api/v1/act/proposalsFull-access keyact:create · runCreate an action proposal that can later be approved or rejected.
GET/api/v1/act/proposals?status=...&since=...&include=commandsFull-access keyact:read · historyList action proposals with filters.
GET/api/v1/act/proposals/:id?include=commandsFull-access keyact:read · historyDetails for one action proposal.
POST/api/v1/act/proposals/:id/approveFull-access keyact:approve · runApprove an action proposal.
POST/api/v1/act/proposals/:id/rejectFull-access keyact:approve · runReject an action proposal.
Examples
API groups
Requests in this group
POST/api/v1/run
A one-off text request.
Key: Full-access keyPermissions: run
Example request
curl -X POST $BASE_URL/api/v1/run \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  --data-raw '{"prompt":"Make a short weekly summary of tasks"}'
Note: $BASE_URL is the domain where your frontend is available, for example https://snegikom.ru or http://localhost:3000.
Snegikom API