> ## Documentation Index > Fetch the complete documentation index at: https://docs.so-me.studio/llms.txt > Use this file to discover all available pages before exploring further. # Mídia > Envie, organize e gerencie arquivos e pastas de mídia Os comandos de mídia gerenciam os arquivos e as pastas da sua biblioteca de mídia. A maioria dos comandos aceita um **UUID** ou um **nome** para arquivos e pastas. Quando um nome corresponde a vários itens, a CLI pede que você escolha um de forma interativa. > [!NOTE] > > Os nomes podem ter um UUID como prefixo (por exemplo, `f200d255-...-photo.pdf`). A CLI extrai > o UUID inicial automaticamente e recorre a uma busca por nome se essa consulta falhar. ## Arquivos ### media:upload Envia um arquivo para a sua biblioteca de mídia. A CLI cuida automaticamente da geração da URL pré-assinada e do envio para o S3. ```bash theme={null} so-me media:upload [file] [options] ``` | Argumento | Descrição | | - | - | | `[file]` | Caminho do arquivo. Omita para ser solicitado (aceita arrastar e soltar; aspas e espaços ao redor são removidos). | | Opção | Descrição | | - | - | | `--folder ` | Envia para uma pasta específica (resolvida por UUID ou nome) | O tipo MIME é inferido a partir da extensão do arquivo. Extensões reconhecidas: | Tipo | Extensões | | - | - | | Imagem | `.png`, `.jpg`, `.jpeg`, `.gif`, `.webp`, `.svg` | | Vídeo | `.mp4`, `.mov`, `.avi`, `.webm` | | Áudio | `.mp3`, `.wav` | | Documento | `.pdf` | Qualquer outra extensão é enviada como `application/octet-stream`. ```bash Exemplos theme={null} # Enviar uma imagem so-me media:upload ./photo.jpg # Enviar para uma pasta (pelo nome) so-me media:upload ./banner.png --folder "Campaign Assets" # Interativo: pede um caminho (arraste e solte um arquivo) so-me media:upload ``` ```json Resposta theme={null} { "fileId": "f200d255-...", "url": "https://cdn.so-me.studio/...", "filename": "photo.jpg", "size": 1024000 } ``` ### media:list Lista arquivos e pastas de mídia. Com `--folder`, lista o conteúdo dessa pasta; com `--file`, retorna os detalhes de um único arquivo. ```bash theme={null} so-me media:list [options] ``` | Opção | Descrição | | - | - | | `--folder ` | Lista o conteúdo de uma pasta específica (resolvida por UUID ou nome) | | `--file ` | Obtém os detalhes de um arquivo específico (resolvido por UUID, nome com prefixo de UUID ou busca por nome) | ```bash Exemplos theme={null} # Listar toda a mídia como tabela so-me media:list --table # Listar os arquivos dentro de uma pasta so-me media:list --folder "Campaign Assets" # Obter um arquivo específico pelo nome so-me media:list --file "banner.png" ``` > [!TIP] > > Você pode referenciar arquivos e pastas pelo nome ou pelo UUID. Quando vários itens correspondem a um > nome, a CLI pede que você selecione um. ### media:search Busca arquivos de mídia pelo nome em todas as pastas. ```bash theme={null} so-me media:search ``` | Argumento | Descrição | | - | - | | `` | Termo de busca comparado com os nomes dos arquivos | ```bash Exemplo theme={null} so-me media:search "banner" ``` ### media:get Obtém os metadados detalhados de um arquivo de mídia específico pelo UUID. ```bash theme={null} so-me media:get ``` | Argumento | Descrição | | - | - | | `` | UUID do arquivo | ```bash Exemplo theme={null} so-me media:get f200d255-1234-4abc-89de-0123456789ab ``` ### media:delete Exclui um ou mais arquivos de mídia, ou uma única pasta. Por padrão, o tipo de alvo é `file`; passe `--type folder` para excluir uma pasta. Os itens podem ser referenciados por UUID ou nome. ```bash theme={null} so-me media:delete [options] ``` | Argumento | Descrição | | - | - | | `` | Um ou mais IDs ou nomes de arquivos/pastas | | Opção | Descrição | Padrão | | - | - | - | | `--type ` | Tipo de alvo: `file` ou `folder` | `file` | | `-y, --yes` | Ignora a confirmação | — | Ao excluir arquivos, um único arquivo é removido diretamente, enquanto vários arquivos usam o endpoint de exclusão em lote. Somente **uma** pasta pode ser excluída por vez. ```bash Exemplos theme={null} # Excluir um arquivo pelo nome so-me media:delete "old-photo.jpg" # Excluir vários arquivos, ignorando a confirmação so-me media:delete file-id-1 file-id-2 -y # Excluir uma pasta e todo o seu conteúdo so-me media:delete "Old Assets" --type folder ``` > [!WARNING] > > Excluir uma pasta remove todos os arquivos dentro dela. Isso não pode ser desfeito. ### media:bulk-delete Exclui vários arquivos de mídia pelo UUID. Útil quando você já tem os IDs e quer uma única operação em lote. ```bash theme={null} so-me media:bulk-delete [options] ``` | Argumento | Descrição | | - | - | | `` | Um ou mais UUIDs de arquivos | | Opção | Descrição | | - | - | | `-y, --yes` | Ignora a confirmação | ```bash Exemplos theme={null} so-me media:bulk-delete file-id-1 file-id-2 file-id-3 so-me media:bulk-delete file-id-1 file-id-2 -y ``` ### media:move Move um arquivo ou uma pasta para outro local. A origem é resolvida entre arquivos e pastas; se um nome corresponder a mais de um item, você é solicitado a escolher. ```bash theme={null} so-me media:move --to ``` | Argumento | Descrição | | - | - | | `` | ID ou nome do arquivo ou da pasta a mover | | Opção | Descrição | | - | - | | `--to ` | ID ou nome da pasta de destino, ou `root` **(obrigatório)** | ```bash Exemplos theme={null} # Mover um arquivo para uma pasta so-me media:move "banner.png" --to "Campaign Assets" # Mover um arquivo de volta para a raiz so-me media:move "banner.png" --to root # Mover uma pasta para dentro de outra so-me media:move "Old Folder" --to "Archive" ``` ### media:rename Renomeia um arquivo ou uma pasta. Por padrão, renomeia um arquivo; passe `--type folder` para renomear uma pasta. ```bash theme={null} so-me media:rename --name [options] ``` | Argumento | Descrição | | - | - | | `` | ID ou nome do arquivo ou da pasta | | Opção | Descrição | Padrão | | - | - | - | | `--name ` | Novo nome **(obrigatório)** | — | | `--type ` | Tipo de alvo: `file` ou `folder` | `file` | ```bash Exemplos theme={null} so-me media:rename "banner.png" --name "launch-banner.png" so-me media:rename "Assets" --name "2026 Assets" --type folder ``` *** ## Pastas ### media:folders Lista todas as pastas de mídia. ```bash theme={null} so-me media:folders ``` ```bash Exemplo theme={null} so-me media:folders --table ``` ### media:create-folder Cria uma pasta de mídia, opcionalmente aninhada dentro de uma pasta pai existente. ```bash theme={null} so-me media:create-folder --name [options] ``` | Opção | Descrição | | - | - | | `--name ` | Nome da pasta **(obrigatório)** | | `--parent ` | ID ou nome da pasta pai (cria uma pasta aninhada) | ```bash Exemplos theme={null} # Criar uma pasta de nível superior so-me media:create-folder --name "Campaign Assets" # Criar uma pasta aninhada dentro de uma pasta pai existente so-me media:create-folder --name "Q3" --parent "Campaign Assets" ``` ### media:rename-folder Renomeia uma pasta de mídia. (Equivale a `media:rename --type folder`.) ```bash theme={null} so-me media:rename-folder --name ``` | Argumento | Descrição | | - | - | | `` | ID ou nome da pasta | | Opção | Descrição | | - | - | | `--name ` | Novo nome **(obrigatório)** | ```bash Exemplo theme={null} so-me media:rename-folder "Assets" --name "2026 Assets" ``` ### media:move-folder Move uma pasta para dentro de outra pasta pai. (Equivale a executar `media:move` em uma pasta.) ```bash theme={null} so-me media:move-folder --to ``` | Argumento | Descrição | | - | - | | `` | ID ou nome da pasta | | Opção | Descrição | | - | - | | `--to ` | ID ou nome da pasta pai de destino, ou `root` **(obrigatório)** | ```bash Exemplos theme={null} # Aninhar uma pasta dentro de outra so-me media:move-folder "Q3" --to "Campaign Assets" # Mover uma pasta de volta para a raiz so-me media:move-folder "Q3" --to root ``` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.