update

---

path: api-and-integrations/cli-utility/update.mdx title: Actualización de datos (update) slug: /api-and-integrations/cli-utility/update pagination_next: null pagination_prev: null createdAt: "Mon Nov 03 2025 00:00:00 GMT+0000 (Coordinated Universal Time)" updatedAt: "Mon Nov 03 2025 00:00:00 GMT+0000 (Coordinated Universal Time)" description: >- Modo update: actualización de registros y campos a través de CLI con consideraciones de seguridad. keywords:

• Passwork
• CLI
• update
• modifying data
• security

---

Descripción general

update modifica los valores de los registros de Passwork (contraseña, nombre, campos personalizados) según los parámetros proporcionados.

Casos de uso

1. Actualización de campos individuales — cambiar contraseña, nombre, login, URL, descripción, etiquetas o campos personalizados por separado
2. Limpieza de valores de campos — establecer campos como vacíos pasando una cadena vacía
3. Actualizaciones masivas — cambiar múltiples campos con un solo comando
4. Actualización de campos personalizados — añadir/cambiar campos personalizados para elementos y accesos directos

Identificación de elementos

Parámetro	Descripción
--password-id	ID del elemento (item)
--shortcut-id	ID del acceso directo (shortcut)

Parámetros de actualización

Parámetro	Descripción
--name	Nuevo nombre del elemento. Un valor vacío devolverá un error
--password	Nuevo valor de la contraseña
--login	Nuevo valor del login
--url	Nueva dirección URL
--description	Nuevo valor de la nota
--tags	Lista de etiquetas separadas por comas. Una cadena vacía borra las etiquetas
--custom-{name}	Establecer un campo personalizado por nombre, por ejemplo, --custom-API_KEY "..."

Sintaxis

shell

passwork-cli update --password-id <id> [field-changes]

Uso básico

Especifique --password-id o --shortcut-id para identificar el objeto a actualizar.

shell

passwork-cli update \
  --host "https://passwork.example.com" \
  --token "your_access_token" \
  --master-key "your_master_key" \
  --password-id "68793e13dfc88d879e0f2e39" \
  --password "new-password-value"

Uso de variables de entorno

Puede exportar los datos de Passwork como variables de entorno:

shell

export PASSWORK_HOST="https://passwork.example.com"
export PASSWORK_TOKEN="your_access_token"
export PASSWORK_MASTER_KEY="your_master_key"

# Then update without specifying credentials
passwork-cli update \
  --password-id "68793e13dfc88d879e0f2e39" \
  --password "new-password"

Esto es útil para scripts de automatización y pipelines de CI/CD, donde las credenciales pueden almacenarse de forma segura como variables de entorno.

Actualización de campos estándar

Campos estándar: nombre, contraseña, login, URL, descripción y etiquetas.

shell

# Update password
passwork-cli update --password-id "68793e13dfc88d879e0f2e39" --password "new-password"

# Update login
passwork-cli update --password-id "68793e13dfc88d879e0f2e39" --login "new-login"

# Update name
passwork-cli update --password-id "68793e13dfc88d879e0f2e39" --name "New Item Name"

# Update URL
passwork-cli update --password-id "68793e13dfc88d879e0f2e39" --url "https://example.com"

# Update description
passwork-cli update --password-id "68793e13dfc88d879e0f2e39" --description "Updated description"

# Update tags (comma-separated)
passwork-cli update --password-id "68793e13dfc88d879e0f2e39" --tags "tag1,tag2,tag3"

# Clear field (set to empty)
passwork-cli update --password-id "68793e13dfc88d879e0f2e39" --description ""

Actualización de campos personalizados

Se actualiza utilizando la sintaxis --custom-*, donde * es el nombre del campo personalizado.

shell

# Update custom field API_KEY
passwork-cli update \
  --password-id "68793e13dfc88d879e0f2e39" \
  --custom-API_KEY "new-api-key-value"

# Clear custom field
passwork-cli update \
  --password-id "68793e13dfc88d879e0f2e39" \
  --custom-API_KEY ""

Actualizaciones masivas

Actualice múltiples campos con un solo comando.

shell

# Update login and password together
passwork-cli update \
  --password-id "68793e13dfc88d879e0f2e39" \
  --login "new-login" \
  --password "new-password"

# Update multiple fields including custom field
passwork-cli update \
  --password-id "68793e13dfc88d879e0f2e39" \
  --password "new-password" \
  --description "Updated description" \
  --tags "production,database,api" \
  --custom-API_KEY "new-api-key-value"

# Full update with all fields
passwork-cli update \
  --password-id "68793e13dfc88d879e0f2e39" \
  --name "UpdateName" \
  --login "UpdateLogin" \
  --password "UpdatePassword" \
  --description "UpdateDescription" \
  --tags "update,all,tags" \
  --url "https://update.url" \
  --custom-API_KEY "update_api_key"

Trabajo con accesos directos

Parámetros similares funcionan para accesos directos a través de --shortcut-id.

shell

# Update shortcut fields
passwork-cli update \
  --shortcut-id "68d6c94bec3a3fe41209546e" \
  --password "shortcut-password" \
  --login "shortcut-login"

# Update shortcut with multiple fields
passwork-cli update \
  --shortcut-id "68d6c94bec3a3fe41209546e" \
  --name "Update name" \
  --description "Updated shortcut" \
  --tags "shortcut,updated" \
  --custom-API_KEY "shortcut-api-key"

Cómo funciona

1. CLI se conecta al servidor de Passwork utilizando las credenciales proporcionadas
2. Obtiene un elemento o acceso directo por ID
3. Descifra los datos utilizando la clave maestra (si se utiliza cifrado del lado del cliente)
4. Aplica nuevos valores a los campos especificados
5. Las cadenas vacías ("") borran los campos correspondientes
6. Los campos personalizados se cambian mediante la sintaxis --custom-*
7. Las etiquetas se aceptan como una lista separada por comas y reemplazan las existentes
8. El objeto actualizado se guarda en Passwork