← Docs

Docs · Connector reference

1Password connector reference

Operations, inputs, troubleshooting, and questions for the 1Password connection. Policy decides each change before the credential is resolved, and the action record carries the result.

Set up and verify the 1Password connection

  1. Choose one task and its account, and match the reads and actions on the overview page to it before granting provider permissions.
  2. Prepare the connection settings from the overview page, connect the provider in Deixic, and choose which tools your agent can use.
  3. Try a small task with a known result, and compare the returned identity and resource with what the account owner expects.
  4. Configure approval for sensitive changes, review the destination and inputs, and check the result in the provider before expanding the workflow.

Information your agent can use

ResourceRecord identityStart withPage coverage
VaultsidTop levelNone configured
ItemsidVaultsNone configured
ActivityrequestIdTop levelOffset
Record identity
Match on these fields before joining or deduplicating results; where none is specified, check the returned record first.
Start with
Resolve the parent identifier first.
None configured
No page continuation is configured for this resource. Check the response and any provider limits before treating it as a complete inventory.
Offset
Offset pagination. Records can move between pages while the collection changes; compare stable identifiers when reconciling results.

Supported operations

Review the inputs before granting an action to an agent. Required inputs must be supplied, optional inputs narrow the request, and provider permissions apply in addition to Deixic policy.

Action
Can change provider state; review the target and inputs, then retain the result to avoid repeating completed work.
Read
Retrieves information; check the returned scope and identifiers before use.
OperationEffectApprovalProvider permissionsInputs
Items CreateActionApproval requireditems.write9
Items UpdateActionApproval requireditems.write10
Items DeleteActionApproval requireditems.write2
Items GetReadBy policyitems.read2

Inputs by operation

Items Create Action · approval required
Inputs for 1password Items Create
InputRequirementAccepted value
categoryRequiredstring; one of: LOGIN, PASSWORD, API_CREDENTIAL, SERVER, DATABASE, CREDIT_CARD, MEMBERSHIP, PASSPORT, SOFTWARE_LICENSE, OUTDOOR_LICENSE, SECURE_NOTE, WIRELESS_ROUTER, BANK_ACCOUNT, DRIVER_LICENSE, IDENTITY, REWARD_PROGRAM, EMAIL_ACCOUNT, SOCIAL_SECURITY_NUMBER, MEDICAL_RECORD, SSH_KEY
favoriteOptionalboolean
fieldsOptionalarrayMaximum items: 128
sectionsOptionalarrayMaximum items: 64
tagsOptionalarrayMaximum items: 64
titleRequiredstringMinimum characters: 1Maximum characters: 512
urlsOptionalarrayMaximum items: 32
vaultRequiredobject
vault_uuidRequiredstring
Items Update Action · approval required
Inputs for 1password Items Update
InputRequirementAccepted value
categoryRequiredstring; one of: LOGIN, PASSWORD, API_CREDENTIAL, SERVER, DATABASE, CREDIT_CARD, MEMBERSHIP, PASSPORT, SOFTWARE_LICENSE, OUTDOOR_LICENSE, SECURE_NOTE, WIRELESS_ROUTER, BANK_ACCOUNT, DRIVER_LICENSE, IDENTITY, REWARD_PROGRAM, EMAIL_ACCOUNT, SOCIAL_SECURITY_NUMBER, MEDICAL_RECORD, SSH_KEY
favoriteOptionalboolean
fieldsOptionalarrayMaximum items: 128
item_uuidRequiredstring
sectionsOptionalarrayMaximum items: 64
tagsOptionalarrayMaximum items: 64
titleRequiredstringMinimum characters: 1Maximum characters: 512
urlsOptionalarrayMaximum items: 32
vaultRequiredobject
vault_uuidRequiredstring
Items Delete Action · approval required
Inputs for 1password Items Delete
InputRequirementAccepted value
item_uuidRequiredstring
vault_uuidRequiredstring
Items Get Read
Inputs for 1password Items Get
InputRequirementAccepted value
item_uuidRequiredstring
vault_uuidRequiredstring

When the 1Password task does not produce the expected result

Connected, but the expected data is missing

Check the identity behind the bearer token connection and its access to the specific resource; a successful connection does not establish access to every object.

Resolve parent resources first: Vaults. A matching display name is not enough for a child lookup.

The answer covers only part of the data

Check the resource’s page coverage, query filters, and result limit, and have the agent state the account and time window it inspected, so a partial response yields a scoped answer.

The agent keeps doing the same work

Inspect the action history for repeated targets and inputs, keep the successful result’s identifiers with the task, and refresh a lookup only when the information changed.

A change is waiting or failed

Check whether the call awaits approval, was rejected by policy, lacks an input, or failed at the provider, and after a timeout inspect the destination before repeating a write.

See how an action proceeds and how to review an approval.

Questions about the 1Password connector

Can I use my existing agent with 1Password?

Yes: connect your agent to Deixic through MCP, choose which connected tools it can use, and Deixic checks calls routed through its gateway; Dex is available if your team also wants an agent.

Can an agent change data in 1Password?

This connector supports 1 action, listed on its overview page. Configure a connection and choose the tools and provider permissions your task needs; an available action is not permission for every agent to run it, and Deixic policy and any required approval still apply to calls through the gateway.

What do I need to connect 1Password?

Prepare Connect server host, Connect token; the connection uses Bearer token, and the connected identity’s provider permissions determine which resources it can access.

Does connecting 1Password keep every answer up to date?

No: an earlier answer is still an earlier answer, so for a decision that depends on current state, have the agent refresh the source and retain the lookup time, and save stable instructions separately from facts that can change.