---
title: "POST /gateway-create-allowed-access"
method: POST
path: "/gateway-create-allowed-access"
tags: ["v2"]
---

# POST /gateway-create-allowed-access

`POST /gateway-create-allowed-access`

## Request body

- GatewayCreateAllowedAccess — gatewayCreateAllowedAccess is a command that creates allowed access in Gator
  - `SubClaimsCaseInsensitive` boolean
  - `access-id` string, required — Access ID The access id to be attached to this allowed access. Auth method with this access id should already exist.
  - `case-sensitive` string — Treat sub claims as case-sensitive [true/false]
  - `description` string — Allowed access description
  - `json` boolean — Set output format to JSON
  - `name` string, required — Allowed access name
  - `permissions` string — Permissions Comma-seperated list of permissions for this allowed access. Available permissions: [defaults,targets,classic_keys,automatic_migration,ldap_auth,dynamic_secret,k8s_auth,log_forwarding,zero_knowledge_encryption,rotated_secret,caching,event_forwarding,admin,kmip,general,rotate_secret_value]
  - `sub-claims` object — Sub claims key/val of sub claims, e.g group=admins,developers
  - `token` string — Authentication token (see `/auth` and `/configure`)
  - `uid-token` string — The universal identity token, Required only for universal_identity authentication

## Response `200`

gatewayCreateAllowedAccessResponse wraps response body.

- AllowedAccess
  - `access_id` string
  - `access_type` string
  - `cluster_id` integer
  - `created_at` string, date-time
  - `description` string
  - `editable` boolean
  - `error` string
  - `id` integer
  - `is_valid` boolean
  - `name` string
  - `permissions` AccessPermission[]
  - `sub_claims` object
  - `sub_claims_case_insensitive` boolean
  - `updated_at` string, date-time

## Other responses

- `default` — errorResponse wraps any error to return it as a JSON object with one "error" field.

---

[API](https://skmtc.net/akeyless/apis/akeyless-api.md) · [All operations](https://skmtc.net/akeyless/apis/akeyless-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/akeyless/akeyless-api/versions/0ceb25634501/schema)