---
title: "Update"
method: POST
path: "/api/v1/settings/request"
tags: ["Request Settings"]
---

# Update

`POST /api/v1/settings/request`

Update modifies the tenant's access-request settings.

## Request body

- C1ApiSettingsV1UpdateRequestSettingsRequest — The UpdateRequestSettingsRequest message.
  - `requestSettings` C1ApiSettingsV1RequestSettings — RequestSettings holds tenant-wide configuration for the access-request flow.
    - `maxBulkEntitlementSelection` integer — MaxBulkEntitlementSelection caps the number of entitlements a requester may select in a single bulk access request. Reads always return the effective value — an unset (0) value is presented as the system default of 10. Writing 0 resets the field to unset in storage. Maximum 100.
    - `skipJustification` boolean — When true, request surfaces (webapp, Slack, MS Teams) skip prompting the requester for a justification.
  - `updateMask` string, nullable

## Response `200`

Successful response

- C1ApiSettingsV1UpdateRequestSettingsResponse — The UpdateRequestSettingsResponse message.
  - `requestSettings` C1ApiSettingsV1RequestSettings — RequestSettings holds tenant-wide configuration for the access-request flow.
    - `maxBulkEntitlementSelection` integer — MaxBulkEntitlementSelection caps the number of entitlements a requester may select in a single bulk access request. Reads always return the effective value — an unset (0) value is presented as the system default of 10. Writing 0 resets the field to unset in storage. Maximum 100.
    - `skipJustification` boolean — When true, request surfaces (webapp, Slack, MS Teams) skip prompting the requester for a justification.

## Changes

- **2026-09-01** `f76d07868c0c` — 2 info
  - added the new optional request property `requestSettings/oneOf[subschema #1: Request Settings]/maxBulkEntitlementSelection`
  - added the optional property `requestSettings/oneOf[subschema #1: Request Settings]/maxBulkEntitlementSelection` to the response with the `200` status
- **2026-08-21** `f2cf3228f366` — 4 breaking, 2 warning, 1 info
  - the request property `updateMask` became not nullable
  - the `requestSettings` request property type/format changed from `object`/`` to ``/``
  - added `#/components/schemas/c1.api.settings.v1.RequestSettings, subschema #2` to the `requestSettings` response property `oneOf` list for the response status `200`
  - the `requestSettings` response's property type/format changed from `object`/`` to ``/`` for status `200`
  - …3 more
- **2026-05-22** `d391405a35d3` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/conductorone/apis/c1-api/changes/api/v1/settings/request/post.md)

---

[API](https://skmtc.dev/conductorone/apis/c1-api.md) · [All operations](https://skmtc.dev/conductorone/apis/c1-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/conductorone/c1-api/revisions/f76d07868c0c/schema)