---
title: "Updates a document space team's access."
method: PUT
path: "/documentspaces/{documentSpaceId}/teams/{documentSpaceToTeamId}"
tags: ["documentSpaces"]
---

# Updates a document space team's access.

`PUT /documentspaces/{documentSpaceId}/teams/{documentSpaceToTeamId}`

## Request

- Base URL: `https://api.awork.com/api/v1`
- URL: `https://api.awork.com/api/v1/documentspaces/{documentSpaceId}/teams/{documentSpaceToTeamId}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/awork-io/apis/awork-io/docs/documentspaces/:documentSpaceId/teams/:documentSpaceToTeamId/put.ts> (a function with typed inputs; its response is checked against the schema)

Updates the specified team's access to the document space and its documents.

<Check title="Required Permissions" icon="key">The user must be an admin.</Check>

## Path parameters

- `documentSpaceId` string, uuid, required
- `documentSpaceToTeamId` string, uuid, required

## Request body

- EntityToTeamForm
  - `accessLevel` 'read' | 'manage', required: Determines the level of access granted to this contributor or team with respect to the referenced entity. Can be either set to `read` or `manage` where `read` allows viewing the entity and `manage` allows full control over it (read, write and permission changes).

## Response `200`

OK

- MinimalEntityToTeamModel
  - `id` string, uuid: The id of the entity to team.
  - `teamId` string, uuid: The id of the team this entity to team references.
  - `accessLevel` string, nullable: Determines the level of access granted to this entity to team with respect to the specific entity. Can be either set to `read` or `manage`.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `404`: Not Found

## Changes

- **2026-09-17** `1556e0487867`: 1 warning, 1 info
  - deleted the `header` request parameter `Authorization`
  - the endpoint scheme security `oauth2` was added to the API
- **2026-09-12** `8e46cf415581`: 1 info
  - api operation id `PutDocumentSpaceTeamByDocumentSpaceIdAndDocumentSpaceToTeamId` removed and replaced with `documentSpaces_PutDocumentSpaceTeamByDocumentSpaceIdAndDocumentSpaceToTeamId`

[Operation history](https://skmtc.dev/awork-io/apis/awork-io/changes/documentspaces/:documentSpaceId/teams/:documentSpaceToTeamId/put.md)

---

[API](https://skmtc.dev/awork-io/apis/awork-io.md) - [All operations](https://skmtc.dev/awork-io/apis/awork-io/llms.txt) - [OpenAPI document](https://skmtc.dev/awork-io/apis/awork-io/revisions/81151fac7e79?raw)