---
title: "Delete an identifier for a supplier"
method: DELETE
path: "/public/v2/suppliers/sites/identifiers"
tags: ["Suppliers - Sites"]
---

# Delete an identifier for a supplier

`DELETE /public/v2/suppliers/sites/identifiers`

## Request

- Base URL: `https://api.prewave.com`
- URL: `https://api.prewave.com/public/v2/suppliers/sites/identifiers`
- Auth: API key in header `X-Auth-Token`
- TypeScript: <https://skmtc.dev/prewave/apis/public-prewave-api/docs/public/v2/suppliers/sites/identifiers/delete.ts> (a function with typed inputs; its response is checked against the schema)

Delete an identifier (supplier ID, customer ID, or own site ID) from all suppliers in your organization.

**Related Endpoints:**
- To create an identifier, use `POST /public/v2/suppliers/sites/identifiers`.
- To find suppliers by identifier, use `GET /public/v2/suppliers/sites/find-by-identifier`.
- To get all suppliers, use `GET /public/v2/suppliers/sites`.

**How It Works:**

This endpoint deletes a specific identifier across all suppliers that have it. You specify:
- `type`: The type of identifier to delete (`supplierId`, `customerId`, or `ownId`)
- `id`: The identifier value to delete
- `source`: Optional source system of the identifier to delete

**Query Parameters:**
- `type` (required): Must be one of: `supplierId`, `customerId`, `ownId`
- `id` (required): The identifier value (e.g., "SUP-12345")
- `source` (optional): Source system (e.g., "SAP", "Coupa"). If not provided, will search for identifiers without a source or with the default source.

**Examples:**

1. **Delete a supplier ID:**
   ```
   DELETE /public/v2/suppliers/sites/identifiers?type=supplierId&id=SUP-12345&source=SAP
   ```

2. **Delete a customer ID:**
   ```
   DELETE /public/v2/suppliers/sites/identifiers?type=customerId&id=CUST-67890&source=SAP
   ```

3. **Delete an own site ID:**
   ```
   DELETE /public/v2/suppliers/sites/identifiers?type=ownId&id=OWN-SITE-01&source=SAP
   ```

**Important Notes:**
- The identifier must exist for at least one supplier
- If the identifier doesn't exist, a 404 Not Found error is returned
- All identifier changes are automatically audited
- If `source` is not provided, the system will search for identifiers without a source or with the default source

**Required Permission**: `MANAGE_PUBLIC_SUPPLIER_IDS`

## Query parameters

- `type` 'SUPPLIER_ID' | 'CUSTOMER_ID' | 'OWN_ID', required: Type of identifier
- `id` string, required
- `source` string

## Response `204`

No Content - Identifier deleted successfully.

## Other responses

- `400`: 400 Bad Request - Invalid request. This can occur if: (1) required parameters are missing, (2) invalid identifier type.
- `403`: 403 Forbidden - Authentication or authorization failure. This status code is returned when: (1) the request lacks valid authentication credentials (missing or invalid X-Auth-Token header), or (2) the authenticated user does not have the required permission to access this resource.
- `404`: 404 Not Found - The identifier doesn't exist in your organization.
- `429`: 429 Too Many Requests - API rate limit exceeded. The request has been rejected because the rate limit for this endpoint has been exceeded. Default rate limits: GET requests - 100 per 10 seconds, 500 per minute; POST/PUT/PATCH/DELETE requests - 20 per 10 seconds, 100 per minute. For increased access, please contact customer success.
- `500`: 500 Internal Server Error - An unexpected error occurred on the server. The request may or may not have been processed.

---

[API](https://skmtc.dev/prewave/apis/public-prewave-api.md) - [All operations](https://skmtc.dev/prewave/apis/public-prewave-api/llms.txt) - [OpenAPI document](https://skmtc.dev/prewave/apis/public-prewave-api/revisions/8b6e3b3827ca?raw)