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

# Delete Row

> Delete a single custom-table row, softly or permanently

Deletes one row.

On a **paranoid** table the row is soft-deleted (its `deletedAt` is set) and can be brought back with [Restore Row](/v8/api-reference/custom-tables/restore-row). Pass `?force=true` to delete it permanently instead. On a non-paranoid table every delete is permanent, and `force` makes no difference.

<Warning>
  Row endpoints capture the caller's identity but **enforce no authorization**. See [Security: open row CRUD](/v8/custom-tables#security-open-row-crud).
</Warning>

## Path Parameters

<ParamField path="tableName" type="string" required>
  Logical name of the custom table — pass `orders`, not `custom_orders`.
</ParamField>

<ParamField path="rowId" type="string" required>
  UUID of the row to delete.
</ParamField>

## Query Parameters

<ParamField query="force" type="string">
  `"true"` hard-deletes the row even on a paranoid table. Any other value, or omitting it, leaves the default soft-delete behavior in place.
</ParamField>

## Response

<ResponseField name="deleted" type="boolean">
  Always `true` when the call succeeds.
</ResponseField>

<ResponseField name="soft" type="boolean">
  Whether the row was soft-deleted (`true`) or removed permanently (`false`). Read this rather than assuming, since it reflects both the table's `paranoid` setting and `force`.
</ResponseField>

## Error Responses

<AccordionGroup>
  <Accordion title="Invalid Parameters — 400">
    ```json theme={null}
    { "error": "Bad Request", "code": "database/invalid-params" }
    ```
  </Accordion>

  <Accordion title="Table Not Found — 404">
    ```json theme={null}
    { "error": "Not Found", "code": "database/table-not-found" }
    ```
  </Accordion>

  <Accordion title="Row Not Found — 404">
    ```json theme={null}
    { "error": "Not Found", "code": "database/row-not-found" }
    ```
  </Accordion>

  <Accordion title="Server Error — 500">
    ```json theme={null}
    { "error": "Internal Server Error", "code": "database/server-error" }
    ```
  </Accordion>
</AccordionGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.