# Delete a file type
Source: https://docs.file.ai/api-reference/endpoint/delete-a-file-type

Delete file types

cURL

```
curl --request DELETE \
  --url https://api.orion.file.ai/prod/v1/file-type \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "blueprintIds": [
    "649e2d2d2d2d2d2d2d2d2d2d",
    "649e2d2d2d2d2d2d2d2d2d2e"
  ]
}
'
```

```
import requests

url = "https://api.orion.file.ai/prod/v1/file-type"

payload = { "blueprintIds": ["649e2d2d2d2d2d2d2d2d2d2d", "649e2d2d2d2d2d2d2d2d2d2e"] }
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.delete(url, json=payload, headers=headers)

print(response.text)
```

```
const options = {
  method: 'DELETE',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({blueprintIds: ['649e2d2d2d2d2d2d2d2d2d2d', '649e2d2d2d2d2d2d2d2d2d2e']})
};

fetch('https://api.orion.file.ai/prod/v1/file-type', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
```

```
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.orion.file.ai/prod/v1/file-type",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "DELETE",
  CURLOPT_POSTFIELDS => json_encode([
    'blueprintIds' => [
        '649e2d2d2d2d2d2d2d2d2d2d',
        '649e2d2d2d2d2d2d2d2d2d2e'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
```

```
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.orion.file.ai/prod/v1/file-type"

	payload := strings.NewReader("{\n  \"blueprintIds\": [\n    \"649e2d2d2d2d2d2d2d2d2d2d\",\n    \"649e2d2d2d2d2d2d2d2d2d2e\"\n  ]\n}")

	req, _ := http.NewRequest("DELETE", url, payload)

	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
```

```
HttpResponse<String> response = Unirest.delete("https://api.orion.file.ai/prod/v1/file-type")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"blueprintIds\": [\n    \"649e2d2d2d2d2d2d2d2d2d2d\",\n    \"649e2d2d2d2d2d2d2d2d2d2e\"\n  ]\n}")
  .asString();
```

```
require 'uri'
require 'net/http'

url = URI("https://api.orion.file.ai/prod/v1/file-type")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Delete.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"blueprintIds\": [\n    \"649e2d2d2d2d2d2d2d2d2d2d\",\n    \"649e2d2d2d2d2d2d2d2d2d2e\"\n  ]\n}"

response = http.request(request)
puts response.read_body
```

200

400

401

403

404

422

429

500

```
{
  "success": true,
  "deletedCount": 1,
  "failedCount": 2,
  "errors": [
    {
      "blueprintId": "649e2d2d2d2d2d2d2d2d2d2e",
      "message": "Schema is not found or already deleted"
    },
    {
      "blueprintId": "bad-id",
      "message": "Invalid schema ID format"
    }
  ]
}
```

```
{
  "type": "https://errors.file.ai/bad-request",
  "title": "Bad request",
  "status": 400,
  "detail": "Invalid input",
  "instance": "/v1/{route}",
  "code": "BAD_REQUEST",
  "requestId": "0f1c8e03-978e-40d5-bc93-6894a57f9324",
  "errors": [],
  "message": "Invalid input",
  "error": "Bad Request",
  "statusCode": 400
}
```

```
{
  "type": "https://errors.file.ai/validation-failed",
  "title": "Validation failed",
  "status": 422,
  "detail": "One or more fields are invalid.",
  "instance": "/v1/files/upload",
  "code": "VALIDATION_FAILED",
  "requestId": "0f1c8e03-978e-40d5-bc93-6894a57f9324",
  "errors": [
    {
      "code": "REQUIRED",
      "detail": "must not be empty",
      "pointer": "#/fileName",
      "parameter": "limit"
    }
  ],
  "message": "Validation failed",
  "error": "Unprocessable Entity",
  "statusCode": 422,
  "retryAfter": 42
}
```

