The rivano.teams resource lets you organize users into groups, control which agents each group can access, and assign roles within a tenant.

List teams

import Rivano from '@rivano/sdk';

const rivano = new Rivano({ apiKey: 'rv_...' });

const { data, total } = await rivano.teams.list();
for (const team of data) {
  console.log(`${team.id} — ${team.name}`);
}

import requests

response = requests.get(
    'https://api.rivano.ai/api/teams',
    headers={'Authorization': 'Bearer rv_...'},
)
for team in response.json()['data']:
    print(team['id'], team['name'])

curl https://api.rivano.ai/api/teams \
  -H "Authorization: Bearer rv_..."

Create a team

import Rivano from '@rivano/sdk';

const rivano = new Rivano({ apiKey: 'rv_...' });

const team = await rivano.teams.create({ name: 'legal-ai-team' });
console.log('Team created:', team.id);

import requests

response = requests.post(
    'https://api.rivano.ai/api/teams',
    headers={
        'Authorization': 'Bearer rv_...',
        'Content-Type': 'application/json',
    },
    json={'name': 'legal-ai-team'},
)
print(response.json()['id'])

curl https://api.rivano.ai/api/teams \
  -X POST \
  -H "Authorization: Bearer rv_..." \
  -H "Content-Type: application/json" \
  -d '{"name": "legal-ai-team"}'

Manage members

List members

import Rivano from '@rivano/sdk';

const rivano = new Rivano({ apiKey: 'rv_...' });

const members = await rivano.teams.members('team_abc123');
for (const member of members) {
  console.log(`${member.email} [${member.role}]`);
}

Add a member

import Rivano from '@rivano/sdk';

const rivano = new Rivano({ apiKey: 'rv_...' });

await rivano.teams.addMember('team_abc123', {
  email: '[email protected]',
  role: 'member',
});

import requests

requests.post(
    'https://api.rivano.ai/api/teams/team_abc123/members',
    headers={
        'Authorization': 'Bearer rv_...',
        'Content-Type': 'application/json',
    },
    json={'email': '[email protected]', 'role': 'member'},
)

curl https://api.rivano.ai/api/teams/team_abc123/members \
  -X POST \
  -H "Authorization: Bearer rv_..." \
  -H "Content-Type: application/json" \
  -d '{"email": "[email protected]", "role": "member"}'

Remove a member

await rivano.teams.removeMember('team_abc123', '[email protected]');

Member roles

Role	Permissions
`admin`	Full access to team resources, can add/remove members
`member`	Read/write access to agents and traces scoped to this team

Scope agents to a team

By default, a team can see all agents in the tenant. Use setScopes to restrict a team to specific agents:

import Rivano from '@rivano/sdk';

const rivano = new Rivano({ apiKey: 'rv_...' });

// Restrict legal-ai-team to only these two agents
await rivano.teams.setScopes('team_abc123', [
  'contract-summarizer',
  'compliance-checker',
]);

console.log('Team scopes updated');

import requests

requests.put(
    'https://api.rivano.ai/api/teams/team_abc123/scopes',
    headers={
        'Authorization': 'Bearer rv_...',
        'Content-Type': 'application/json',
    },
    json={'agentNames': ['contract-summarizer', 'compliance-checker']},
)

curl https://api.rivano.ai/api/teams/team_abc123/scopes \
  -X PUT \
  -H "Authorization: Bearer rv_..." \
  -H "Content-Type: application/json" \
  -d '{"agentNames": ["contract-summarizer", "compliance-checker"]}'

💡

Pass an empty array to setScopes to give the team access to all agents again (default behavior).

Error handling

Error	When it occurs
`SdkAuthError`	Invalid API key
`SdkForbiddenError`	Insufficient permissions to manage teams
`SdkNotFoundError`	Team ID does not exist
`SdkError`	Duplicate team name or invalid role

SDK Keys — Scoped API keys for team-level access control
SDK Policies — Scope policies to specific teams with teamId
Core Concepts — Teams — How teams fit the tenant model

SDK — Teams