---
title: "Changes to Create a custom role"
method: POST
path: "/teams/{team_id}/create_custom_role"
---

# Changes to Create a custom role

`POST /teams/{team_id}/create_custom_role`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 3 of 6 revisions.

- **2026-08-27** `005e83eb28f0` — 6 warning, 6 info
- **2026-08-25** `d6dde3ef057c` — 1 info
- **2026-07-26** `cfe35d359fba` — 1 warning, 1 info

## Changes

- **2026-08-27** `005e83eb28f0` — 6 warning, 6 info
  - added the new `deployment:aiGateway:use` enum value to the `statements/items/actions/oneOf[subschema #2]/items/` response property for the response status `201`
  - added the new `directorySync:deleteGroupMapping` enum value to the `statements/items/actions/oneOf[subschema #2]/items/` response property for the response status `201`
  - added the new `directorySync:disable` enum value to the `statements/items/actions/oneOf[subschema #2]/items/` response property for the response status `201`
  - added the new `directorySync:enable` enum value to the `statements/items/actions/oneOf[subschema #2]/items/` response property for the response status `201`
  - added the new `directorySync:updateGroupMapping` enum value to the `statements/items/actions/oneOf[subschema #2]/items/` response property for the response status `201`
  - added the new `directorySync:view` enum value to the `statements/items/actions/oneOf[subschema #2]/items/` response property for the response status `201`
  - added the new `deployment:aiGateway:use` enum value to the request property `statements/items/actions/oneOf[subschema #2]/items/`
  - added the new `directorySync:deleteGroupMapping` enum value to the request property `statements/items/actions/oneOf[subschema #2]/items/`
  - added the new `directorySync:disable` enum value to the request property `statements/items/actions/oneOf[subschema #2]/items/`
  - added the new `directorySync:enable` enum value to the request property `statements/items/actions/oneOf[subschema #2]/items/`
  - added the new `directorySync:updateGroupMapping` enum value to the request property `statements/items/actions/oneOf[subschema #2]/items/`
  - added the new `directorySync:view` enum value to the request property `statements/items/actions/oneOf[subschema #2]/items/`
- **2026-08-25** `d6dde3ef057c` — 1 info
  - the endpoint scheme security `OAuth Team Token` was removed from the API
- **2026-07-26** `cfe35d359fba` — 1 warning, 1 info
  - added the new `deployment:usage:view` enum value to the `statements/items/actions/oneOf[subschema #2]/items/` response property for the response status `201`
  - added the new `deployment:usage:view` enum value to the request property `statements/items/actions/oneOf[subschema #2]/items/`

---

[Operation](https://skmtc.dev/convex/apis/convex-management-api/docs/teams/:team_id/create_custom_role/post.md) · [API](https://skmtc.dev/convex/apis/convex-management-api.md) · [Page](https://skmtc.dev/convex/apis/convex-management-api/changes/teams/:team_id/create_custom_role/post)