---
title: "Select Tenant"
method: POST
path: "/api/v1/permissions/tenants/select"
tags: ["permissions"]
---

# Select Tenant

`POST /api/v1/permissions/tenants/select`

## Request

- Base URL: `https://api.aws.cognee.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.aws.cognee.ai/api/v1/permissions/tenants/select`
- Auth: API key in header `X-Api-Key`

Select current tenant.

This endpoint selects a tenant with the specified UUID. Tenants are used
to organize users and resources in multi-tenant environments, providing
isolation and access control between different groups or organizations.

Sending a null/None value as tenant_id selects his default single user tenant

## Request Parameters
- **tenant_id** (Union[UUID, None]): UUID of the tenant to select, If null/None is provided use the default single user tenant

## Response
Returns a success message along with selected tenant id.

## Request body

- SelectTenantDTO
  - `tenantId` string, uuid, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/cognee/apis/cognee-api.md) - [All operations](https://skmtc.dev/cognee/apis/cognee-api/llms.txt) - [OpenAPI document](https://skmtc.dev/cognee/apis/cognee-api/revisions/a7b6c6cb8212?raw)