permissions

Add User To Tenant

Add a user to a tenant.

This endpoint assigns a user to a specific tenant, allowing them to access resources and data associated with that tenant. The authenticated user must be the owner of the tenant or have appropriate administrative permissions.

Path Parameters

user_id (UUID): The UUID of the user to add to the tenant

Request Parameters

tenant_id (UUID): The UUID of the tenant to assign the user to

Response

Returns a success message indicating the user was added to the tenant.

Error Codes

400 Bad Request: Invalid user or tenant ID
403 Forbidden: User doesn’t have permission to assign tenants
404 Not Found: User or tenant doesn’t exist
500 Internal Server Error: Error adding user to tenant

POST

api

permissions

users

{user_id}

tenants

Add User To Tenant

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

import requests

url = "https://api.cognee.ai/api/v1/permissions/users/{user_id}/tenants"

headers = {"Authorization": "Bearer <token>"}

response = requests.post(url, headers=headers)

print(response.text)

{
  "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

user_id

string<uuid>

required

Query Parameters

tenant_id

string<uuid>

required

Response

Successful Response

⌘I

Add User To Tenant

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

import requests

url = "https://api.cognee.ai/api/v1/permissions/users/{user_id}/tenants"

headers = {"Authorization": "Bearer <token>"}

response = requests.post(url, headers=headers)

print(response.text)

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