permissions

Remove User From Tenant Endpoint

Remove a user from a tenant.

The tenant owner or any user with has_user_management_permission in the tenant (e.g. users in the Admin role) can remove users from the tenant. The tenant owner cannot be removed from their own tenant. This removes the user from all roles in the tenant and revokes their permissions on datasets belonging to the tenant. Data owned by the removed user (e.g. datasets they created) remains in the tenant.

Path Parameters

tenant_id (UUID): The UUID of the tenant
user_id (UUID): The UUID of the user to remove from the tenant

Response

Returns a success message indicating the user was removed from the tenant.

Error Codes

400 Bad Request: Attempt to remove the tenant owner from their own tenant
403 Forbidden: Requester is not the tenant owner and does not have has_user_management_permission (e.g. Admin role) in the tenant
404 Not Found: Tenant not found, user not found, or user not in tenant
500 Internal Server Error: Error removing user from tenant

DELETE

api

permissions

tenants

{tenant_id}

users

{user_id}

Remove User From Tenant Endpoint

curl --request DELETE \
  --url https://api.cognee.ai/api/v1/permissions/tenants/{tenant_id}/users/{user_id} \
  --header 'Authorization: Bearer <token>'

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

tenant_id

string<uuid>

required

user_id

string<uuid>

required

Response

Successful Response

Create TenantCreate a new tenant. This endpoint creates a new tenant with the specified name. Tenants are used to organize users and resources in multi-tenant environments, providing isolation and access control between different groups or organizations. ## Request Parameters - **tenant_name** (str): The name of the tenant to create ## Response Returns a success message indicating the tenant was created. ## Error Codes - **400 Bad Request**: Invalid tenant name or tenant already exists - **500 Internal Server Error**: Error creating the tenant

⌘I

Remove User From Tenant Endpoint

curl --request DELETE \
  --url https://api.cognee.ai/api/v1/permissions/tenants/{tenant_id}/users/{user_id} \
  --header 'Authorization: Bearer <token>'

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}