---
title: "Update permission setting for team"
method: PUT
path: "/api/v2/team/{team_id}/permission-settings/{action}"
tags: ["Teams"]
---

# Update permission setting for team

`PUT /api/v2/team/{team_id}/permission-settings/{action}`

Update a team permission setting for a given team.

## Path parameters

- `team_id` string, required
- `action` string, required

## Request body

- TeamPermissionSettingUpdateRequest — Team permission setting update request
  - `data` TeamPermissionSettingUpdate, required — Team permission setting update
    - `attributes` TeamPermissionSettingUpdateAttributes — Team permission setting update attributes
      - `value` 'admins' | 'members' | 'organization' | 'user_access_manage' | 'teams_manage' — What type of user is allowed to perform the specified action
    - `type` 'team_permission_settings', required — Team permission setting type

## Response `200`

OK

- TeamPermissionSettingResponse — Team permission setting response
  - `data` TeamPermissionSetting — Team permission setting
    - `attributes` TeamPermissionSettingAttributes — Team permission setting attributes
      - `action` 'manage_membership' | 'edit' — The identifier for the action
      - `editable` boolean — Whether or not the permission setting is editable by the current user
      - `options` TeamPermissionSettingValue[] — Possible values for action
      - `title` string — The team permission name
      - `value` 'admins' | 'members' | 'organization' | 'user_access_manage' | 'teams_manage' — What type of user is allowed to perform the specified action
    - `id` string, required — The team permission setting's identifier
    - `type` 'team_permission_settings', required — Team permission setting type

## Other responses

- `403` — Forbidden
- `404` — API error response.
- `429` — Too many requests

---

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