POST /api/role/{workspace_id}/

Abuse reports1

Admin23

Admin data scanner10

Agent applications1

Agents4

AI Assistant9

AI providers13

api5

Applications8

Audit log8

Auth15

Automation history3

Automation nodes8

Automation workflows9

Builder data sources11

Builder domains7

Builder elements7

Builder pages5

Builder preview3

Builder public6

Builder theme1

Builder workflow actions7

Core webhooks5

Dashboard data sources3

Dashboard widgets5

Database table calendar view2

Database table export2

Database table fields18

Database table form view5

Database table gallery view2

Database table grid view8

Database table kanban view2

Database table rows17

Database table timeline view2

Database table view decorations5

Database table view export2

Database table view filters9

Database table view groupings6

Database table view sortings6

Database table views19

Database table webhooks6

Database tables18

Database tokens6

Field permissions3

Field rules5

Health3

Inbound email1

Integrations5

Jobs4

Last viewed1

MCP endpoints5

Notifications4

Role assignments3

Search1

Secure file serve1

Settings3

Snapshots4

Subjects1

Teams9

Templates3

Trash4

User18

User files2

User source roles1

User sources14

Workspace invitations8

Workspaces16

Role assignments

Changed on Sep 30, 2026

You can assign a role to a subject into the given workspace for the given scope with this endpoint. If you want to remove the role you can omit the role property.

post/api/role/{workspace_id}/

Request

Base URL
https://api.baserow.io (the document declares no server; this is the origin it was published from)
URL
https://api.baserow.io/api/role/{workspace_id}/
Auth
HTTP bearer

Path parameters

workspace_idinteger required

The workspace in which the role assignment takes place.

Request body

subject_idinteger required

The subject ID. A subject is an actor that can do operations.

auth.User - auth.User
anonymous - anonymous
user_source.user - user_source.user
core.Agent - core.Agent
core.Token - core.Token
builder_preview_actor - builder_preview_actor
baserow_enterprise.Team - baserow_enterprise.Team

rolestring nullable required

The uid of the role you want to assign to the user or team in the given workspace. You can omit this property if you want to remove the role.

scope_idinteger required

The ID of the scope object. The scope object limit the role assignment to this scope and all its descendants.

core - core
application - application
workspace - workspace
workspace_invitation - workspace_invitation
snapshot - snapshot
workspace_user - workspace_user
integration - integration
user_source - user_source
mcp_endpoint - mcp_endpoint
database - database
database_table - database_table
database_field - database_field
database_view - database_view
database_view_decoration - database_view_decoration
database_view_sort - database_view_sort
database_view_group - database_view_group
database_view_filter - database_view_filter
database_view_filter_group - database_view_filter_group
token - token
builder - builder
builder_page - builder_page
builder_element - builder_element
builder_domain - builder_domain
builder_data_source - builder_data_source
builder_workflow_action - builder_workflow_action
dashboard - dashboard
dashboard_data_source - dashboard_data_source
dashboard_widget - dashboard_widget
automation - automation
automation_workflow - automation_workflow
automation_node - automation_node
team - team
team_subject - team_subject
license - license

Response

idinteger required

rolestring required

The uid of the role assigned to the user or team in the given workspace.

subject_idinteger required

The subject ID.

scope_idinteger required

The unique scope ID.

auth.User - auth.User
anonymous - anonymous
user_source.user - user_source.user
core.Agent - core.Agent
core.Token - core.Token
builder_preview_actor - builder_preview_actor
baserow_enterprise.Team - baserow_enterprise.Team

core - core
application - application
workspace - workspace
workspace_invitation - workspace_invitation
snapshot - snapshot
workspace_user - workspace_user
integration - integration
user_source - user_source
mcp_endpoint - mcp_endpoint
database - database
database_table - database_table
database_field - database_field
database_view - database_view
database_view_decoration - database_view_decoration
database_view_sort - database_view_sort
database_view_group - database_view_group
database_view_filter - database_view_filter
database_view_filter_group - database_view_filter_group
token - token
builder - builder
builder_page - builder_page
builder_element - builder_element
builder_domain - builder_domain
builder_data_source - builder_data_source
builder_workflow_action - builder_workflow_action
dashboard - dashboard
dashboard_data_source - dashboard_data_source
dashboard_widget - dashboard_widget
automation - automation
automation_workflow - automation_workflow
automation_node - automation_node
team - team
team_subject - team_subject
license - license

Changes

Sep 30, 2026e81714236040 Revision changes
- breaking
  added to the request property allOf list (media type: application/json)
- breaking
  added to the request property allOf list (media type: application/x-www-form-urlencoded)
- breaking
  added to the request property allOf list (media type: multipart/form-data)
- breaking
  removed the enum value database_workflow_action of the request property //// (media type: application/json)
- breaking
  removed the enum value database_workflow_action of the request property //// (media type: application/x-www-form-urlencoded)
- breaking
  removed the enum value database_workflow_action of the request property //// (media type: multipart/form-data)
- warning
  removed from the request property allOf list (media type: application/json)
- warning
  removed from the request property allOf list (media type: application/x-www-form-urlencoded)
- warning
  removed from the request property allOf list (media type: multipart/form-data)
- info
  the endpoint scheme security UserSource JWT was removed from the API
- info
  added to the response property allOf list for the response status
- info
  removed from the response property allOf list for the response status
- info
  removed the database_workflow_action enum value from the //// response property for the response status
Sep 15, 202651b737b57ec4 Revision changes
- breaking
  added to the request property allOf list (media type: application/json)
- breaking
  added to the request property allOf list (media type: application/x-www-form-urlencoded)
- breaking
  added to the request property allOf list (media type: multipart/form-data)
- warning
  removed from the request property allOf list (media type: application/json)
- warning
  removed from the request property allOf list (media type: application/x-www-form-urlencoded)
- warning
  removed from the request property allOf list (media type: multipart/form-data)
- info
  added to the response property allOf list for the response status
- info
  removed from the response property allOf list for the response status

Operation history (3 revisions)

Request

Path parameters

Request body

Response 200OK

Changes

Response