> ## 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.

# Obter Configurações Blob

> Leia as regras por prefixo da sua conta do Blob Storage com GET /v1/account/settings.

<ParamField header="Authorization" type="string" placeholder="Chave da API" required>
  A chave da API para sua conta. Você pode encontrá-la nas [configurações da conta](https://squarecloud.app/pt-br/account/security).
</ParamField>

O Obter Configurações retorna as regras salvas com o [Atualizar Configurações](/pt-br/blob-reference/endpoint/settings-put). Cada regra se aplica aos arquivos sob o seu prefixo: visibilidade, expiração e cache padrão, limites de tamanho e de tipo, e exclusão automática. Exige o escopo `blob:read`.

### Resposta

<ResponseField name="status" type="string">
  "success" se bem-sucedida, "error" caso contrário.
</ResponseField>

<ResponseField name="response" type="object">
  <Expandable title="Alternar objeto">
    <ResponseField name="rules" type="array">
      As regras, como foram salvas. Veja o [Atualizar Configurações](/pt-br/blob-reference/endpoint/settings-put) para cada campo.

      <Expandable title="Alternar objeto">
        <ResponseField name="prefix" type="string">
          O prefixo ao qual a regra se aplica, terminando em `/`.
        </ResponseField>

        <ResponseField name="private" type="boolean">
          Visibilidade padrão.
        </ResponseField>

        <ResponseField name="expire" type="string">
          Expiração padrão.
        </ResponseField>

        <ResponseField name="max_size" type="number">
          Tamanho máximo do arquivo, em bytes.
        </ResponseField>

        <ResponseField name="extensions" type="string[]">
          Extensões aceitas.
        </ResponseField>

        <ResponseField name="cache_control" type="string">
          Cache padrão.
        </ResponseField>

        <ResponseField name="delete_after_days" type="number">
          Dias depois dos quais os arquivos são excluídos.
        </ResponseField>

        <ResponseField name="created_at" type="ISO 8601">
          Quando a regra foi salva.
        </ResponseField>

        <ResponseField name="active_from" type="ISO 8601">
          Quando a exclusão automática começa a agir (24 horas depois de `created_at`). Presente apenas com `delete_after_days`.
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl --request GET \
    --url 'https://blob.squarecloud.app/v1/account/settings' \
    --header 'Authorization: YOUR_API_KEY'
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  {
    "status": "success",
    "response": {
      "rules": [
        {
          "prefix": "invoices/",
          "private": true,
          "extensions": ["pdf"],
          "created_at": "2026-09-25T12:00:00.000Z"
        },
        {
          "prefix": "tmp/",
          "delete_after_days": 7,
          "created_at": "2026-09-25T12:00:00.000Z",
          "active_from": "2026-09-26T12:00:00.000Z"
        }
      ]
    }
  }
  ```
</ResponseExample>