# Contabo Roles API

**Canonical:** https://apis.io/apis/contabo/contabo-roles-api/  
**Provider:** Contabo — https://apis.io/providers/contabo/  
**Base URL:** https://api.contabo.com  
**Documentation:** https://api.contabo.com/

Contabo Roles API is one of 39 APIs that [Contabo](https://apis.io/providers/contabo/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include Roles. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and 6 JSON Schemas.

Give access to all api endpoints and resources or manage to which endpoints and resources individual users might have access to. Permissions are organized in roles. Users can have roles assigned. Roles can grant and restrict access to different API's or to specific resources. Permissions for resources are declared by using tags which have been assigned to resources.

## Operations (6)

| Method | Path | Summary |
|---|---|---|
| GET | `/v1/roles` | List roles |
| POST | `/v1/roles` | Create a new role |
| GET | `/v1/roles/{roleId}` | Get specific role by id |
| PUT | `/v1/roles/{roleId}` | Update specific role by id |
| DELETE | `/v1/roles/{roleId}` | Delete existing role by id |
| GET | `/v1/roles/api-permissions` | List of API permissions |

## Machine-readable artifacts (9)

- **OpenAPI** — https://artifacts.apis.io/contabo/openapi/contabo-roles-api-openapi.yml
- **Documentation** — https://api.contabo.com/
- **CLI** — https://github.com/contabo/cntb
- **JSONSchema** — https://artifacts.apis.io/contabo/json-schema/contabo-create-instance-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/contabo/json-schema/contabo-handle-create-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/contabo/json-schema/contabo-handle-patch-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/contabo/json-schema/contabo-create-user-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/contabo/json-schema/contabo-reinstall-instance-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/contabo/json-schema/contabo-update-user-request-schema.json

## Other Contabo APIs (12)

- [Contabo Check Collection Templates API](https://apis.io/apis/contabo/contabo-check-collection-templates-api/)
- [Contabo Check Collections API](https://apis.io/apis/contabo/contabo-check-collections-api/)
- [Contabo Checks API](https://apis.io/apis/contabo/contabo-checks-api/)
- [Contabo DNS API](https://apis.io/apis/contabo/contabo-dns-api/)
- [Contabo DNS Audits API](https://apis.io/apis/contabo/contabo-dns-audits-api/)
- [Contabo Domains API](https://apis.io/apis/contabo/contabo-domains-api/)
- [Contabo Domains Audits API](https://apis.io/apis/contabo/contabo-domains-audits-api/)
- [Contabo Firewalls API](https://apis.io/apis/contabo/contabo-firewalls-api/)
- [Contabo Firewalls Audits API](https://apis.io/apis/contabo/contabo-firewalls-audits-api/)
- [Contabo Handles API](https://apis.io/apis/contabo/contabo-handles-api/)
- [Contabo Handles Audits API](https://apis.io/apis/contabo/contabo-handles-audits-api/)
- [Contabo Images API](https://apis.io/apis/contabo/contabo-images-api/)

## Tags

Roles

---

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