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

# Rascunhos

> Gerencie rascunhos de posts e converta-os em posts agendados

Os comandos de rascunho permitem salvar posts em andamento, refiná-los ao longo do tempo e convertê-los
em posts agendados quando você estiver pronto para publicar.

> [!NOTE]
>
> Todos os comandos aceitam as flags globais `--json` (padrão), `--table`, `--verbose`,
> `--api-key <key>` e `--api-url <url>`. Você também pode se autenticar com as variáveis de ambiente `SOME_API_KEY`
> e `SOME_API_URL`.

## drafts:list

Lista os rascunhos de posts do seu espaço de trabalho.

```bash theme={null}
so-me drafts:list [options]
```

| Opção | Descrição |
| - | - |
| `--page <number>` | Número da página (padrão: `1`) |
| `--limit <number>` | Itens por página (padrão: `20`) |

```bash Exemplos theme={null}
# Primeira página como tabela
so-me drafts:list --table

# Segunda página, 50 por página
so-me drafts:list --page 2 --limit 50
```

## drafts:get

Obtém um único rascunho pelo ID.

```bash theme={null}
so-me drafts:get <id>
```

| Argumento | Descrição |
| - | - |
| `<id>` | ID do rascunho |

```bash Exemplo theme={null}
so-me drafts:get 550e8400-e29b-41d4-a716-446655440000
```

## drafts:create

Cria um novo rascunho de post.

```bash theme={null}
so-me drafts:create [options]
```

| Opção | Descrição |
| - | - |
| `-c, --content <text>` | Conteúdo do rascunho |
| `--title <title>` | Título do rascunho |
| `--platform <platform>` | Plataforma social: `TWITTER`, `LINKEDIN`, `INSTAGRAM` etc. |
| `--post-type <type>` | Tipo de conteúdo: `TEXT`, `IMAGE`, `VIDEO` etc. |
| `--description <desc>` | Descrição do rascunho |
| `-a, --account <id>` | ID da conta social |
| `-m, --media <urls...>` | URLs de mídia (de `media:upload` ou da CDN) |
| `--metadata <json>` | Metadados em JSON |

> [!NOTE]
>
> O valor de `--platform` é convertido automaticamente para maiúsculas antes de ser enviado. As URLs de mídia passadas com
> `-m, --media` são mescladas aos metadados do rascunho, junto com quaisquer chaves informadas em `--metadata`.

```bash Exemplos theme={null}
# Rascunho de texto simples
so-me drafts:create -c "Draft idea" --post-type TEXT

# Rascunho para uma plataforma específica
so-me drafts:create -c "LinkedIn idea" --platform LINKEDIN --post-type TEXT

# Rascunho com uma única URL de mídia
so-me drafts:create -c "With image" --post-type IMAGE -m https://cdn.example.com/photo.jpg

# Rascunho com várias URLs de mídia
so-me drafts:create -c "Multiple media" -m url1 url2 url3 --post-type MULTIPLE_IMAGES

# Rascunho com metadados personalizados
so-me drafts:create -c "With metadata" --metadata '{"key":"value"}'
```

## drafts:update

Atualiza um rascunho existente.

```bash theme={null}
so-me drafts:update <id> [options]
```

| Argumento | Descrição |
| - | - |
| `<id>` | ID do rascunho |

| Opção | Descrição |
| - | - |
| `-c, --content <text>` | Conteúdo atualizado |
| `--title <title>` | Título atualizado |
| `--platform <platform>` | Plataforma social: `TWITTER`, `LINKEDIN`, `INSTAGRAM` etc. |
| `--post-type <type>` | Tipo de conteúdo atualizado |
| `--description <desc>` | Descrição atualizada |
| `-m, --media <urls...>` | URLs de mídia (substituem as existentes) |
| `--metadata <json>` | Metadados atualizados em JSON |

```bash Exemplo theme={null}
so-me drafts:update 550e8400-... -c "Revised draft copy" --title "Launch teaser"
```

## drafts:delete

Exclui um ou mais rascunhos. Será pedida uma confirmação, a menos que você passe `-y, --yes`.
A CLI continua excluindo os IDs restantes mesmo que um deles falhe.

```bash theme={null}
so-me drafts:delete <ids...> [options]
```

| Argumento | Descrição |
| - | - |
| `<ids...>` | Um ou mais IDs de rascunho |

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

```bash Exemplos theme={null}
# Excluir um único rascunho (pede confirmação)
so-me drafts:delete draft-id-1

# Excluir vários rascunhos em lote, sem confirmação
so-me drafts:delete draft-id-1 draft-id-2 -y
```

## drafts:convert

Converte um rascunho em um post. Quaisquer opções que você passar substituem os valores armazenados no rascunho.

```bash theme={null}
so-me drafts:convert <id> [options]
```

| Argumento | Descrição |
| - | - |
| `<id>` | ID do rascunho |

| Opção | Descrição |
| - | - |
| `--platform <platform>` | Plataforma social: `TWITTER`, `LINKEDIN`, `INSTAGRAM` etc. |
| `--post-type <type>` | Tipo de conteúdo: `TEXT`, `IMAGE`, `VIDEO` etc. |
| `-c, --content <text>` | Conteúdo do post (substitui o texto do rascunho) |
| `-a, --account <id>` | ID da conta social |
| `-s, --date <date>` | Data de agendamento (ISO 8601) |

```bash Exemplos theme={null}
# Converter em um post do Twitter
so-me drafts:convert <id> --platform TWITTER --post-type TEXT

# Converter e agendar para o LinkedIn
so-me drafts:convert <id> --platform LINKEDIN -s 2026-04-10T14:00:00Z

# Converter em um post de imagem do Instagram
so-me drafts:convert <id> --platform INSTAGRAM --post-type IMAGE
```

> [!TIP]
>
> Quando você passa `--platform` mas omite `--account`, a CLI procura entre as suas contas conectadas
> para essa plataforma. Se exatamente uma corresponder, ela é selecionada automaticamente; se várias corresponderem, você
> é solicitado a escolher uma de forma interativa. Se nenhuma conta for encontrada, a conversão prossegue sem
> uma conta específica e o backend decide como tratar o caso.


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