{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-apis/mgmt/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["cards","card"]},"type":"markdown"},"seo":{"title":"Management API - Workspaces & Projects","projectTitle":"Vilna Docs","description":"Programmatic access to workspace administration, team management, project organization, and API key lifecycle in Vilna.","siteUrl":"https://docs.vilna.io","keywords":["crypto asset management","blockchain monitoring","digital asset security","cryptocurrency API","wallet tracking","blockchain analytics","enterprise crypto","real-time blockchain","CAIP-19","BIP44"],"lang":"en-US","image":"https://cdn.vilna.io/docs/previews/mgmt-api.png","meta":[{"name":"og:type","content":"website"},{"name":"og:site_name","content":"Vilna Documentation"},{"name":"og:image:width","content":"1200"},{"name":"og:image:height","content":"630"},{"name":"twitter:card","content":"summary_large_image"}],"llmstxt":{"title":"Vilna API Documentation","description":"Vilna is a blockchain monitoring and wallet management platform. It provides a single unified REST API for tracking addresses, transactions, balances, and activity across top blockchains - Bitcoin, Ethereum, Solana, TRON, TON, Cosmos, and others. The API uses CAIP-2/CAIP-19 standards for cross-chain identification, HD wallet management (BIP-32/44) for address derivation, and RFC 7807 for error responses. Authentication is via API key in the X-Api-Key header.\n","excludeFiles":["legal/**/*.md","@l10n/**/*.md"],"sections":[{"title":"Overview","description":"What Vilna is, supported blockchains, and target audience","includeFiles":["overview.md"],"excludeFiles":[]},{"title":"Getting Started","description":"Quickstart guide and core API concepts","includeFiles":["guides/quickstart.md","guides/dashboard.md","guides/core-concepts.md","guides/authentication.md"],"excludeFiles":[]},{"title":"API Reference","description":"Platform API and Management API endpoint documentation","includeFiles":["apis/platform/index.md","apis/mgmt/index.md","apis/rpc/index.md","apis/platform/api.yaml","apis/mgmt/api.yaml"],"excludeFiles":[]},{"title":"Developer Guides","description":"Integration patterns, events, notifications, SDK, and error handling","includeFiles":["guides/events.md","guides/channels.md","guides/integration-patterns.md","guides/sdk.md","guides/mcp.md","guides/errors.md","guides/simulation.md","guides/invoices.md"],"excludeFiles":[]},{"title":"Business","description":"Value proposition, use cases, and onboarding","includeFiles":["business/index.md","business/use-cases.md"],"excludeFiles":[]},{"title":"Optional","description":"Additional reference material","includeFiles":["guides/blockchain-basics.md","guides/faq.md","apis/mgmt/guide.md","guides/widget.md","guides/storage-client.md","apis/platform/caip-standards.md","apis/mgmt/authorization.md"],"excludeFiles":[]}],"hide":false},"priority":0.9,"jsonLd":{"@context":"https://schema.org","@graph":[{"@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https://docs.vilna.io/"},{"@type":"ListItem","position":2,"name":"Management API"}]},{"@type":"WebAPI","name":"Vilna Management API","description":"REST API for workspace management, team members, project organization, and API key lifecycle.","url":"https://docs.vilna.io/apis/mgmt/","documentation":"https://docs.vilna.io/apis/mgmt/","termsOfService":"https://docs.vilna.io/legal/terms","provider":{"@type":"Organization","name":"Vilna","url":"https://vilna.io"}}]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"management-api","__idx":0},"children":["Management API"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Management API provides programmatic access to workspace administration, team management, and API key lifecycle."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"base-url","__idx":1},"children":["Base URL"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"https://mgmt.vilna.io/v1\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"authentication","__idx":2},"children":["Authentication"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["All requests require a management API key (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["vilna_mgt_"]}," prefix) in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["X-Api-Key"]}," header. Management keys are workspace-scoped - see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis/mgmt/authorization"},"children":["Authorization"]}," for roles and permissions."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"request-format","__idx":3},"children":["Request format"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Content-Type: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["application/json"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["All resources are nested under ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/workspaces/{workspace_id}/"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Pagination: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["?limit=30&page=1"]}," (limit: 1-100, default 30)"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"response-format","__idx":4},"children":["Response format"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Single item:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"item\": { ... }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["List:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"items\": [ ... ],\n  \"meta\": {\n    \"limit\": 30,\n    \"page\": 1,\n    \"total\": 10,\n    \"total_pages\": 1\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Errors follow ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/errors"},"children":["RFC 7807 Problem Details"]}," (Content-Type: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["application/problem+json"]},")."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"what-you-can-do","__idx":5},"children":["What you can do"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Management API covers the full lifecycle of your Vilna organization:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Workspaces"]}," - view and update workspace settings"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Members"]}," - list and remove accepted workspace members"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Invitations"]}," - invite users to your workspace, review and revoke invitations"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Projects"]}," - create and manage isolated project environments"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Project members"]}," - assign team members to specific projects with granular roles"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["API keys"]}," - provision, list, and revoke project-scoped keys for the Platform API"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["RPC keys"]}," - provision, list, and revoke workspace-scoped keys for blockchain RPC"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Management keys"]}," - provision, list, and revoke keys for this API"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"next-steps","__idx":6},"children":["Next steps"]},{"$$mdtype":"Tag","name":"Cards","attributes":{"columns":2,"cardMinWidth":240},"children":[{"$$mdtype":"Tag","name":"Card","attributes":{"title":"Guide","imagePosition":"start","iconPosition":"auto","layout":"vertical","align":"start","variant":"filled","to":"/apis/mgmt/guide"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Resource hierarchy, key types, and common workflows"]}]},{"$$mdtype":"Tag","name":"Card","attributes":{"title":"Authorization","imagePosition":"start","iconPosition":"auto","layout":"vertical","align":"start","variant":"filled","to":"/apis/mgmt/authorization"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Roles, permissions, and the access control matrix"]}]},{"$$mdtype":"Tag","name":"Card","attributes":{"title":"API Reference","imagePosition":"start","iconPosition":"auto","layout":"vertical","align":"start","variant":"filled","to":"/apis/mgmt/api"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Complete endpoint documentation"]}]}]}]},"headings":[{"value":"Management API","id":"management-api","depth":1},{"value":"Base URL","id":"base-url","depth":2},{"value":"Authentication","id":"authentication","depth":2},{"value":"Request format","id":"request-format","depth":2},{"value":"Response format","id":"response-format","depth":2},{"value":"What you can do","id":"what-you-can-do","depth":2},{"value":"Next steps","id":"next-steps","depth":2}],"frontmatter":{"seo":{"title":"Management API - Workspaces & Projects","description":"Programmatic access to workspace administration, team management, project organization, and API key lifecycle in Vilna.","priority":0.9,"image":"https://cdn.vilna.io/docs/previews/mgmt-api.png","jsonLd":{"@context":"https://schema.org","@graph":[{"@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https://docs.vilna.io/"},{"@type":"ListItem","position":2,"name":"Management API"}]},{"@type":"WebAPI","name":"Vilna Management API","description":"REST API for workspace management, team members, project organization, and API key lifecycle.","url":"https://docs.vilna.io/apis/mgmt/","documentation":"https://docs.vilna.io/apis/mgmt/","termsOfService":"https://docs.vilna.io/legal/terms","provider":{"@type":"Organization","name":"Vilna","url":"https://vilna.io"}}]}}},"lastModified":"2026-05-26T20:25:55.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/apis/mgmt","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}