```
{
  "type": "https://errors.file.ai/validation-failed",
  "title": "Validation failed",
  "status": 422,
  "detail": "One or more fields are invalid.",
  "instance": "/v1/files/upload",
  "code": "VALIDATION_FAILED",
  "requestId": "0f1c8e03-978e-40d5-bc93-6894a57f9324",
  "errors": [
    {
      "code": "REQUIRED",
      "detail": "must not be empty",
      "pointer": "#/fileName",
      "parameter": "limit"
    }
  ],
  "message": "Validation failed",
  "error": "Unprocessable Entity",
  "statusCode": 422,
  "retryAfter": 42
}
```

```
{
  "type": "https://errors.file.ai/validation-failed",
  "title": "Validation failed",
  "status": 422,
  "detail": "One or more fields are invalid.",
  "instance": "/v1/files/upload",
  "code": "VALIDATION_FAILED",
  "requestId": "0f1c8e03-978e-40d5-bc93-6894a57f9324",
  "errors": [
    {
      "code": "REQUIRED",
      "detail": "must not be empty",
      "pointer": "#/fileName",
      "parameter": "limit"
    }
  ],
  "message": "Validation failed",
  "error": "Unprocessable Entity",
  "statusCode": 422,
  "retryAfter": 42
}
```

```
{
  "type": "https://errors.file.ai/validation-failed",
  "title": "Validation failed",
  "status": 422,
  "detail": "One or more fields are invalid.",
  "instance": "/v1/files/upload",
  "code": "VALIDATION_FAILED",
  "requestId": "0f1c8e03-978e-40d5-bc93-6894a57f9324",
  "errors": [
    {
      "code": "REQUIRED",
      "detail": "must not be empty",
      "pointer": "#/fileName",
      "parameter": "limit"
    }
  ],
  "message": "Validation failed",
  "error": "Unprocessable Entity",
  "statusCode": 422,
  "retryAfter": 42
}
```

```
{
  "type": "https://errors.file.ai/validation-failed",
  "title": "Validation failed",
  "status": 422,
  "detail": "One or more fields are invalid.",
  "instance": "/v1/files/upload",
  "code": "VALIDATION_FAILED",
  "requestId": "0f1c8e03-978e-40d5-bc93-6894a57f9324",
  "errors": [
    {
      "code": "REQUIRED",
      "detail": "must not be empty",
      "pointer": "#/fileName",
      "parameter": "limit"
    }
  ],
  "message": "Validation failed",
  "error": "Unprocessable Entity",
  "statusCode": 422,
  "retryAfter": 42
}
```

```
{
  "type": "https://errors.file.ai/validation-failed",
  "title": "Validation failed",
  "status": 422,
  "detail": "One or more fields are invalid.",
  "instance": "/v1/files/upload",
  "code": "VALIDATION_FAILED",
  "requestId": "0f1c8e03-978e-40d5-bc93-6894a57f9324",
  "errors": [
    {
      "code": "REQUIRED",
      "detail": "must not be empty",
      "pointer": "#/fileName",
      "parameter": "limit"
    }
  ],
  "message": "Validation failed",
  "error": "Unprocessable Entity",
  "statusCode": 422,
  "retryAfter": 42
}
```

Endpoints

# Delete file types

Copy pageCopy page

This endpoint is used to bulk delete file types.

Each id is processed independently. The endpoint returns HTTP 200 whenever the request is authorized and the body is valid, even when some or all ids fail — per-id failures are reported in `errors[]`, and `success` is `false` only when nothing was deleted and at least one id failed.

Deleting an id that was already deleted yields a per-item “Schema is not found or already deleted” error rather than a request-level failure, so retries are safe.

Malformed ids are reported as per-item `Invalid schema ID format` errors, not as a validation failure for the whole request. Duplicate ids are processed once.

An id that fails for an unexpected reason reports the generic message `Schema could not be deleted`; the underlying cause is recorded server-side.

At most 50 ids may be sent per request; a larger batch is rejected with 422 `VALIDATION_FAILED` before any deletion runs. Deletion is performed inline and one id at a time, so split larger sets across requests.

