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.
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
| Method | Path | Key | Permissions | Used for |
|---|---|---|---|---|
| POST | /api/v1/run | Full-access key | run | A one-off text request. |
| POST | /api/v1/scenarios/:id/run | Single-task key | scenario:run · run | Start one specific Scheduler task. |
| GET | /api/v1/scenarios/:id/history | Single-task key or view-only key | scenario:history · history | Run history for that task. |
| GET | /api/v1/devices/list | Full-access key | devices:read · history · run | List of devices available in the current workspace. |
| POST | /api/v1/act/proposals | Full-access key | act:create · run | Create an action proposal that can later be approved or rejected. |
| GET | /api/v1/act/proposals?status=...&since=...&include=commands | Full-access key | act:read · history | List action proposals with filters. |
| GET | /api/v1/act/proposals/:id?include=commands | Full-access key | act:read · history | Details for one action proposal. |
| POST | /api/v1/act/proposals/:id/approve | Full-access key | act:approve · run | Approve an action proposal. |
| POST | /api/v1/act/proposals/:id/reject | Full-access key | act:approve · run | Reject an action proposal. |
Examples
API groups
Requests in this group
POST
/api/v1/runA one-off text request.
Key: Full-access key•Permissions: 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"}'Tip: Open API test mode.
Note: $BASE_URL is the domain where your frontend is available, for example https://snegikom.ru or http://localhost:3000.
