---
title: "Update a team within a workspace"
method: PATCH
path: "/workspaces/{slug}/teams/{teamId}"
---

# Update a team within a workspace

`PATCH /workspaces/{slug}/teams/{teamId}`

Requires scope `team:write`.

## Path parameters

- `slug` string, required
- `teamId` string, required

## Request body

- object
  - `name` string
  - `isPrivate` boolean
  - `settings` object
    - `version` string
    - `configuration` object
      - `hosting` object
        - `publish` object
          - `providers` object
            - `sftp` object
              - …
            - `s3` object
              - …
            - `gcs` object
              - …
          - `config` object
            - `disableRedirect` boolean
            - `hashPublishing` boolean
            - `urls` object
              - …
            - `trackVisualizationViews` boolean
            - `disableRedirects` boolean
          - `provider` 'dwcdn' | 's3' | 'sftp' | 'gcs'
        - `export` object
          - `pdf` object
            - `ftp` object
              - …
            - `s3` object
              - …
        - `override` boolean
      - `formats` object
        - `images` object
          - `download` object
            - `format` string
            - `filenameTemplate` string
          - `waitForImagesDuringPublish` boolean
          - `publishFormats` object[]
            - `id` string
            - `borderWidth` number — outer padding, for PNG images
            - `dark` boolean
            - `filename` string
            - `format` 'png' | 'pdf' | 'svg'
            - `height` number
            - `width` number
            - `plain` boolean
            - `logo` 'on' | 'off' | 'auto'
            - `zoom` number — scale factor, for PNG images
            - `scale` number — scale factor, for PDF files
            - `transparent` boolean — determines if PNG background will be transparent or opaque
            - `ligatures` boolean
            - `colorMode` boolean — Color mode, for PDF
            - `unit` 'mm' | 'in' | 'px' — Unit of chosen dimensions, for PDF
        - `data` object
          - `download` object
            - `filenameTemplate` string
            - `localized` boolean
        - `override` boolean
      - `integrations` object
        - `slack` object
          - `enabled` boolean
          - `webhookUrl` string
        - `msTeams` object
          - `enabled` boolean
          - `webhookUrl` string
        - `custom` object
          - `enabled` boolean
          - `webhookUrl` string
          - `unpublishWebhookUrl` string
        - `override` boolean
      - `customFields` object
        - `fields` object[]
          - `key` string, required
          - `title` string, required
          - `type` 'text' | 'number' | 'radio' | 'checkbox' | 'textArea' | 'select', required
          - `description` string, required
          - `items` string, required
          - `displayInArchive` boolean, required
          - `inWorkspace` boolean
        - `override` boolean
      - `preferences` object
        - `defaults` object
          - `height` number
          - `width` number
          - `basemap` string
          - `locale` string
          - `theme` string
          - `embed` object
            - `custom` object
              - …
            - `code` 'responsive' | 'iframe' | 'web-component' | 'custom'
          - `webToPrint` boolean
        - `preview` object
          - `widths` object
            - `mobile` integer
            - `tablet` integer
            - `desktop` integer
        - `override` boolean
      - `hidden` object
        - `enableEditThisChart` boolean
        - `zipEmbedJs` boolean
        - `privateBasemapGroups` object
          - `string` boolean
        - `customFormats` object
          - `date` object[]
            - `label` string
            - `value` string
          - `number` object[]
            - `label` string
            - `value` string
        - `locales` object
          - `numeral` object
          - `dayjs` object
        - `override` boolean
      - `restrictions` object
        - `flags` object
          - `annotate` object
            - `byline` boolean
          - `footer` object
            - `datawrapperAttribution` boolean
            - `downloadImage` boolean
            - `downloadPdf` boolean
            - `downloadSvg` boolean
            - `embed` boolean
            - `getTheData` boolean
          - `layout` object
            - `layoutSelector` boolean
            - `outputLocale` boolean
          - `sharing` object
            - `socialSharing` boolean
        - `restrictDefaultThemes` boolean
        - `disableVisualizations` object
          - `enabled` boolean — Deprecated. Changing this property will have no effect.
          - `allowAdmins` boolean
          - `visualizations` object
            - `string` boolean
        - `disableBasemaps` object
          - `allowAdmins` boolean
          - `enabled` boolean
          - `basemaps` string[]
        - `override` boolean
    - `team` object
      - `preferences` object
        - `defaultFolder` integer
  - `secrets` object
    - `configuration` object
      - `hosting` object
        - `publish` object
          - `providers` object
            - `sftp` object
              - …
            - `s3` object
              - …
            - `gcs` object
              - …
        - `export` object
          - `pdf` object
            - `ftp` object
              - …
            - `s3` object
              - …
        - `override` boolean
  - `icon` 'abc' | 'airpods-pro-max' | 'ambulance' | 'america' | 'analytics' | 'ant' | 'around-the-globe' | 'asia' | 'assistive-technology' | 'barber-scissors' | 'bee' | 'bicycle' | 'binoculars' | 'biohazard' | 'biotech' | 'brezel' | 'bug' | 'bugle' | 'bus' | 'business' | 'butterfly' | 'camera' | 'car' | 'carrot' | 'cash' | 'chat' | 'cherry' | 'circuit' | 'commercial' | 'commodity' | 'company' | 'compass' | 'console' | 'crab' | 'crane-bird' | 'cursor' | 'dog-paw' | 'dog-sit' | 'dolphin' | 'downtown' | 'drafting-compass' | 'dragonfly' | 'drawing' | 'earth-globe' | 'easel' | 'edit' | 'elections' | 'electronics' | 'elephant' | 'elf' | 'europe' | 'evergreen' | 'exclamation-mark' | 'exercise' | 'exterior' | 'factory' | 'fire-truck' | 'flag' | 'float' | 'floods' | 'forest' | 'glasses' | 'goal' | 'graduation-cap' | 'group-task' | 'handshake' | 'hedgehog' | 'highway' | 'hospital-3' | 'hotspot' | 'hourglass' | 'ice-pop-pink' | 'iceberg' | 'kangaroo' | 'key' | 'kiwi-bird' | 'lab-items' | 'laptop' | 'law' | 'leaf' | 'ledger' | 'light-on' | 'lightning-bolt' | 'love' | 'magnet' | 'map-pin' | 'marker-pen' | 'meeting' | 'metal' | 'microphone' | 'microscope' | 'middle-east' | 'money-box' | 'music' | 'musical-notes' | 'my-location' | 'news' | 'nuclear' | 'octopus' | 'oil-pump-jack' | 'onboarding' | 'paint-palette' | 'palm-tree' | 'parliament' | 'partly-cloudy-day' | 'peace-pigeon' | 'pet-commands-train' | 'pin' | 'ping-pong' | 'podium' | 'police-car' | 'police' | 'potted-plant' | 'project' | 'pulse' | 'quick-mode-on' | 'quill-with-ink' | 'quote' | 'rabbit' | 'radio-tower' | 'rain-cloud' | 'recycle' | 'reichstag' | 'restaurant' | 'rod-of-asclepius' | 'rubber-ducky' | 'rules' | 'scales' | 'school-building' | 'scoreboard' | 'seagull' | 'search' | 'sine' | 'siren' | 'snare-drum' | 'soccer-ball' | 'sorting-arrows-horizontal' | 'source-code' | 'spade' | 'sparkles' | 'speech-bubble' | 'spider' | 'sport' | 'stack-of-coins' | 'stadium' | 'star' | 'stethoscope' | 'strawberry' | 'street-view' | 'sun-glasses' | 'swan' | 'sweet-halloween-candy' | 'syringe-with-a-drop-of-blood' | 'tank' | 'tapir' | 'team' | 'temperature' | 'theatre-mask' | 'time' | 'timer' | 'tools' | 'top-view-bird' | 'tractor' | 'traffic-jam' | 'training' | 'tree-planting' | 'trolley' | 'trophy' | 'turtle' | 'tv-show' | 'typewriter-with-paper' | 'umbrella' | 'university-building' | 'us-capitol' | 'video-camera' | 'water-transportation' | 'water' | 'web-accessibility' | 'whale' | 'whole-fish' | 'wildfire' | 'wind-turbine' | 'womens-watch'

## Response `200`

Successful

---

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