permissions

Get User Roles

List the roles assigned to a specific user.

The authenticated user must have user-management permission in the tenant.

Path Parameters

tenant_id (UUID): The UUID of the tenant
user_id (UUID): The UUID of the user whose roles to list (find user ids via GET /api/v1/permissions/tenants/{tenant_id}/users)

Response

Returns a JSON list of roles scoped to this tenant: [{“id”, “name”}]. A member with no roles in the tenant receives an empty list.

Error Codes

403 Forbidden: Caller lacks user-management permission in the tenant
404 Not Found: User does not exist or is not a member of this tenant

GET

api

permissions

tenants

{tenant_id}

roles

users

{user_id}

Get User Roles

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

import requests

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

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

response = requests.get(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

tenant_id

string<uuid>

required

user_id

string<uuid>

required

Response

Successful Response

⌘I

Get User Roles

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

import requests

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

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

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

print(response.text)

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

Getting Started

auth

add

cognify

memify

search

permissions

datasets

ontologies

settings

visualize

schema

skills

configuration

delete

validate

update

responses

llm

sync

users

checks

health

agent management

agent connections

activity

sessions

remember

recall

improve

forget

slack

integrations

Get User Roles

Path Parameters

Response

Error Codes

Authorizations

Path Parameters

Response