Skip to main content
POST
/
console
/
v1
/
roles
Create Role
curl --request POST \
  --url https://statsigapi.net/console/v1/roles \
  --header 'Content-Type: application/json' \
  --header 'STATSIG-API-KEY: <api-key>' \
  --data '{
  "name": "<string>",
  "permissions": {
    "invitation_access": true,
    "create_configs": true,
    "edit_or_delete_configs": true,
    "launch_to_production": true,
    "launch_or_disable_configs": true,
    "start_experiments": true,
    "create_or_edit_templates": true,
    "create_or_edit_dashboards": true,
    "create_teams": true,
    "edit_dynamic_config_schemas": true,
    "create_release_pipelines": true,
    "approve_required_review_release_pipeline_phase": true,
    "self_approve_review": true,
    "approve_reviews": true,
    "bypass_reviews_for_overrides": true,
    "metric_management": true,
    "event_dimensions_access": true,
    "verify_metrics": true,
    "use_metrics_explorer": true,
    "local_metrics": true,
    "manage_alerts": true,
    "integrations_edit_access": true,
    "source_connection_and_creation": true,
    "data_warehouse_ingestion_and_exports_edit_access": true,
    "edit_and_tag_configs_with_core_tag": true,
    "reset_experiments": true,
    "manual_whn_reload": true
  }
}'
{
  "message": "Role created successfully.",
  "data": {
    "name": "Custom Role",
    "permissions": {
      "invitation_access": false,
      "create_configs": false,
      "edit_or_delete_configs": false,
      "launch_to_production": false,
      "launch_or_disable_configs": false,
      "start_experiments": false,
      "create_or_edit_templates": false,
      "create_or_edit_dashboards": false,
      "create_teams": false,
      "edit_dynamic_config_schemas": false,
      "create_release_pipelines": false,
      "approve_required_review_release_pipeline_phase": false,
      "self_approve_review": false,
      "approve_reviews": false,
      "bypass_reviews_for_overrides": false,
      "metric_management": false,
      "verify_metrics": false,
      "use_metrics_explorer": false,
      "local_metrics": false,
      "manage_alerts": false,
      "integrations_edit_access": false,
      "source_connection_and_creation": false,
      "data_warehouse_ingestion_and_exports_edit_access": false,
      "edit_and_tag_configs_with_core_tag": false,
      "reset_experiments": false
    }
  }
}

Authorizations

STATSIG-API-KEY
string
header
required

Headers

x-respect-review-settings
string

Optional header to respect review settings for mutation endpoints.

Body

application/json
name
string
required

The name of the role.

permissions
object
required

The permissions of the role.

Response

Create Role Response

message
string
required

A simple string explaining the result of the operation.

data
object
required

A single result.

I