Skip to content
Last updated

Management API

The Management API provides programmatic access to workspace administration, team management, and API key lifecycle.

Base URL

https://mgmt.vilna.io/v1

Authentication

All requests require a management API key (vilna_mgt_ prefix) in the X-Api-Key header. Management keys are workspace-scoped - see Authorization for roles and permissions.

Request format

  • Content-Type: application/json
  • All resources are nested under /workspaces/{workspace_id}/
  • Pagination: ?limit=30&page=1 (limit: 1-100, default 30)

Response format

Single item:

{
  "item": { ... }
}

List:

{
  "items": [ ... ],
  "meta": {
    "limit": 30,
    "page": 1,
    "total": 10,
    "total_pages": 1
  }
}

Errors follow RFC 7807 Problem Details (Content-Type: application/problem+json).

What you can do

The Management API covers the full lifecycle of your Vilna organization:

  • Workspaces - view and update workspace settings
  • Members - list and remove accepted workspace members
  • Invitations - invite users to your workspace, review and revoke invitations
  • Projects - create and manage isolated project environments
  • Project members - assign team members to specific projects with granular roles
  • API keys - provision, list, and revoke project-scoped keys for the Platform API
  • RPC keys - provision, list, and revoke workspace-scoped keys for blockchain RPC
  • Management keys - provision, list, and revoke keys for this API

Next steps

Guide

Resource hierarchy, key types, and common workflows

Authorization

Roles, permissions, and the access control matrix

API Reference

Complete endpoint documentation

 

Guide