The `Idempotency-Key` header is optional. When supplied, a repeated request with the same key replays the original response for 24 hours.

Copy pageCopy page

DELETE

https://api.orion.file.aihttps://api.orion.{instance}.file.ai

/

prod

/

v1

/

file-type

Try it

Delete file types

cURL

```
curl --request DELETE \
  --url https://api.orion.file.ai/prod/v1/file-type \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "blueprintIds": [
    "649e2d2d2d2d2d2d2d2d2d2d",
    "649e2d2d2d2d2d2d2d2d2d2e"
  ]
}
'
```

```
import requests

url = "https://api.orion.file.ai/prod/v1/file-type"

payload = { "blueprintIds": ["649e2d2d2d2d2d2d2d2d2d2d", "649e2d2d2d2d2d2d2d2d2d2e"] }
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.delete(url, json=payload, headers=headers)

print(response.text)
```

```
const options = {
  method: 'DELETE',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({blueprintIds: ['649e2d2d2d2d2d2d2d2d2d2d', '649e2d2d2d2d2d2d2d2d2d2e']})
};

fetch('https://api.orion.file.ai/prod/v1/file-type', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
```

```
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.orion.file.ai/prod/v1/file-type",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "DELETE",
  CURLOPT_POSTFIELDS => json_encode([
    'blueprintIds' => [
        '649e2d2d2d2d2d2d2d2d2d2d',
        '649e2d2d2d2d2d2d2d2d2d2e'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
```

```
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.orion.file.ai/prod/v1/file-type"

	payload := strings.NewReader("{\n  \"blueprintIds\": [\n    \"649e2d2d2d2d2d2d2d2d2d2d\",\n    \"649e2d2d2d2d2d2d2d2d2d2e\"\n  ]\n}")

	req, _ := http.NewRequest("DELETE", url, payload)

	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
```

```
HttpResponse<String> response = Unirest.delete("https://api.orion.file.ai/prod/v1/file-type")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"blueprintIds\": [\n    \"649e2d2d2d2d2d2d2d2d2d2d\",\n    \"649e2d2d2d2d2d2d2d2d2d2e\"\n  ]\n}")
  .asString();
```

```
require 'uri'
require 'net/http'

url = URI("https://api.orion.file.ai/prod/v1/file-type")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Delete.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"blueprintIds\": [\n    \"649e2d2d2d2d2d2d2d2d2d2d\",\n    \"649e2d2d2d2d2d2d2d2d2d2e\"\n  ]\n}"

response = http.request(request)
puts response.read_body
```

200

400

401

403

404

422

429

500

```
{
  "success": true,
  "deletedCount": 1,
  "failedCount": 2,
  "errors": [
    {
      "blueprintId": "649e2d2d2d2d2d2d2d2d2d2e",
      "message": "Schema is not found or already deleted"
    },
    {
      "blueprintId": "bad-id",
      "message": "Invalid schema ID format"
    }
  ]
}
```

```
{
  "type": "https://errors.file.ai/bad-request",
  "title": "Bad request",
  "status": 400,
  "detail": "Invalid input",
  "instance": "/v1/{route}",
  "code": "BAD_REQUEST",
  "requestId": "0f1c8e03-978e-40d5-bc93-6894a57f9324",
  "errors": [],
  "message": "Invalid input",
  "error": "Bad Request",
  "statusCode": 400
}
```

```
{
  "type": "https://errors.file.ai/validation-failed",
  "title": "Validation failed",
  "status": 422,
  "detail": "One or more fields are invalid.",
  "instance": "/v1/files/upload",
  "code": "VALIDATION_FAILED",
  "requestId": "0f1c8e03-978e-40d5-bc93-6894a57f9324",
  "errors": [
    {
      "code": "REQUIRED",
      "detail": "must not be empty",
      "pointer": "#/fileName",
      "parameter": "limit"
    }
  ],
  "message": "Validation failed",
  "error": "Unprocessable Entity",
  "statusCode": 422,
  "retryAfter": 42
}
```

