> ## Documentation Index
> Fetch the complete documentation index at: https://docs.unpod.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Teams & Policies

> The multi-tenant authorization boundary - who can touch what, and which actions need a human first.

Teams & Policies are the multi-tenant authorization boundary: every resource
in the Core Engine belongs to a project, every actor holds a role inside it,
and sensitive actions can be gated behind human approval.

Trusting a backend with your customer conversations sets a high bar. Unpod
treats control as architecture, not as an enterprise questionnaire filled in
later: scoping is not a filter applied at the API edge - an entity,
conversation, or recording outside your project does not exist for your keys.
Teams and roles decide who reads and writes; policies decide which actions -
sending a payment link, placing a call outside allowed hours, escalating a
journey - stop and wait for a human before they run.

Deployment is part of control. The Core Engine runs managed, dedicated,
hybrid, or [self-hosted](https://docs.unpod.ai/platform/self-hosting/quickstart.md) - and the SDK
does not change between them. Where the data lives is a deployment decision,
not a rewrite.

## The primitives

| Primitive | What it is | Where it lives today |
| - | - | - |
| Projects | The scoping container every resource belongs to - a Space in the Platform | [Space APIs](https://docs.unpod.ai/api/space/organizations.md) - production |
| Teams | The people who share access to a project | Platform space membership - production |
| Roles | What a member can see and do inside a project | Platform space membership - production |
| Service accounts | Non-human credentials - the API keys your agents and servers hold | [API Keys](https://docs.unpod.ai/platform/studio-view/api-key.md) - production |
| Policies | Rules that gate sensitive actions on the spine | In build - shipping with the [journey engine](https://docs.unpod.ai/agent-studio/flows-journeys.md) |
| Approvals | The human sign-off step a policy inserts before an action runs | In build - shipping with the [journey engine](https://docs.unpod.ai/agent-studio/flows-journeys.md) |

## On the spine

Teams & Policies do not sit on the spine - they govern it. Every read and
write against [entities](https://docs.unpod.ai/context/entities.md),
[conversations](https://docs.unpod.ai/context/conversations.md), and
[outcomes](https://docs.unpod.ai/context/outcomes.md) resolves through a project scope and a
role before it executes. Policies read the action an agent or journey is
about to take and either let it pass or hold it as a pending approval; each
grant, denial, and approval decision emits an audit event alongside the
[event stream](https://docs.unpod.ai/core-engine/events.md).

## What stays hidden

Internal organization mappings. How projects, teams, and billing tenants map
onto each other inside Unpod - and how a key resolves to its scope at
request time - is not a public surface. You work with projects, roles, and
keys; the tenancy machinery underneath is Unpod's job.

## Status

Spaces, roles, and API keys: production - every call, message, and record in
the system is already scoped through them. Policy-gated approvals: in build,
shipping with the journey engine. Self-hosted deployment: available today
via the [self-hosting quickstart](https://docs.unpod.ai/platform/self-hosting/quickstart.md).

## Go deeper

> [card] [API Keys](https://docs.unpod.ai/platform/studio-view/api-key.md)
>
> Create and rotate the credentials your agents and servers hold.

> [card] [Space APIs](https://docs.unpod.ai/api/space/organizations.md)
>
> Address a project and its records over REST.

> [card] [Self-Hosting](https://docs.unpod.ai/platform/self-hosting/quickstart.md)
>
> Run the stack in your own infrastructure - same SDK.

> [card] [Observability](https://docs.unpod.ai/core-engine/observability.md)
>
> See what your agents did - logs, recordings, traces.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.