---
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}`

## Request

- Base URL: `https://api.datadoghq.com`
- URL: `https://api.datadoghq.com/api/v2/team/{team_id}/permission-settings/{action}`
- Auth: one of:
  - API key in header `DD-API-KEY` and API key in header `DD-APPLICATION-KEY`
  - OAuth 2
    - Authorization code: `/oauth2/v1/authorize`
    - Token URL: `/oauth2/v1/token` scopes: `teams_read`

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.dev/datadog/apis/datadog-api-v2-collection.md) - [All operations](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/llms.txt) - [OpenAPI document](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/revisions/da68bf029e4c?raw)