Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Kinde Roles API

The Roles API from Kinde — 7 operation(s) for roles.

Kinde Roles API is one of 31 APIs that Kinde publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 9 JSON Schema definitions.

Tagged areas include Roles. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, a getting-started guide, authentication docs, and 9 JSON Schemas.

This API exposes 12 operations across 7 paths, and defines 15 schemas. It is described by OpenAPI 3.0.0, at version 1.

Requests are made against the base URL https://{subdomain}.kinde.com/api/v1.

12 operations 7 paths 15 schemas 3 DELETE5 GET2 PATCH2 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.0
API Version
1
Base URL
https://{subdomain}.kinde.com/api/v1
Authentication
HTTP Bearer
Terms of Service
Resource Areas
1

Authentication & Security 1

Kinde Roles API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (JWT) (kindeBearerAuth).

  • kindeBearerAuth — To access these endpoints, you will need to use a user token. This can be obtained when your users sign in via the methods you've setup in Kinde (e.g. Google,…

Paths & Operations 12

Across 7 paths, the API surfaces 12 operations — 3 DELETE, 5 GET, 2 PATCH, 2 POST. Each is listed below with its method, path, parameters, and response codes.

Roles 12
GET
/account_api/v1/roles
Get roles
GetUserRoles 2 params → 200403429
GET
/api/v1/roles
List roles
GetRoles 3 params → 200400403429
POST
/api/v1/roles
Create role
CreateRole body → 201400403429
GET
/api/v1/roles/{role_id}
Get role
GetRole 1 param → 200400403429
PATCH
/api/v1/roles/{role_id}
Update role
UpdateRoles 1 param body → 201400403429
DELETE
/api/v1/roles/{role_id}
Delete role
DeleteRole 1 param → 200400403429
GET
/api/v1/roles/{role_id}/scopes
Get role scopes
GetRoleScopes 1 param → 200400403429
POST
/api/v1/roles/{role_id}/scopes
Add role scope
AddRoleScope 1 param body → 201400403429
DELETE
/api/v1/roles/{role_id}/scopes/{scope_id}
Delete role scope
DeleteRoleScope 2 params → 200400403429
GET
/api/v1/roles/{role_id}/permissions
Get role permissions
GetRolePermissions 4 params → 200400403429
PATCH
/api/v1/roles/{role_id}/permissions
Update role permissions
UpdateRolePermissions 1 param body → 200403429
DELETE
/api/v1/roles/{role_id}/permissions/{permission_id}
Remove role permission
RemoveRolePermission 2 params → 200400403429

Schemas 15

The contract defines 15 schemas that model the data the API accepts and returns. The most detailed are roles (5 properties), update_role_permissions_response (4 properties), get_roles_response (4 properties), scopes (4 properties). Each schema is shown below with its type and property counts.

update_role_permissions_response
object
4 properties
roles
object
5 properties
error
object
2 properties
permissions
object
4 properties
get_user_roles_response
object
2 properties
scopes
object
4 properties
get_roles_response
object
4 properties
delete_role_scope_response
object
2 properties
error_response
object
1 property
get_role_response
object
3 properties
success_response
object
2 properties
create_roles_response
object
3 properties
role_scopes_response
object
3 properties
add_role_scope_response
object
2 properties
role_permissions_response
object
4 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

kinde-roles-api-openapi.yml Raw ↑

Other APIs Kinde publishes across the network.

Kinde MCP Server
Kinde API Keys API
Kinde APIs API
Kinde Applications API
Kinde Billing Agreements API
Kinde Billing API
Kinde Billing Entitlements API
Kinde Billing Meter Usage API
Kinde Business API
Kinde Callbacks API
Kinde Connected Apps API
Kinde Connections API