---
title: "Remove users from tags."
method: DELETE
path: "/api/v1/projects/{projectId}/labels/users"
tags: ["Tags"]
---

# Remove users from tags.

`DELETE /api/v1/projects/{projectId}/labels/users`

## Request

- Base URL: `https://app.customgpt.ai`
- URL: `https://app.customgpt.ai/api/v1/projects/{projectId}/labels/users`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/poll-the-people/apis/customgpt-ai/docs/api/v1/projects/:projectId/labels/users/delete.ts> (a function with typed inputs; its response is checked against the schema)

Removes specific users from one or more tags without affecting other users'
assignments. Use this when offboarding users or revoking access to specific content.

Tags are called *labels* in the API, so paths and fields use `label` (for example `labelId` and `labels`).

## Path parameters

- `projectId` integer, required

## Request body

- object
  - `labels` object[]: List of tags and users to remove
    - `id` integer: Tag ID
    - `users` string[]: List of user emails to remove from this tag

## Response `200`

Delete tag-user mappings for a project

- object
  - `status` 'error' | 'success': The status of the response
  - `data` object
    - `deleted` boolean: Indicates whether the delete operation was successful

## Other responses

- `400`: Bad Argument
- `401`: API Token is either missing or invalid
- `403`: Source labeling feature is not enabled for this account.
- `404`: Agent not found
- `429`: Too many requests. You have exceeded your API rate limit.
- `500`: Internal Server Error

## Changes

- **2026-11-03** `77aab4354382`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/poll-the-people/apis/customgpt-ai/changes/api/v1/projects/:projectId/labels/users/delete.md)

---

[API](https://skmtc.dev/poll-the-people/apis/customgpt-ai.md) - [All operations](https://skmtc.dev/poll-the-people/apis/customgpt-ai/llms.txt) - [OpenAPI document](https://skmtc.dev/poll-the-people/apis/customgpt-ai/revisions/77aab4354382?raw)