Delete Role Endpoint - Cognee Documentation

DELETE

/

api

/

v1

/

permissions

/

roles

/

{role_id}

Delete Role Endpoint

curl --request DELETE \
  --url https://api.cognee.ai/api/v1/permissions/roles/{role_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

role_id

string<uuid>

required

Response

Successful Response

Add User To RoleAdd a user to a role. This endpoint assigns a user to a specific role, granting them all the permissions associated with that role. The authenticated user must be the owner of the role or have appropriate administrative permissions. ## Path Parameters - **user_id** (UUID): The UUID of the user to add to the role ## Request Parameters - **role_id** (UUID): The UUID of the role to assign the user to ## Response Returns a success message indicating the user was added to the role. ## Error Codes - **400 Bad Request**: Invalid user or role ID - **403 Forbidden**: User doesn't have permission to assign roles - **404 Not Found**: User or role doesn't exist - **500 Internal Server Error**: Error adding user to role

⌘I

Delete Role Endpoint

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

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