Delete a role

DELETE

/v1/communities/{id}/roles/{roleId}

curl --request DELETE \
  --url https://api.gampeon.com/v1/communities/1/roles/1 \
  --header 'Authorization: Bearer <token>'

• Production

Needs manageRoles, only roles below your highest role. everyone cannot be deleted.

Not available with access tokens.

Authorizations

• session

Parameters

Path Parameters

id

required

integer

>= 1

Community ID

roleId

required

integer

>= 1

Role ID

Responses

204

Deleted

401

Error codes: unauthorized

Media typeapplication/json

object

error

required

Machine-readable error code, for example not_found or rate_limited.

string

message

Human-readable detail. Only present for some errors.

string

Example ^generated

{
  "error": "example",
  "message": "example"
}

403

Error codes: token_not_allowed, missing_permission, role_hierarchy

Media typeapplication/json

object

error

required

Machine-readable error code, for example not_found or rate_limited.

string

message

Human-readable detail. Only present for some errors.

string

Example ^generated

{
  "error": "example",
  "message": "example"
}

404

Error codes: not_found

Media typeapplication/json

object

error

required

Machine-readable error code, for example not_found or rate_limited.

string

message

Human-readable detail. Only present for some errors.

string

Example ^generated

{
  "error": "example",
  "message": "example"
}