```
{
  "type": "https://errors.file.ai/validation-failed",
  "title": "Validation failed",
  "status": 422,
  "detail": "One or more fields are invalid.",
  "instance": "/v1/files/upload",
  "code": "VALIDATION_FAILED",
  "requestId": "0f1c8e03-978e-40d5-bc93-6894a57f9324",
  "errors": [
    {
      "code": "REQUIRED",
      "detail": "must not be empty",
      "pointer": "#/fileName",
      "parameter": "limit"
    }
  ],
  "message": "Validation failed",
  "error": "Unprocessable Entity",
  "statusCode": 422,
  "retryAfter": 42
}
```

```
{
  "type": "https://errors.file.ai/validation-failed",
  "title": "Validation failed",
  "status": 422,
  "detail": "One or more fields are invalid.",
  "instance": "/v1/files/upload",
  "code": "VALIDATION_FAILED",
  "requestId": "0f1c8e03-978e-40d5-bc93-6894a57f9324",
  "errors": [
    {
      "code": "REQUIRED",
      "detail": "must not be empty",
      "pointer": "#/fileName",
      "parameter": "limit"
    }
  ],
  "message": "Validation failed",
  "error": "Unprocessable Entity",
  "statusCode": 422,
  "retryAfter": 42
}
```

```
{
  "type": "https://errors.file.ai/validation-failed",
  "title": "Validation failed",
  "status": 422,
  "detail": "One or more fields are invalid.",
  "instance": "/v1/files/upload",
  "code": "VALIDATION_FAILED",
  "requestId": "0f1c8e03-978e-40d5-bc93-6894a57f9324",
  "errors": [
    {
      "code": "REQUIRED",
      "detail": "must not be empty",
      "pointer": "#/fileName",
      "parameter": "limit"
    }
  ],
  "message": "Validation failed",
  "error": "Unprocessable Entity",
  "statusCode": 422,
  "retryAfter": 42
}
```

```
{
  "type": "https://errors.file.ai/validation-failed",
  "title": "Validation failed",
  "status": 422,
  "detail": "One or more fields are invalid.",
  "instance": "/v1/files/upload",
  "code": "VALIDATION_FAILED",
  "requestId": "0f1c8e03-978e-40d5-bc93-6894a57f9324",
  "errors": [
    {
      "code": "REQUIRED",
      "detail": "must not be empty",
      "pointer": "#/fileName",
      "parameter": "limit"
    }
  ],
  "message": "Validation failed",
  "error": "Unprocessable Entity",
  "statusCode": 422,
  "retryAfter": 42
}
```

```
{
  "type": "https://errors.file.ai/validation-failed",
  "title": "Validation failed",
  "status": 422,
  "detail": "One or more fields are invalid.",
  "instance": "/v1/files/upload",
  "code": "VALIDATION_FAILED",
  "requestId": "0f1c8e03-978e-40d5-bc93-6894a57f9324",
  "errors": [
    {
      "code": "REQUIRED",
      "detail": "must not be empty",
      "pointer": "#/fileName",
      "parameter": "limit"
    }
  ],
  "message": "Validation failed",
  "error": "Unprocessable Entity",
  "statusCode": 422,
  "retryAfter": 42
}
```

The **blueprintIds** field is used to specify the blueprint schemas (file types) that should be deleted. You can pass one or more IDs (up to 50) in a single request.

Warning: This action is irreversible.

## 

