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

# Borradores

> Gestiona borradores de publicaciones y conviértelos en publicaciones programadas

Los comandos de borradores te permiten guardar publicaciones en curso, perfeccionarlas con el tiempo y convertirlas
en publicaciones programadas cuando estés listo para publicar.

> [!NOTE]
>
> Todos los comandos aceptan las opciones globales `--json` (por defecto), `--table`, `--verbose`,
> `--api-key <key>` y `--api-url <url>`. También puedes autenticarte con las variables de entorno `SOME_API_KEY`
> y `SOME_API_URL`.

## drafts:list

Lista los borradores de tu espacio de trabajo.

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

| Opción | Descripción |
| - | - |
| `--page <number>` | Número de página (por defecto: `1`) |
| `--limit <number>` | Elementos por página (por defecto: `20`) |

```bash Ejemplos theme={null}
# First page as a table
so-me drafts:list --table

# Second page, 50 per page
so-me drafts:list --page 2 --limit 50
```

## drafts:get

Obtiene un borrador por ID.

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

| Argumento | Descripción |
| - | - |
| `<id>` | ID del borrador |

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

## drafts:create

Crea un borrador nuevo.

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

| Opción | Descripción |
| - | - |
| `-c, --content <text>` | Contenido del borrador |
| `--title <title>` | Título del borrador |
| `--platform <platform>` | Red social: `TWITTER`, `LINKEDIN`, `INSTAGRAM`, etc. |
| `--post-type <type>` | Tipo de contenido: `TEXT`, `IMAGE`, `VIDEO`, etc. |
| `--description <desc>` | Descripción del borrador |
| `-a, --account <id>` | ID de la cuenta social |
| `-m, --media <urls...>` | URL de archivos multimedia (de `media:upload` o de la CDN) |
| `--metadata <json>` | Metadatos en JSON |

> [!NOTE]
>
> El valor de `--platform` se convierte automáticamente a mayúsculas antes de enviarse. Las URL multimedia pasadas con
> `-m, --media` se combinan con los metadatos del borrador, junto con cualquier clave indicada en `--metadata`.

```bash Ejemplos theme={null}
# Simple text draft
so-me drafts:create -c "Draft idea" --post-type TEXT

# Draft targeting a specific platform
so-me drafts:create -c "LinkedIn idea" --platform LINKEDIN --post-type TEXT

# Draft with a single media URL
so-me drafts:create -c "With image" --post-type IMAGE -m https://cdn.example.com/photo.jpg

# Draft with multiple media URLs
so-me drafts:create -c "Multiple media" -m url1 url2 url3 --post-type MULTIPLE_IMAGES

# Draft with custom metadata
so-me drafts:create -c "With metadata" --metadata '{"key":"value"}'
```

## drafts:update

Actualiza un borrador existente.

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

| Argumento | Descripción |
| - | - |
| `<id>` | ID del borrador |

| Opción | Descripción |
| - | - |
| `-c, --content <text>` | Contenido actualizado |
| `--title <title>` | Título actualizado |
| `--platform <platform>` | Red social: `TWITTER`, `LINKEDIN`, `INSTAGRAM`, etc. |
| `--post-type <type>` | Tipo de contenido actualizado |
| `--description <desc>` | Descripción actualizada |
| `-m, --media <urls...>` | URL de archivos multimedia (sustituyen a las existentes) |
| `--metadata <json>` | Metadatos actualizados en JSON |

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

## drafts:delete

Elimina uno o más borradores. Se te pedirá confirmación a menos que pases `-y, --yes`.
La CLI sigue eliminando el resto de los ID aunque uno de ellos falle.

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

| Argumento | Descripción |
| - | - |
| `<ids...>` | Uno o más ID de borrador |

| Opción | Descripción |
| - | - |
| `-y, --yes` | Omite la confirmación |

```bash Ejemplos theme={null}
# Delete a single draft (prompts for confirmation)
so-me drafts:delete draft-id-1

# Bulk delete several drafts without confirmation
so-me drafts:delete draft-id-1 draft-id-2 -y
```

## drafts:convert

Convierte un borrador en una publicación. Las opciones que pases sustituyen a los valores guardados en el borrador.

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

| Argumento | Descripción |
| - | - |
| `<id>` | ID del borrador |

| Opción | Descripción |
| - | - |
| `--platform <platform>` | Red social: `TWITTER`, `LINKEDIN`, `INSTAGRAM`, etc. |
| `--post-type <type>` | Tipo de contenido: `TEXT`, `IMAGE`, `VIDEO`, etc. |
| `-c, --content <text>` | Contenido de la publicación (sustituye al texto del borrador) |
| `-a, --account <id>` | ID de la cuenta social |
| `-s, --date <date>` | Fecha de programación (ISO 8601) |

```bash Ejemplos theme={null}
# Convert to a Twitter post
so-me drafts:convert <id> --platform TWITTER --post-type TEXT

# Convert and schedule for LinkedIn
so-me drafts:convert <id> --platform LINKEDIN -s 2026-04-10T14:00:00Z

# Convert to an Instagram image post
so-me drafts:convert <id> --platform INSTAGRAM --post-type IMAGE
```

> [!TIP]
>
> Si pasas `--platform` pero omites `--account`, la CLI busca tus cuentas conectadas de
> esa plataforma. Si coincide exactamente una, se selecciona automáticamente; si coinciden varias, se
> te pide que elijas una de forma interactiva. Si no se encuentra ninguna cuenta, la conversión continúa sin
> una cuenta concreta y el backend decide cómo gestionarlo.


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