MuviaDevelopers

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-Remaining and X-RateLimit-Reset on 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 (read or write) and x-muvia-quota (counted or free-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 the X-Api-Key header, 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 / pages for lists; columns / items / page / size / has_more for dataset rows.
  • Rate limits per key (120 a minute) and per company (100,000 a day), with Retry-After on a 429.
  • Webhooks signed with X-Muvia-Signature for nodes.node_offline and post_processing.run_finished.
  • An interactive reference generated from the live OpenAPI specification.