---
title: "POST /{stack}/adminconfig/v2/roles"
method: POST
path: "/{stack}/adminconfig/v2/roles"
tags: ["Roles"]
---

# POST /{stack}/adminconfig/v2/roles

`POST /{stack}/adminconfig/v2/roles`

create a new role on the stack

## Path parameters

- `stack` string, required

## Headers

- `Federated-Search-Manage-Ack` string

## Request body

- PostRolesRequest
  - `capabilities` string[]
  - `rtSrchJobsQuota` integer
  - `srchDiskQuota` integer
  - `srchFilter` string
  - `srchIndexesAllowed` string[]
  - `srchIndexesDefault` string[]
  - `srchJobsQuota` integer
  - `srchTimeEarliest` integer
  - `srchTimeWin` integer
  - `cumulativeRTSrchJobsQuota` integer
  - `cumulativeSrchJobsQuota` integer
  - `defaultApp` string
  - `importedRoles` string[]
  - `name` string, required

## Response `200`

successfully created a new role

- RolesResponse
  - `cumulativeRTSrchJobsQuota` integer
  - `cumulativeSrchJobsQuota` integer
  - `defaultApp` string
  - `imported` ImportedRolesInfo
    - `capabilities` string[]
    - `rtSrchJobsQuota` integer
    - `srchDiskQuota` integer
    - `srchFilter` string
    - `srchIndexesAllowed` string[]
    - `srchIndexesDefault` string[]
    - `srchJobsQuota` integer
    - `srchTimeEarliest` integer
    - `srchTimeWin` integer
    - `roles` string[]
  - `name` string, required
  - `capabilities` string[]
  - `rtSrchJobsQuota` integer
  - `srchDiskQuota` integer
  - `srchFilter` string
  - `srchIndexesAllowed` string[]
  - `srchIndexesDefault` string[]
  - `srchJobsQuota` integer
  - `srchTimeEarliest` integer
  - `srchTimeWin` integer

## Other responses

- `default` — unexpected error

---

[API](https://skmtc.dev/splunk/apis/splunk-cloud-admin-api.md) · [All operations](https://skmtc.dev/splunk/apis/splunk-cloud-admin-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/splunk/splunk-cloud-admin-api/revisions/65903649d1c2/schema)