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

# Blob Delete Objects

> Diese Dokumentation bietet einen umfassenden Überblick über den DELETE /v1/objects-Endpoint der SquareCloud Blob API.

<ParamField header="Authorization" type="string" placeholder="API Key" required>
  Der API-Schlüssel für Ihr Konto. Sie finden ihn in Ihren [Kontoeinstellungen](https://squarecloud.app/de/account/security).
</ParamField>

<ParamField body="object" type="string" placeholder="Object name" required>
  Der Name des zu löschenden Objekts. Der Objektname muss folgendem Muster entsprechen: `a to z, A to Z, 0 to 9, and _`.

  ```json theme={null}
  { "object": "ID/prefix/name1_ltq7b2sw-de6241.jpeg" }
  ```
</ParamField>

### Antwort

<ResponseField name="status" type="string">
  Gibt an, ob der Aufruf erfolgreich war. "success" bei Erfolg, "error" bei Misserfolg.
</ResponseField>

<ResponseExample>
  ```json theme={null}
  {
    "status": "success"
  }
  ```
</ResponseExample>

### Fehlerbehebung

<Tabs>
  <Tab title="Statuscode 400">
    ### Objektbezogen

    <CodeGroup>
      ```json INVALID_BODY theme={null}
      // The request body is missing or is not a valid JSON object.
      {
          "status": "error",
          "code": "INVALID_BODY"
      }
      ```

      ```json INVALID_OBJECT theme={null}
      // The provided object name is invalid.
      {
          "status": "error",
          "code": "INVALID_OBJECT"
      }
      ```

      ```json FAILED_DELETE theme={null}
      // The request to delete the objects failed. Please try again.
      {
          "status": "error",
          "code": "FAILED_DELETE"
      }
      ```
    </CodeGroup>
  </Tab>

  <Tab title="Statuscode 401">
    ### Nicht autorisiert

    <CodeGroup>
      ```json ACCESS_DENIED theme={null}
      // The API key is missing or invalid. Set a valid key in the Authorization header.
      {
          "status": "error",
          "code": "ACCESS_DENIED"
      }
      ```
    </CodeGroup>
  </Tab>

  <Tab title="Statuscode 404">
    ### Nicht gefunden

    <CodeGroup>
      ```json OBJECT_NOT_FOUND theme={null}
      // The object you are trying to delete does not exist.
      {
          "status": "error",
          "code": "OBJECT_NOT_FOUND"
      }
      ```
    </CodeGroup>
  </Tab>

  <Tab title="Statuscode 429">
    ### Rate-Limit erreicht

    <CodeGroup>
      ```json RATELIMIT theme={null}
      // Delete rate limit reached (max 1 delete per second).
      {
          "status": "error",
          "code": "RATELIMIT"
      }
      ```
    </CodeGroup>
  </Tab>
</Tabs>