# 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](/apis/mgmt/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:


```json
{
  "item": { ... }
}
```

List:


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

Errors follow [RFC 7807 Problem Details](/guides/errors) (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