nexlink/docs/api/role.md
2025-12-28 13:34:40 +01:00

1.1 KiB

GET /api/v1/role/{id}

Requires an authorization header

Returns a role with id = {id}

Response:

{
    "id": "string",
    "name": "string",
    "communityId": "string",
    "creationDate": 0
}

POST /api/v1/role

Requires an authorization header

Request:

{
    "name": "string",
    "communityId": "string",
    "permissions": "string[]"
}

Creates a new role and returns it

Response:

{
    "id": "string",
    "name": "string",
    "communityId": "string"
}

POST /api/v1/role/{id}/assign

Requires an authorization header

Request:

{
    "userId": "string"
}

Assigns a role to a user

Response:

{
    "id": "string",
    "name": "string",
    "communityId": "string",
    "userId": "string"
}

POST /api/v1/role/{id}/unassign

Requires an authorization header

Request:

{
    "userId": "string"
}

Unassigns a role from a user

Response:

{
    "id": "string",
    "name": "string",
    "communityId": "string",
    "userId": "string"
}