---
title: "Remove one grant's access to a team"
method: DELETE
path: "/v1/teams/{teamRef}/grants/{grantId}"
tags: ["Teams"]
---

# Remove one grant's access to a team

`DELETE /v1/teams/{teamRef}/grants/{grantId}`

## Request

- Base URL: `https://api.spacefast.com`
- URL: `https://api.spacefast.com/v1/teams/{teamRef}/grants/{grantId}`
- Auth: HTTP bearer

Subtracts this team from the grant's reach. The member keeps any access the grant has in their other teams; only when nothing remains does the grant fully revoke. Team administrators only, and only for grants whose scope reaches this team.

## Path parameters

- `teamRef` string, required
- `grantId` string, required

## Response `204`

The grant no longer reaches this team.

---

[API](https://skmtc.dev/spacefast/apis/spacefast-api.md) · [All operations](https://skmtc.dev/spacefast/apis/spacefast-api/llms.txt) · [OpenAPI document](https://skmtc.dev/spacefast/apis/spacefast-api/revisions/bd165bc7c983?raw)