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

# Equipos

> Invita y gestiona miembros del equipo e invitaciones en tu espacio de trabajo

Los comandos de equipo te permiten invitar miembros a tu espacio de trabajo, listar los miembros actuales y las
invitaciones pendientes, cambiar el rol y el ajuste de aprobación de publicaciones de un miembro, eliminar miembros y cancelar
invitaciones.

> [!NOTE]
>
> Todos los comandos aceptan las [opciones globales](/es/cli/overview.md#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`.

> [!NOTE]
>
> Los **roles** son `member` u `owner`. La **aprobación de publicaciones** es `requires_approval` o `auto_approve` y
> controla si las publicaciones del miembro deben aprobarse antes de publicarse.

## teams:list

Lista los miembros de tu espacio de trabajo.

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

| Opción | Descripción | Por defecto |
| - | - | - |
| `--page <number>` | Número de página | `1` |
| `--limit <number>` | Elementos por página | `50` |

```bash Ejemplos theme={null}
# Default JSON output
so-me teams:list

# Table view
so-me teams:list --table

# Paginate
so-me teams:list --page 2 --limit 100

# List only owners via jq
so-me teams:list --limit 100 | jq '.data[] | select(.role == "owner")'
```

## teams:invite

Invita a un miembro nuevo del equipo por correo electrónico.

```bash theme={null}
so-me teams:invite --email <email> [options]
```

| Opción | Descripción | Por defecto |
| - | - | - |
| `--email <email>` | Correo electrónico al que invitar **(obligatorio)** | — |
| `--role <role>` | Rol del miembro: `member` u `owner` | `member` |
| `--post-approval <approval>` | Aprobación de publicaciones: `requires_approval` o `auto_approve` | valor del servidor |

> [!NOTE]
>
> El valor de `--role` se valida contra `member` / `owner` y se convierte a minúsculas antes de enviarse. Si se
> omite `--post-approval`, el backend aplica su ajuste de aprobación por defecto.

```bash Ejemplos theme={null}
# Invite with default settings (member role)
so-me teams:invite --email alice@example.com

# Invite an owner
so-me teams:invite --email bob@example.com --role owner

# Invite a member who can publish without approval
so-me teams:invite --email carol@example.com --role member --post-approval auto_approve

# Invite a member whose posts require approval
so-me teams:invite --email dan@example.com --post-approval requires_approval
```

## teams:invitations

Lista las invitaciones de equipo pendientes.

```bash theme={null}
so-me teams:invitations [options]
```

| Opción | Descripción | Por defecto |
| - | - | - |
| `--page <number>` | Número de página | `1` |
| `--limit <number>` | Elementos por página | `50` |

```bash Ejemplos theme={null}
# Default JSON output
so-me teams:invitations

# Table view
so-me teams:invitations --table

# Paginate
so-me teams:invitations --page 2 --limit 100
```

## teams:update

Actualiza el rol y/o el ajuste de aprobación de publicaciones de un miembro del equipo. Debes indicar `--role`,
`--post-approval` o ambos; el comando falla si no se indica ninguno.

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

**id-or-email** `string` *required*

El ID o el correo electrónico del miembro.

| Opción | Descripción |
| - | - |
| `--role <role>` | Rol del miembro: `owner` o `member` |
| `--post-approval <approval>` | Aprobación de publicaciones: `requires_approval` o `auto_approve` |

> [!NOTE]
>
> Cuando cambias solo `--post-approval` (sin `--role`), la CLI busca primero al miembro en
> la lista de tu equipo para conservar su rol actual, ya que el endpoint subyacente siempre requiere un
> rol. Los valores de `--role` y `--post-approval` se validan antes de enviar la solicitud.

```bash Ejemplos theme={null}
# Promote a member to owner
so-me teams:update alice@example.com --role owner

# Switch a member to auto-approve (role preserved automatically)
so-me teams:update alice@example.com --post-approval auto_approve

# Update role and post-approval together
so-me teams:update bob@example.com --role member --post-approval requires_approval

# Update by member ID
so-me teams:update 550e8400-e29b-41d4-a716-446655440000 --role owner
```

## teams:remove

Elimina a un miembro del equipo del espacio de trabajo. Se te pedirá confirmación a menos que pases `-y, --yes`.

```bash theme={null}
so-me teams:remove <id-or-email> [options]
```

**id-or-email** `string` *required*

El ID o el correo electrónico del miembro.

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

```bash Ejemplos theme={null}
# Remove a member (prompts for confirmation)
so-me teams:remove alice@example.com

# Remove without confirmation
so-me teams:remove alice@example.com -y

# Remove by member ID
so-me teams:remove 550e8400-e29b-41d4-a716-446655440000 --yes
```

## teams:cancel-invite

Cancela una invitación pendiente por ID o correo electrónico. Se te pedirá confirmación a menos que pases `-y, --yes`.

```bash theme={null}
so-me teams:cancel-invite <id-or-email> [options]
```

**id-or-email** `string` *required*

El ID o el correo electrónico de la invitación.

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

```bash Ejemplos theme={null}
# Cancel an invitation (prompts for confirmation)
so-me teams:cancel-invite alice@example.com

# Cancel without confirmation
so-me teams:cancel-invite alice@example.com -y

# Cancel all pending invitations in one pipeline
so-me teams:invitations --limit 100 \
  | jq -r '.data[].id' \
  | xargs -I {} so-me teams:cancel-invite {} -y
```


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