role

Create Role

Creates a role with the specified name, description, and permissions.

post/management/v1/role

Request

Headers

x-project-idstring nullable

Project ID (optional; falls back to the default project if not provided)

Request body

descriptionstring nullable

Description of the role

namestring required

Name of the role to create

project-idstring nullable

Project ID in which the role is created. Deprecated: Please use the x-project-id header instead.

provider-idstring nullable

Provider that owns this role (e.g. "lakekeeper", "oidc"). Must be provided together with source-id. Omit both to let the server assign provider-id = "lakekeeper" and a fresh UUIDv7 source-id.

source-idstring nullable

Identifier of the role in the provider. Must be provided together with provider-id.

Response

Role successfully created

created-atstring date-time required

Timestamp when the role was created

descriptionstring nullable

Description of the role

idstring uuid required

Globally unique UUID identifier

identstring required

Composite project-scoped identifier (provider~source_id). Unique within a project.

namestring required

Name of the role

project-idstring required

Project ID in which the role is created.

provider-idstring required

Provider that owns this role (e.g. "lakekeeper", "oidc").

source-idstring required

Identifier of the role in the provider.

updated-atstring date-time nullable

Timestamp when the role was last updated

Changes

No recorded changes to this operation across all 1 revision of this API.