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

# Biolinks

> Crea y gestiona páginas de biolink con botones, galería, temas y analíticas

Los biolinks son páginas de destino públicas de tipo link-in-bio. Cada página tiene un slug personalizado, un nombre visible y una biografía,
un tema (predefinido o con colores personalizados), una lista de botones (enlaces, redes sociales, correo, teléfono, archivo, texto), una
cuadrícula de publicaciones o galería, y analíticas de vistas y clics. Esta página documenta todos los comandos `biolink:` que expone
la CLI.

> [!NOTE]
>
> Todos los comandos aceptan las [opciones globales](/es/cli/overview.md#opciones-globales): `--json` (por defecto) / `--table`
> para el formato de salida, `--verbose` para errores detallados y `--api-key <key>` / `--api-url <url>` para
> sustituir las credenciales en cada llamada. Ninguno de los comandos `biolink:` acepta opciones de paginación.

## Básicos

### biolink:list

Lista todas las páginas de biolink de la organización autenticada.

```bash theme={null}
so-me biolink:list
```

```bash Ejemplo theme={null}
so-me biolink:list --table
```

### biolink:get

Obtiene todos los detalles de un biolink por su ID interno.

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

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

### biolink:public

Consulta los datos públicos de un biolink mediante su slug personalizado. Este comando resuelve la página igual que lo
haría un visitante, por lo que no requiere el UUID interno.

```bash theme={null}
so-me biolink:public <slug>
```

```bash Ejemplo theme={null}
so-me biolink:public my-brand-page
```

### biolink:create

Crea una página de biolink nueva. Todas las opciones son opcionales.

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

| Opción | Descripción |
| - | - |
| `--slug <slug>` | Slug de URL personalizado (3-50 caracteres alfanuméricos) |
| `--name <name>` | Nombre visible |
| `--bio <bio>` | Texto de la biografía |

```bash Ejemplo theme={null}
so-me biolink:create --slug mypage --name "My Brand" --bio "Welcome to my page"
```

### biolink:update

Actualiza una página de biolink. Indica al menos una opción o el comando termina con un error.

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

| Opción | Descripción |
| - | - |
| `--name <name>` | Nombre visible |
| `--bio <bio>` | Texto de la biografía |
| `--slug <slug>` | Slug personalizado |
| `--button-style <style>` | Estilo de botón: `rounded`, `square`, `pill`, `outline` |
| `--show-grid` | Muestra la cuadrícula de Instagram |
| `--hide-grid` | Oculta la cuadrícula de Instagram |
| `--social-icons <json>` | Iconos sociales como un arreglo JSON de objetos `{platform, url}` |

> [!NOTE]
>
> `--social-icons` debe ser un arreglo JSON válido; un JSON no válido termina con un error antes de hacer ninguna solicitud.
> `--show-grid` y `--hide-grid` establecen la visibilidad de la cuadrícula de Instagram (pasa una, no ambas).

```bash Ejemplos theme={null}
# Rename and rewrite the bio
so-me biolink:update 550e8400-... --name "Acme Inc." --bio "Tools for makers"

# Switch button style and show the Instagram grid
so-me biolink:update 550e8400-... --button-style pill --show-grid

# Set social icons (escape the JSON for your shell)
so-me biolink:update 550e8400-... \
  --social-icons '[{"platform":"instagram","url":"https://instagram.com/acme"},{"platform":"x","url":"https://x.com/acme"}]'
```

### biolink:delete

Elimina una página de biolink. Pide confirmación a menos que se pase `-y/--yes`.

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

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

```bash Ejemplo theme={null}
so-me biolink:delete 550e8400-... --yes
```

### biolink:publish

Alterna un biolink entre publicado y no publicado. El comando invierte el estado en que se encuentre la página
y notifica el nuevo estado.

```bash theme={null}
so-me biolink:publish <id>
```

```bash Ejemplo theme={null}
so-me biolink:publish 550e8400-...
```

***

## Tema

### biolink:theme

Cambia el tema de un biolink con un tema predefinido **o** con colores personalizados. Indica `--preset`, o una o
más opciones de color personalizado; si no indicas ninguna, termina con un error. Si se indica `--preset`, tiene
prioridad y las opciones de color personalizado se ignoran.

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

| Opción | Descripción |
| - | - |
| `--preset <theme>` | Tema predefinido: `default`, `dark`, `gradient`, `minimal`, `neon`, `sunset`, `ocean`, `forest` |
| `--bg <color>` | Color de fondo personalizado (hexadecimal) |
| `--text <color>` | Color de texto personalizado (hexadecimal) |
| `--button <color>` | Color de botón personalizado (hexadecimal) |
| `--button-text <color>` | Color del texto del botón personalizado (hexadecimal) |

```bash Ejemplos theme={null}
# Use a preset
so-me biolink:theme 550e8400-... --preset neon

# Custom colors
so-me biolink:theme 550e8400-... --bg "#1a1a2e" --text "#eaeaea" --button "#5417d7" --button-text "#ffffff"
```

***

## Botones

> **biolink:buttons — Listar botones**
>
> Lista todos los botones de un biolink.
>
> ```bash theme={null}
> so-me biolink:buttons <biolink-id>
> ```
>
> ```bash Ejemplo theme={null}
> so-me biolink:buttons 550e8400-... --table
> ```

> **biolink:add-button — Añadir un botón**
>
> Añade un botón a un biolink. `--type` y `--text` son obligatorias; el resto de opciones dependen del
> tipo de botón.
>
> ```bash theme={null}
> so-me biolink:add-button <biolink-id> --type <type> --text <text> [options]
> ```
>
> | Opción | Descripción |
> | - | - |
> | `--type <type>` | Tipo de botón: `link`, `social`, `email`, `phone`, `file`, `text` **(obligatorio)** |
> | `--text <text>` | Texto del botón, máx. 100 caracteres **(obligatorio)** |
> | `--url <url>` | URL (para el tipo `link`/`social`) |
> | `--email <email>` | Correo electrónico (para el tipo `email`) |
> | `--phone <phone>` | Teléfono (para el tipo `phone`) |
> | `--file-url <url>` | URL del archivo (para el tipo `file`) |
> | `--content <content>` | Contenido (para el tipo `text`) |
> | `--icon <icon>` | Nombre del icono |
> | `--color <hex>` | Color de botón personalizado (hexadecimal) |
>
> ```bash Ejemplos theme={null}
> # Link button
> so-me biolink:add-button 550e8400-... --type link --text "Visit Website" --url https://example.com
>
> # Social button with an icon and custom color
> so-me biolink:add-button 550e8400-... --type social --text "Follow on X" \
>   --url https://x.com/acme --icon x --color "#000000"
>
> # Email button
> so-me biolink:add-button 550e8400-... --type email --text "Contact us" --email hello@example.com
> ```

> **biolink:update-button — Actualizar un botón**
>
> Actualiza un botón existente. Indica al menos una opción o el comando termina con un error.
>
> ```bash theme={null}
> so-me biolink:update-button <biolink-id> <button-id> [options]
> ```
>
> | Opción | Descripción |
> | - | - |
> | `--text <text>` | Texto del botón |
> | `--url <url>` | URL |
> | `--icon <icon>` | Icono |
> | `--color <hex>` | Color personalizado |
> | `--active` | Lo establece como activo |
> | `--inactive` | Lo establece como inactivo |
>
> ```bash Ejemplo theme={null}
> so-me biolink:update-button 550e8400-... btn-123 --text "Shop now" --url https://example.com/shop --active
> ```

> **biolink:delete-button — Eliminar un botón**
>
> Elimina un botón. Pide confirmación a menos que se pase `-y/--yes`.
>
> ```bash theme={null}
> so-me biolink:delete-button <biolink-id> <button-id> [options]
> ```
>
> | Opción | Descripción |
> | - | - |
> | `-y, --yes` | Omite la confirmación |
>
> ```bash Ejemplo theme={null}
> so-me biolink:delete-button 550e8400-... btn-123 --yes
> ```

> **biolink:reorder-buttons — Reordenar botones**
>
> Reordena los botones de un biolink. Pasa los ID de los botones como argumentos posicionales en el orden
> de visualización deseado.
>
> ```bash theme={null}
> so-me biolink:reorder-buttons <biolink-id> <button-ids...>
> ```
>
> ```bash Ejemplo theme={null}
> so-me biolink:reorder-buttons 550e8400-... btn-3 btn-1 btn-2
> ```

***

## Galería

> **biolink:posts — Listar publicaciones de la galería**
>
> Lista las publicaciones o elementos de la galería de un biolink.
>
> ```bash theme={null}
> so-me biolink:posts <biolink-id>
> ```
>
> ```bash Ejemplo theme={null}
> so-me biolink:posts 550e8400-... --table
> ```

> **biolink:add-post — Añadir una publicación a la galería**
>
> Añade una publicación a la galería. Todas las opciones son opcionales.
>
> ```bash theme={null}
> so-me biolink:add-post <biolink-id> [options]
> ```
>
> | Opción | Descripción |
> | - | - |
> | `--image <url>` | URL de la imagen |
> | `--caption <text>` | Pie de foto |
> | `--link <url>` | URL del enlace |
>
> ```bash Ejemplo theme={null}
> so-me biolink:add-post 550e8400-... \
>   --image https://cdn.example.com/photo.jpg \
>   --caption "Behind the scenes" \
>   --link https://example.com/blog
> ```

> **biolink:update-post — Actualizar una publicación de la galería**
>
> Actualiza una publicación de la galería. Indica al menos una opción o el comando termina con un error.
>
> ```bash theme={null}
> so-me biolink:update-post <biolink-id> <post-id> [options]
> ```
>
> | Opción | Descripción |
> | - | - |
> | `--caption <text>` | Pie de foto |
> | `--link <url>` | URL del enlace |
> | `--visible` | La establece como visible |
> | `--hidden` | La establece como oculta |
>
> ```bash Ejemplo theme={null}
> so-me biolink:update-post 550e8400-... post-123 --caption "Updated caption" --hidden
> ```

> **biolink:delete-post — Eliminar una publicación de la galería**
>
> Elimina una publicación de la galería. Pide confirmación a menos que se pase `-y/--yes`.
>
> ```bash theme={null}
> so-me biolink:delete-post <biolink-id> <post-id> [options]
> ```
>
> | Opción | Descripción |
> | - | - |
> | `-y, --yes` | Omite la confirmación |
>
> ```bash Ejemplo theme={null}
> so-me biolink:delete-post 550e8400-... post-123 --yes
> ```

> **biolink:reorder-posts — Reordenar publicaciones de la galería**
>
> Reordena las publicaciones de la galería. Pasa los ID de las publicaciones como argumentos posicionales en el orden de visualización deseado.
>
> ```bash theme={null}
> so-me biolink:reorder-posts <biolink-id> <post-ids...>
> ```
>
> ```bash Ejemplo theme={null}
> so-me biolink:reorder-posts 550e8400-... post-3 post-1 post-2
> ```

***

## Analíticas

### biolink:analytics

Obtiene las analíticas de un biolink, incluidas las vistas, los clics y la tasa de clics (CTR).

```bash theme={null}
so-me biolink:analytics <id>
```

```bash Ejemplo theme={null}
so-me biolink:analytics 550e8400-... --table
```


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