# Cognee Permissions API

**Canonical:** https://apis.io/apis/cognee/cognee-permissions-api/  
**Provider:** Cognee — https://apis.io/providers/cognee/  
**Base URL:** https://api.cognee.ai  
**Documentation:** https://docs.cognee.ai/api-reference/introduction

Cognee Permissions API is one of 32 APIs that [Cognee](https://apis.io/providers/cognee/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Permissions. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

Permission management for multi-user access control.

## Operations (19)

| Method | Path | Summary |
|---|---|---|
| POST | `/api/v1/permissions/datasets/{principal_id}` | Give Datasets Permission To Principal |
| DELETE | `/api/v1/permissions/datasets/{principal_id}` | Revoke Datasets Permission From Principal |
| GET | `/api/v1/permissions/principals/{principal_id}/datasets` | Get Principal Datasets |
| POST | `/api/v1/permissions/roles` | Create Role |
| DELETE | `/api/v1/permissions/roles/{role_id}` | Delete Role Endpoint |
| POST | `/api/v1/permissions/users/{user_id}/roles` | Add User To Role |
| DELETE | `/api/v1/permissions/users/{user_id}/roles` | Remove User From Role Endpoint |
| POST | `/api/v1/permissions/users/{user_id}/tenants` | Add User To Tenant |
| DELETE | `/api/v1/permissions/tenants/{tenant_id}/users/{user_id}` | Remove User From Tenant Endpoint |
| POST | `/api/v1/permissions/tenants` | Create Tenant |
| POST | `/api/v1/permissions/tenants/select` | Select Tenant |
| GET | `/api/v1/permissions/tenants/{tenant_id}/roles` | Get Tenant Roles |
| GET | `/api/v1/permissions/tenants/{tenant_id}/roles/{role_id}/users` | Get Users In Role |
| GET | `/api/v1/permissions/tenants/{tenant_id}/roles/users/{user_id}` | Get User Roles |
| GET | `/api/v1/permissions/tenants/{tenant_id}/users` | Get Users In Tenant |
| GET | `/api/v1/permissions/tenants/me` | Get My Tenants |
| GET | `/api/v1/permissions/tenants/{tenant_id}/capabilities/me` | Get My Capabilities In Tenant |
| POST | `/api/v1/permissions/capabilities/{principal_id}` | Give Capability To Principal |
| DELETE | `/api/v1/permissions/capabilities/{principal_id}` | Revoke Capability From Principal |

## Machine-readable artifacts (3)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/cognee/refs/heads/main/openapi/cognee-permissions-api-openapi.yml
- **Documentation** — https://docs.cognee.ai/api-reference/introduction
- **SwaggerUI** — https://api.cognee.ai/docs

## Other Cognee APIs (12)

- [Cognee Cognify API](https://apis.io/apis/cognee/cognee-cognify-api/)
- [Cognee Datasets API](https://apis.io/apis/cognee/cognee-datasets-api/)
- [Cognee Health API](https://apis.io/apis/cognee/cognee-health-api/)
- [Cognee Search API](https://apis.io/apis/cognee/cognee-search-api/)
- [Cognee Settings API](https://apis.io/apis/cognee/cognee-settings-api/)
- [Cognee Activity API](https://apis.io/apis/cognee/cognee-activity-api/)
- [Cognee Add API](https://apis.io/apis/cognee/cognee-add-api/)
- [Cognee agent connections API](https://apis.io/apis/cognee/cognee-agent-connections-api/)
- [Cognee agent management API](https://apis.io/apis/cognee/cognee-agent-management-api/)
- [Cognee Auth API](https://apis.io/apis/cognee/cognee-auth-api/)
- [Cognee Checks API](https://apis.io/apis/cognee/cognee-checks-api/)
- [Cognee Configuration API](https://apis.io/apis/cognee/cognee-configuration-api/)

## Tags

Permissions

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/cognee/cognee-permissions-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/cognee/.