Changelog
Every change to the Muvia public API, newest first. Within a version all changes are additive — see Versioning.
2026-10-19 — v1, for AI agents
Additive changes within v1.
GET /v1/whoami— the key (id, name, scopes, expiry), the company, the request limits, whether MCP is available and where the documentation is. Any valid key may call it; it does not count toward the daily quota.X-RateLimit-Limit,X-RateLimit-RemainingandX-RateLimit-Reseton every response.- Errors gain an optional
hint: one sentence that says what to do next. - Every operation in the OpenAPI document carries
x-muvia-effect(readorwrite) andx-muvia-quota(countedorfree-daily). - The MCP server and the Agent quickstart.
/llms.txt,/llms-full.txt, every guide as Markdown at/guides/<name>.md, and the specification at/openapi.json.
2026-09-26 — v1
The first public release: read-only access to a company's own data — company, projects, datasets and their rows, nodes.
Endpoints
GET /v1/company— the company the key belongs to.GET /v1/projects,GET /v1/projects/{project_id}— the company's projects.GET /v1/projects/{project_id}/datasets,GET /v1/projects/{project_id}/datasets/{dataset_id}— the datasets of a project: its own, and the physical datasets of its database.GET /v1/projects/{project_id}/datasets/{dataset_id}/rows— a dataset's rows, page by page.GET /v1/projects/{project_id}/nodes,GET /v1/projects/{project_id}/nodes/{node_id}— a project's nodes.
Scopes
settings_read— company and projects.datasets_read— datasets and their rows.nodes_read— nodes.
Platform
- API keys (
mvk_…) in theX-Api-Keyheader, issued from the API keys console in company settings, with scopes, a mandatory expiry and instant revocation. - One error envelope with stable codes (
error.code / message / status / details). - Pagination:
items / total / page / size / pagesfor lists;columns / items / page / size / has_morefor dataset rows. - Rate limits per key (120 a minute) and per company (100,000 a day), with
Retry-Afteron a 429. - Webhooks signed with
X-Muvia-Signaturefornodes.node_offlineandpost_processing.run_finished. - An interactive reference generated from the live OpenAPI specification.