Skip to content

Replace datasource permissions

PUT
/api/v1/datasources/{datasourceId}/permissions/{userId}

Atomically replaces one user’s VIEW, USE, and EDIT grant set. ADMIN and CSRF are required.

datasourceId
required
string format: uuid

Datasource identifier.

userId
required
string format: uuid

Target user identifier.

Complete replacement set of grants for one user and datasource.

object
permissions
required
Array<string>
unique items
Allowed values: VIEW USE EDIT VIEW USE EDIT

Datasource grants replaced

Datasource grants grouped for one user.

object
permissions
Array<string>
unique items
Allowed values: VIEW USE EDIT VIEW USE EDIT
userId

Granted user identifier.

string format: uuid
username

Granted user’s current username.

string

The request is malformed or fails validation.

RFC 7807 problem response. Dynamic detail text is credential-redacted.

object
detail
string
instance
string format: uri-reference
status
integer format: int32
title
string
type
string format: uri-reference

Authentication is required or credentials are invalid.

RFC 7807 problem response. Dynamic detail text is credential-redacted.

object
detail
string
instance
string format: uri-reference
status
integer format: int32
title
string
type
string format: uri-reference

The authenticated identity lacks the required permission.

RFC 7807 problem response. Dynamic detail text is credential-redacted.

object
detail
string
instance
string format: uri-reference
status
integer format: int32
title
string
type
string format: uri-reference

The requested resource does not exist or is not visible.

RFC 7807 problem response. Dynamic detail text is credential-redacted.

object
detail
string
instance
string format: uri-reference
status
integer format: int32
title
string
type
string format: uri-reference