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.

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.

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 <id-or-name>`	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.

Exemplos

# 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

Resposta

{
  "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.

so-me media:list [options]

Opção	Descrição
`--folder <id-or-name>`	Lista o conteúdo de uma pasta específica (resolvida por UUID ou nome)
`--file <id-or-name>`	Obtém os detalhes de um arquivo específico (resolvido por UUID, nome com prefixo de UUID ou busca por nome)

Exemplos

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

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.

so-me media:search <term>

Argumento	Descrição
`<term>`	Termo de busca comparado com os nomes dos arquivos

Exemplo

so-me media:search "banner"

media:get

Obtém os metadados detalhados de um arquivo de mídia específico pelo UUID.

so-me media:get <id>

Argumento	Descrição
`<id>`	UUID do arquivo

Exemplo

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.

so-me media:delete <items...> [options]

Argumento	Descrição
`<items...>`	Um ou mais IDs ou nomes de arquivos/pastas

Opção	Descrição	Padrão
`--type <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.

Exemplos

# 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

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.

so-me media:bulk-delete <ids...> [options]

Argumento	Descrição
`<ids...>`	Um ou mais UUIDs de arquivos

Opção	Descrição
`-y, --yes`	Ignora a confirmação

Exemplos

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.

so-me media:move <id-or-name> --to <folder-id-or-name>

Argumento	Descrição
`<id-or-name>`	ID ou nome do arquivo ou da pasta a mover

Opção	Descrição
`--to <folder-id-or-name>`	ID ou nome da pasta de destino, ou `root` (obrigatório)

Exemplos

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

so-me media:rename <id-or-name> --name <new-name> [options]

Argumento	Descrição
`<id-or-name>`	ID ou nome do arquivo ou da pasta

Opção	Descrição	Padrão
`--name <new-name>`	Novo nome (obrigatório)	—
`--type <type>`	Tipo de alvo: `file` ou `folder`	`file`

Exemplos

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.

so-me media:folders

Exemplo

so-me media:folders --table

media:create-folder

Cria uma pasta de mídia, opcionalmente aninhada dentro de uma pasta pai existente.

so-me media:create-folder --name <name> [options]

Opção	Descrição
`--name <name>`	Nome da pasta (obrigatório)
`--parent <id-or-name>`	ID ou nome da pasta pai (cria uma pasta aninhada)

Exemplos

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

so-me media:rename-folder <id-or-name> --name <new-name>

Argumento	Descrição
`<id-or-name>`	ID ou nome da pasta

Opção	Descrição
`--name <new-name>`	Novo nome (obrigatório)

Exemplo

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

so-me media:move-folder <id-or-name> --to <parent-id-or-name>

Argumento	Descrição
`<id-or-name>`	ID ou nome da pasta

Opção	Descrição
`--to <parent-id-or-name>`	ID ou nome da pasta pai de destino, ou `root` (obrigatório)

Exemplos

# 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

Primeiros passos

Publicação

AI Studio

Caixa de entrada e engajamento

Análises

Biolink

Equipe e colaboração

Configurações e cobrança

Webhooks

Suporte

Arquivos

media:upload

media:list

media:search

media:get

media:delete

media:bulk-delete

media:move

media:rename

Pastas

media:folders

media:create-folder

media:rename-folder

media:move-folder

​Arquivos

​media:upload

​media:list

​media:search

​media:get

​media:delete

​media:bulk-delete

​media:move

​media:rename

​Pastas

​media:folders

​media:create-folder

​media:rename-folder

​media:move-folder

Arquivos

media:upload

media:list

media:search

media:get

media:delete

media:bulk-delete

media:move

media:rename

Pastas

media:folders

media:create-folder

media:rename-folder

media:move-folder