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

# Mover ou renomear um arquivo da aplicação

> Mova ou renomeie um arquivo dentro de uma aplicação com PATCH /v2/apps/{app_id}/files, de path para to, sem enviá-lo de novo nem reiniciar a aplicação.

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

Requer uma chave de API com o [escopo](/pt-br/api-reference/authentication#escopos) `files:write`.

Mover arquivo renomeia ou realoca um único arquivo dentro do armazenamento de uma aplicação, de `path` para `to`, sem baixar e reenviar seu conteúdo. Use-o para reorganizar uma estrutura de diretórios ou renomear um arquivo de configuração no lugar.

`path` e `to` precisam passar na validação de caminho e precisam ser diferentes; enviar o mesmo valor para ambos é rejeitado com `INVALID_PATH`. Isso apenas move o arquivo no armazenamento da aplicação em execução; não reinicia o processo, então um processo em execução que lê o caminho antigo não verá a alteração até recarregar ou até a aplicação ser [reiniciada](/pt-br/api-reference/endpoint/apps/restart). Para excluir um arquivo em vez de movê-lo, veja [Excluir arquivo](/pt-br/api-reference/endpoint/apps/filemanager/delete).

Em aplicações compartilhadas em workspace, quem chama precisa da [função](/pt-br/api-reference/endpoint/workspace/members/invite#funções) `maintain` ou `admin`. A verificação de arquivos restritos se aplica tanto ao nome de origem quanto ao de destino, então um membro sem essa permissão não pode renomear um arquivo permitido para um nome protegido como `.env` a fim de plantá-lo ou sobrescrevê-lo.

## Parâmetros

<ParamField path="app_id" type="string" placeholder="ID da Aplicação" required>
  O ID da aplicação. Você pode encontrá-lo na URL da sua aplicação no dashboard.
</ParamField>

<ParamField body="path" type="string" placeholder="Caminho do arquivo" required>
  O caminho do arquivo a ser movido, com até 256 caracteres.
</ParamField>

<ParamField body="to" type="string" placeholder="Caminho destino" required>
  O caminho para o qual mover o arquivo, com até 256 caracteres.
</ParamField>

## Resposta

<ResponseField name="status" type="string">
  Indica se a chamada foi bem-sucedida: `success` se foi, `error` se não.
</ResponseField>

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

## Erros comuns

| Código | HTTP | Significado |
| - | - | - |
| `INVALID_PATH` | 400 | `path` ou `to` falharam na validação, ou `path` e `to` eram idênticos. |
| `RENAME_FAILED` | 400 | O cluster não conseguiu renomear o arquivo. |
| `PERMISSION_DENIED` | 403 | Quem chama não tem a permissão de workspace para renomear um arquivo restrito, verificada tanto no nome de origem quanto no de destino. |

## Relacionados

* CLI: [`squarecloud app file move`](/pt-br/cli-reference/files#squarecloud-app-file-move)
* SDKs: [`api.apps.files.move()`](/pt-br/sdks/js/managing_files) (JavaScript), [`client.apps.files.move()`](/pt-br/sdks/py/managing_files) (Python), [`c.Apps.Files.Move()`](/pt-br/sdks/go/managing_files) (Go)


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