[​

](#overview)

Overview

Permanently deletes one or more blueprint schemas. This is a bulk operation: each `blueprintId` is deleted independently, one at a time, so it is possible for some IDs to succeed while others fail in the same request.

A partial failure does **not** fail the whole request. As long as at least one `blueprintId` is deleted, the endpoint returns `200 OK` with `success: true`. Always check `failedCount` and `errors` rather than relying on `success` alone to detect partial failures — see [Response](#response) below.

## 

[​

](#request)

Request

### 

[​

](#request-body)

Request Body

The request body must contain a JSON object with the following structure:

Property

Type

Required

Description

blueprintIds

string\[\]

Yes

One or more blueprint schema IDs to delete. Minimum 1, maximum 50 per request. Repeated IDs are collapsed and processed once. A malformed ID is reported in `errors` rather than failing the whole request.

### 

[​

](#request-examples)

Request Examples

#### 

[​

](#single-blueprint-schema)

Single blueprint schema

```
{
  "blueprintIds": ["649e2d2d2d2d2d2d2d2d2d2d"]
}
```

#### 

[​

](#multiple-blueprint-schemas)

Multiple blueprint schemas

```
{
  "blueprintIds": ["649e2d2d2d2d2d2d2d2d2d2d", "649e2d2d2d2d2d2d2d2d2d2e"]
}
```

Larger batches must be split across multiple requests — sending more than 50 `blueprintIds` is rejected with `422 VALIDATION_FAILED` before any deletion runs.

## 

[​

](#response)

Response

A `200 OK` is returned whenever the request is authorized and the body is valid, even when some or all IDs fail — inspect the payload for per-ID outcomes.

Field

Type

Description

success

boolean

`false` only when nothing was deleted and at least one ID failed. A partial failure (some succeeded, some failed) still returns `true` — this is the intended contract, so check `failedCount`/`errors` to detect partial failures.

deletedCount

number

Number of `blueprintId`s successfully deleted.

failedCount

number

Number of `blueprintId`s that failed to delete.

errors

array

Present when `failedCount > 0`. One entry per failed `blueprintId`.

errors\[\].blueprintId

string

The `blueprintId` that failed to delete.

errors\[\].message

string

Human-readable reason the deletion failed. One of a small, fixed set — see [Per-item error messages](#per-item-error-messages) below.

### 

[​

](#all-succeeded)

All succeeded

```
{
  "success": true,
  "deletedCount": 2,
  "failedCount": 0
}
```

### 

[​

](#partial-failure)

Partial failure

Mixed valid/invalid IDs in the same request are handled independently — the valid ones are deleted and the rest are reported in `errors`, without failing the whole request:

```
{
  "success": true,
  "deletedCount": 1,
  "failedCount": 2,
  "errors": [
    { "blueprintId": "649e2d2d2d2d2d2d2d2d2d2e", "message": "Schema is not found or already deleted" },
    { "blueprintId": "bad-id", "message": "Invalid schema ID format" }
  ]
}
```

### 

[​

](#every-id-failed)

Every ID failed

If none of the requested IDs could be deleted — for example, re-deleting IDs that were already deleted by a prior request — `success` is `false`:

```
{
  "success": false,
  "deletedCount": 0,
  "failedCount": 2,
  "errors": [
    { "blueprintId": "649e2d2d2d2d2d2d2d2d2d2d", "message": "Schema is not found or already deleted" },
    { "blueprintId": "649e2d2d2d2d2d2d2d2d2d2e", "message": "Schema is not found or already deleted" }
  ]
}
```

### 

[​

](#per-item-error-messages)

Per-item error messages

`errors[].message` is always one of the following:

Message

Meaning

`Schema is not found or already deleted`

The ID doesn’t resolve to a blueprint in this workspace — including a repeat delete of an ID a previous request already removed. Safe to retry/ignore.

`Invalid schema ID format`

The ID isn’t a validly formatted schema ID.

`Schema is locked and cannot be deleted`

The blueprint is locked and must be unlocked before it can be deleted.

`Unauthorized access`

The caller’s org/workspace doesn’t have access to this blueprint.

`Schema could not be deleted`

A generic fallback for any other, unexpected failure. The underlying cause is recorded server-side.

## 

[​

](#error-responses)

Error Responses

All error responses use the standard [RFC 9457 problem envelope](/docs-api/api-errors) (`application/problem+json`).

#### 

[​

](#401-unauthorized)

401 Unauthorized

Returned when the `x-api-key` header is missing or invalid.

#### 

[​

](#403-forbidden)

403 Forbidden

Returned when the API key is inactive, or when the key is a **read-only** key (`READONLY_KEY`) — delete is a write operation and is rejected for read-only keys regardless of whether any of the IDs exist.

#### 

[​

](#422-unprocessable-entity)

422 Unprocessable Entity

Returned for request-level validation failures — distinct from an individual ID that doesn’t resolve to a blueprint, which is reported per-item in `errors` (see above), not as a 422:

*   `blueprintIds` is missing or empty.
*   `blueprintIds` contains more than 50 IDs.
*   `blueprintIds` is not an array of strings.

See [Error responses](/docs-api/api-errors) for the full field reference and other common statuses (400, 404, 429, 500).

## 

[​

](#important-notes)

Important Notes

*   **Irreversible action**: deleted blueprint schemas cannot be recovered.
*   **Independent, sequential processing**: each `blueprintId` in the array is attempted separately, one at a time. One failing ID never blocks the others from being deleted.
*   **Malformed IDs**: an entry that isn’t a valid ID format is reported as a failed item in `errors` (not a request-level 422), alongside any other per-ID failure.
*   **Duplicate IDs**: duplicate `blueprintId`s in the same request are de-duplicated before processing.
*   **Re-delete (not found)**: deleting a `blueprintId` that doesn’t exist — including one already deleted by a prior request — fails that item with `"Schema is not found or already deleted"` in `errors` rather than raising a request-level 404. This makes retries safe.
*   **Batch size**: at most 50 `blueprintIds` per request.
*   **Permission checks**: a read-only API key cannot delete anything and receives a 403 for the whole request, regardless of whether the IDs are valid.

## 

[​

](#use-cases)

Use Cases

*   Cleaning up unused or duplicate blueprint schemas.
*   Bulk removal of blueprint schemas as part of a workspace reset or migration.
*   Automated cleanup of temporary or test file types.

## 

[​

](#best-practices)

Best Practices

*   Check `failedCount` and inspect `errors` on every response, even when `success` is `true`, to detect partial failures.
*   Treat re-deleting an already-deleted `blueprintId` as a safe no-op (`"Schema is not found or already deleted"`) rather than an unexpected error.
*   Split batches larger than 50 IDs across multiple requests.
*   Avoid using a read-only API key for this endpoint — it will always return 403.

This endpoint accepts an optional `Idempotency-Key` request header so a retry cannot apply the change twice. See [Idempotent requests](/docs-api/api-idempotency).

#### Authorizations

[​

](#authorization-x-api-key)

x-api-key

string

header

required

API key for authentication

#### Headers

[​

](#parameter-idempotency-key)

Idempotency-Key

string

Optional opaque key (max 255 chars, UUIDv4 recommended) making this request idempotent for 24h: a retry with the same key and body replays the original response with Idempotent-Replayed: true.

#### Body

application/json

[​

](#body-blueprint-ids)

blueprintIds

string\[\]

required

File type ids to delete, at most 50 per request. Repeated ids are collapsed and processed once. A malformed id is reported in `errors` rather than failing the request.

Required array length: `1 - 50` elements

Example:

`[     "649e2d2d2d2d2d2d2d2d2d2d",     "649e2d2d2d2d2d2d2d2d2d2e"   ]`

#### Response

200

application/json

The delete request was processed; inspect the payload for per-id outcomes

[​

](#response-success)

success

boolean

[​

](#response-deleted-count)

deletedCount

number

[​

](#response-failed-count)

failedCount

number

[​

](#response-errors)

errors

object\[\]

Show child attributes

[

Rename a file type

](/api-reference/endpoint/rename-a-file-type)[

Get all schemas

](/api-reference/endpoint/get-all-schemas)

[linkedin](https://www.linkedin.com/company/file-ai)[x](https://x.com/fileAI_)[youtube](https://www.youtube.com/@file_AI)

[Powered byThis documentation is built and hosted on Mintlify, a developer documentation platform](https://www.mintlify.com?utm_campaign=poweredBy&utm_medium=referral&utm_source=undefined)