Programmatic & Agentic Access

Everything you can do in the Organizations dashboard, you can do from code. The org-management surface is a REST API, so an autonomous agent or a back-office script can run most of your organization with no human in the loop. (A few flows still need a one-time browser step — card enrollment, for example.)

Authenticate as the organization

Call the API with a Nevermined API key that belongs to a member with the Admin role in the organization you want to act on. If the key is already scoped to a specific organization, that scope applies by default; to act on a different workspace, send the X-Current-Org-Id header — it overrides the key’s own scope.

An admin key can invite members, move treasury funds, and withdraw from organization wallets. Treat it like a production secret: keep it server-side and never hand it to an autonomous agent or a client you don’t fully control.

cURL
TypeScript
Python

curl https://api.sandbox.nevermined.app/api/v1/organizations/my-memberships \
  -H "Authorization: Bearer $NVM_API_KEY" \
  -H "X-Current-Org-Id: org-9d81acea-7d38-460e-b7c0-c3b92abcbb07"

import { Payments } from '@nevermined-io/payments'

const payments = Payments.getInstance({
  nvmApiKey: process.env.NVM_API_KEY!,
  environment: 'sandbox',
})

const memberships = await payments.organizations.getMyMemberships()

import os
from payments_py import Payments

payments = Payments(
  api_key=os.environ.get('NVM_API_KEY'),
  environment='sandbox',
)

memberships = payments.organizations.get_my_memberships()

See the SDK & Workspaces pattern for more on listing memberships and targeting a specific workspace when you publish agents or plans.

What you can automate

Every organization feature is API-driven, subject to the same tier gates as the dashboard:

Members & invitations

Invite, change roles, deactivate, and remove members.

Groups & budgets

Create teams, cap their spend, and attach shared payment methods.

Organization wallets

Create treasury wallets, check balances, fund groups, and withdraw.

Customers

Read your CRM and provision customers (Enterprise).

Analytics

Pull revenue, MRR, usage, and conversion metrics.

Events & webhooks

Read the activity feed and manage outbound webhooks.

The White-label Onboarding flow is purpose-built for automation: one call provisions a new customer account under your brand and hands back a scoped key to pay for your agents on their behalf. (Onboarding an email that already has an account instead triggers a consent step before the accounts are linked.)

Let agents discover your organization

Beyond managing your own org, Nevermined exposes three public, unauthenticated endpoints per organization so that autonomous agents and discovery registries can find and pay for what you offer. They’re served for active Premium and Enterprise organizations (any other org returns 404).

Endpoint	Format	What it returns
`GET /api/v1/organizations/{orgId}/llms.txt`	`text/plain`	An `llms.txt` index of the organization’s plans, agents, and Nevermined reference links.
`GET /api/v1/organizations/{orgId}/agentic-instructions.md`	`text/markdown`	Instructions telling an AI agent how to discover and pay for your plans and agents via Nevermined.
`GET /api/v1/organizations/{orgId}/ai-catalog.json`	`application/json`	Your Agentic Resource Discovery (ARD) catalog — one entry per listed agent, each carrying its x402 payment terms (plan, price, settlement network) in `metadata`. Crawlable by ARD registries.

# No auth needed — public discovery surface
curl https://api.sandbox.nevermined.app/api/v1/organizations/org-9d81acea-7d38-460e-b7c0-c3b92abcbb07/ai-catalog.json

These endpoints are how an agent goes from “I found this organization” to “I can pay for its agents” without a human — the ai-catalog.json x402 terms are everything a paying agent needs. See Buy & Call a Paid Agent for an end-to-end demo driven entirely by an agentic-instructions.md URL.

Full API reference

Every operation is documented per-endpoint in the Organizations group of the API reference, auto-generated from the server’s OpenAPI spec. For SDK-based access, see the SDK & Workspaces pattern.

SDK & Workspaces

List memberships, target a workspace, and read the activity feed from code.

White-label Onboarding

Provision customers programmatically under your brand.

Learn

Build

Payments

Solutions

Organizations

Integrations

Payment Patterns

Components

Specs

Authenticate as the organization

What you can automate

Members & invitations

Groups & budgets

Organization wallets

Customers

Analytics

Events & webhooks

Let agents discover your organization

Full API reference

SDK & Workspaces

White-label Onboarding

​Authenticate as the organization

​What you can automate

Members & invitations

Groups & budgets

Organization wallets

Customers

Analytics

Events & webhooks

​Let agents discover your organization

​Full API reference

​Related

SDK & Workspaces

White-label Onboarding

Authenticate as the organization

What you can automate

Let agents discover your organization

Full API reference

Related