POST /api/role/:workspace_id — baserow-api-spec

Abuse reports1

Admin23

Admin data scanner10

AI Assistant9

AI providers10

Applications8

Audit log8

Auth15

Automation history2

Automation nodes8

Automation workflows9

Builder data sources11

Builder domains7

Builder elements7

Builder pages5

Builder public6

Builder theme1

Builder workflow actions7

Core webhooks5

Dashboard data sources3

Dashboard widgets4

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 views18

Database table webhooks6

Database tables18

Database tokens6

Field permissions3

Field rules5

Health3

Integrations5

Jobs4

MCP endpoints5

Notifications4

Role assignments3

Search1

Secure file serve1

Settings3

Snapshots4

Teams9

Templates3

Trash4

User17

User files2

User source roles1

User sources14

Workspace invitations8

Workspaces18

Role assignments

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}/

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.

subject_type'auth.User' | 'anonymous' | 'user_source.user' | 'core.Token' | 'baserow_enterprise.Team' required

auth.User - auth.User
anonymous - anonymous
user_source.user - user_source.user
core.Token - core.Token
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
database_workflow_action - database_workflow_action
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.

subject_type'auth.User' | 'anonymous' | 'user_source.user' | 'core.Token' | 'baserow_enterprise.Team' required

auth.User - auth.User
anonymous - anonymous
user_source.user - user_source.user
core.Token - core.Token
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
database_workflow_action - database_workflow_action
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

Changed in 1 of the 6 revisions of this API.13

Aug 27, 2026f3396317d93213See the full diff
- ●
  added the new database_workflow_action enum value to the scope_type/allOf[ScopeTypeEnum]/ response property for the response status 200
  response-property-enum-value-added
- ○
  added the new database_workflow_action enum value to the request property scope_type/allOf[ScopeTypeEnum]/ (media type: application/json)
  request-property-enum-value-added
- ○
  added the new database_workflow_action enum value to the request property scope_type/allOf[ScopeTypeEnum]/ (media type: application/x-www-form-urlencoded)
  request-property-enum-value-added
- ○
  added the new database_workflow_action enum value to the request property scope_type/allOf[ScopeTypeEnum]/ (media type: multipart/form-data)
  request-property-enum-value-added
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history