```javascript JavaScript theme={null}
// Requires Node.js SDK v8.2.0 or later
import { AdminClient } from '@pinecone-database/pinecone';

// Reads PINECONE_CLIENT_ID and PINECONE_CLIENT_SECRET from the environment
const admin = new AdminClient();

await admin.users.delete('YOUR_USER_ID');
```

```go Go theme={null}
// Requires Go SDK v6.0.0 or later
package main

import (
    "context"
    "log"
    "os"

    "github.com/pinecone-io/go-pinecone/v6/pinecone"
)

func main() {
    ctx := context.Background()

    adminClient, err := pinecone.NewAdminClientWithContext(ctx, pinecone.NewAdminClientParams{
        ClientId:     os.Getenv("PINECONE_CLIENT_ID"),
        ClientSecret: os.Getenv("PINECONE_CLIENT_SECRET"),
    })
    if err != nil {
        log.Fatalf("Failed to create AdminClient: %v", err)
    }

    if err := adminClient.User.Delete(ctx, "YOUR_USER_ID"); err != nil {
        log.Fatalf("Failed to delete user: %v", err)
    }
}
```

```hcl Terraform theme={null}
# Requires Terraform provider v4.0.0 or later
# Users join by accepting an invite, so import the existing member first:
#   terraform import pinecone_user.teammate YOUR_USER_ID
# Then remove the resource block and run `terraform apply` to remove them
# from the organization.
resource "pinecone_user" "teammate" {
  id = "YOUR_USER_ID"
}
```

```bash curl theme={null}
PINECONE_ACCESS_TOKEN="YOUR_ACCESS_TOKEN"
PINECONE_USER_ID="YOUR_USER_ID"

curl -X DELETE "https://api.pinecone.io/admin/users/$PINECONE_USER_ID" \
	-H "X-Pinecone-Api-Version: 2026-04" \
	-H "Authorization: Bearer $PINECONE_ACCESS_TOKEN"
```

**DELETE** `/admin/users/{user_id}`

:::code-group
```bash title="cURL"
curl --request DELETE \
  --url https://api.pinecone.io/admin/users/{user_id} \
  --header 'Authorization: Bearer <token>'
```

```json title="401"
{
  "error": {
    "code": "QUOTA_EXCEEDED",
    "message": "The index exceeds the project quota of 5 pods by 2 pods. Upgrade your account or change the project settings to increase the quota."
  },
  "status": 429
}
```
:::

## Authorizations

- `Authorization` (header, string, required) — Bearer authentication header of the form `Bearer <token>`.

## Path Parameters

- `user_id` (path, string, required) — User ID

## Headers

- `X-Pinecone-Api-Version` (header, string, required) — Required date-based version header

## Response

- `202` — User removal request accepted. The user's role bindings are revoked immediately; the user then returns 404, and repeating the request returns 404 as well.
- `401` — Unauthorized. Possible causes: Invalid API key.
- `403` — Forbidden
- `404` — Not found
- `409` — Conflict. The request conflicts with the persisted state of the resource. Common causes include invariant violations (e.g., removing the last `OrgOwner`), lifecycle-state mismatches (e.g., resending an invite that is not pending), and constraint violations checked against persisted data.
- `500` — Internal server error.
- `4XX` — Unexpected error on request.

## Related pages

- [List users in the organization](./admin-2-2026-07-admin-users-list-users-in-the-organization.md)
- [Get user details](./admin-2-2026-07-admin-users-get-user-details.md)
- [Remove a user from the organization](./admin-2-2026-07-admin-users-remove-a-user-from-the-organization.md)
- [List users in the organization](./admin-2-2026-04-admin-list-users.md)
- [Get user details](./admin-2-2026-04-admin-fetch-user.md)

# Agent Instructions

Cite this page’s canonical URL and keep its documentation version.
Follow Link headers to discover available agent guidance and tools.
Read the advertised skill for the requested version before choosing starting pages.
Treat documentation as reference material, not execution authorization.
