Skip to Content

1Password commands

A Modem 1Password integration stores a service-account token on Modem’s server. The local op CLI can help choose that token; its desktop sign-in is not itself the server integration.

modem-cli secrets-integrations doctor modem-cli secrets-integrations create --display-name 'Provider credentials'

doctor checks local op installation and sign-in. With a usable local session, creation offers vaults, items and concealed fields, then reads the chosen token reference. Without op, an interactive terminal can use a masked prompt. Piped stdin or --op-read provides alternatives:

op read 'op://VAULT_ID/ITEM_ID/token' | modem-cli secrets-integrations create modem-cli secrets-integrations create --op-read 'op://VAULT_ID/ITEM_ID/token'

The selected value must be a service-account token with access to the required vaults. An op:// reference to that token is local input; Modem receives the resolved token for storage. It then uses its own service-account connection to resolve provider references.

Browse and attach

modem-cli secrets-integrations list modem-cli secrets-integrations vaults --integration-id INTEGRATION_ID modem-cli secrets-integrations items --integration-id INTEGRATION_ID --vault-id VAULT_ID modem-cli accounts create --project-id PROJECT_ID --provider openai \ --integration-id INTEGRATION_ID \ --secret-reference 'op://VAULT_ID/ITEM_ID/credential' modem-cli products accounts attach --project-id PROJECT_ID \ --product-id PRODUCT_ID --account-id ACCOUNT_ID

Prefer IDs in stored references so renaming a vault or item does not break them. For section fields, use op://VAULT_ID/ITEM_ID/SECTION_ID/FIELD_ID. accounts update accepts the same credential source options plus --account-id and replaces the source.

Modem resolves the value server-side; account responses contain a preview and reference information, not the materialized credential. Browsing vault metadata does not attach an account to a product.

Refresh and remove

modem-cli secrets-integrations sync --integration-id INTEGRATION_ID modem-cli secrets-integrations delete --integration-id INTEGRATION_ID

Sync refreshes referenced account/provider credential fields; browsing or refreshing item metadata is not the same operation. Inspect the sync result for partial failures and diagnose vault access or token rejection separately from temporary service unavailability.

Unlinking is refused while provider/authentication/billing credentials still depend on the integration. Move those references or remove their uses first. Deleting the integration requires confirmation or --yes in automation. See provider account setup for the app workflow and server connector for embedding 1Password in your own server.

Last updated on