# Cockroach Labs Role Management API

**Canonical:** https://apis.io/apis/cockroach-labs/cockroach-labs-role-management-api/  
**Provider:** Cockroach Labs — https://apis.io/providers/cockroach-labs/  
**Base URL:** https://cockroachlabs.cloud  
**Documentation:** https://www.cockroachlabs.com/docs/cockroachcloud/cloud-api

Cockroach Labs Role Management API is one of 26 APIs that [Cockroach Labs](https://apis.io/providers/cockroach-labs/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Role Management. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

Manage role-based access control, including assigning and removing roles for users across organization, folder, and cluster scopes.

## Operations (6)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/v1/roles` | List role grants |
| GET | `/api/v1/roles/{user_id}` | Get all roles for a user |
| PUT | `/api/v1/roles/{user_id}` | Set roles for a user |
| POST | `/api/v1/roles/{user_id}/{resource_type}/{resource_id}/{role_name}` | Add user to role |
| DELETE | `/api/v1/roles/{user_id}/{resource_type}/{resource_id}/{role_name}` | Remove user from role |
| GET | `/api/v1/users/persons-by-email` | Get person users by email |

## Machine-readable artifacts (5)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/cockroach-labs/refs/heads/main/openapi/cockroach-labs-role-management-api-openapi.yml
- **Documentation** — https://www.cockroachlabs.com/docs/cockroachcloud/cloud-api
- **APIReference** — https://www.cockroachlabs.com/docs/api/cloud/v1
- **Documentation** — https://www.cockroachlabs.com/docs/stable/cluster-api
- **APIReference** — https://www.cockroachlabs.com/docs/api/cluster/v2

## Other Cockroach Labs APIs (12)

- [Cockroach Labs Auth API](https://apis.io/apis/cockroach-labs/cockroach-labs-auth-api/)
- [Cockroach Labs Billing API](https://apis.io/apis/cockroach-labs/cockroach-labs-billing-api/)
- [Cockroach Labs Clusters API](https://apis.io/apis/cockroach-labs/cockroach-labs-clusters-api/)
- [Cockroach Labs CMEK API](https://apis.io/apis/cockroach-labs/cockroach-labs-cmek-api/)
- [Cockroach Labs Databases API](https://apis.io/apis/cockroach-labs/cockroach-labs-databases-api/)
- [Cockroach Labs EgressRules API](https://apis.io/apis/cockroach-labs/cockroach-labs-egressrules-api/)
- [Cockroach Labs Folders API](https://apis.io/apis/cockroach-labs/cockroach-labs-folders-api/)
- [Cockroach Labs Health API](https://apis.io/apis/cockroach-labs/cockroach-labs-health-api/)
- [Cockroach Labs IPAllowlists API](https://apis.io/apis/cockroach-labs/cockroach-labs-ipallowlists-api/)
- [Cockroach Labs JWTIssuers API](https://apis.io/apis/cockroach-labs/cockroach-labs-jwtissuers-api/)
- [Cockroach Labs LogExport API](https://apis.io/apis/cockroach-labs/cockroach-labs-logexport-api/)
- [Cockroach Labs MetricExport API](https://apis.io/apis/cockroach-labs/cockroach-labs-metricexport-api/)

## Tags

Role Management

---

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