> ## Documentation Index
> Fetch the complete documentation index at: https://help.teable.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete Records

### Path

DELETE /api/table/\{tableId}/record

### Request

**Path Parameters**

* tableId (string): The unique identifier of the table [(how to get)](/en/api-doc/get-id#tableid).

**Query Parameters**

* **recordIds (required)** [(how to get)](/en/api-doc/get-id#recordid)
  * Description: Array of record IDs to delete
  * Type: Array
  * Example: `["rec123456", "rec789012"]`
  * Note: Each element is a string representing the ID of a record to be deleted.

#### Response

**Success Response**

* Status code: 200 OK
* Response body: No content

#### Error Responses

* Status code: 400 Bad Request: Request parameter format error or missing required parameters.
* Status code: 404 Not Found: Specified tableId does not exist or some record IDs do not exist.

#### Example Code

<CodeGroup>
  ```bash CURL theme={null}
  curl -X DELETE 'https://app.teable.ai/api/table/__tableId__/record?recordIds[]=rec123456&recordIds[]=rec789012' \
    -H 'Authorization: Bearer __token__'
  ```

  ```js JS SDK theme={null}
  import { configApi, deleteRecords } from '@teable/openapi';

  configApi({
    endpoint: 'https://app.teable.ai',
    token: '__token__',
  });

  await deleteRecords('__tableId__', ['rec123456', 'rec789012']);
  ```

  ```ts TypeScript theme={null}
  const response = await fetch('https://app.teable.ai/api/table/__tableId__/record?recordIds[]=rec123456&recordIds[]=rec789012', {
    method: 'DELETE',
    headers: {
      'Authorization': 'Bearer __token__'
    }
  });

  console.log(response.status); // 200 if successful
  ```

  ```python Python theme={null}
  import requests

  response = requests.delete(
      'https://app.teable.ai/api/table/__tableId__/record',
      headers={
          'Authorization': 'Bearer __token__'
      },
      params={
          'recordIds': ['rec123456', 'rec789012']
      }
  )

  print(response.status_code) # 200 if successful
  ```
</CodeGroup>
