# Multi-Tenancy Reference

> Tags are key:value strings on agents. Filtering uses AND logic — all specified tags must match.

- Skill: `tools-only/multi-tenancy-reference` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add tools-only/multi-tenancy-reference`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tools-only/multi-tenancy-reference/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tools-only (https://skillmd.com/u/tools-only)
- Updated: 2026-09-29
- Page: https://skillmd.com/skills/tools-only/multi-tenancy-reference

---

# Multi-Tenancy Reference

Manage agents across tenants using tags.

## Tag Format

Tags are `key:value` strings on agents. Filtering uses AND logic — all specified tags must match.

```yaml
agents:
  - name: acme-support
    tags:
      - "tenant:acme-corp"
      - "role:support"
      - "env:production"
```

## Patterns

### B2B

```yaml
tags:
  - "tenant:client-id"
  - "role:support"
```

### B2B2C

```yaml
tags:
  - "user:user-id"
  - "client:client-id"
  - "role:assistant"
```

## Filtering

Tags work across all relevant commands:

```bash
lettactl get agents --tags "tenant:acme-corp"
lettactl get agents --tags "role:support,env:production"
lettactl describe agent <name>
lettactl send --tags "tenant:acme-corp" "Update"
lettactl report memory --tags "tenant:acme-corp"
```

## SDK: Dynamic Tenant Provisioning

```typescript
async function provisionTenant(tenantId: string) {
  const config = ctl.createFleetConfig()
    .addAgent({
      name: `${tenantId}-support`,
      description: `Support for ${tenantId}`,
      tags: [`tenant:${tenantId}`, 'role:support'],
      system_prompt: { from_file: 'prompts/support.md' },
      llm_config: { model: 'google_ai/gemini-2.5-pro', context_window: 32000 },
      shared_blocks: ['company-kb'],
    })
    .build();

  await ctl.deployFleet(config);
}
```

## Scale

- Server-side filtering for performance
- Async pagination (1000 items per page)
- Concurrency limit of 5 for update operations