/integrations/onepassword
POST/integrations/onepassword
Registers a 1Password integration for the requesting token. The supplied service-account token is encrypted at rest and is never returned by this or any other endpoint. Returns the created integration without any token field.
Note: This endpoint is also available at: /management/integrations/onepassword for backwards compatibility.
Request
Body
- Schema
- Example (auto)
A user-visible label for the integration. Unique per token.
Integration kind. Defaults to "service_account".
Possible values: [connect, service_account]
The 1Password service-account token (or Connect access token when kind is "connect"). Encrypted at rest; never returned by any API.
Origins this integration may fill credentials into. Empty means no fills pass.
Connect server URL. Required when kind is "connect", rejected otherwise.
{
"label": "string",
"kind": "connect",
"serviceAccountToken": "string",
"allowedDomains": [
"string"
],
"connectUrl": "string"
}
Responses
- 200
- 400
- 401
- 403
- 404
- 408
- 429
- 500
- 503
Public-facing integration response returned by HTTP routes. Omits internal fields — never includes token_hash or any token material.
Schema
- Fields
- Example (auto)
Live vault titles, only with includeVaults=true; null when unavailable.
Unique integration identifier.
User-supplied label. Unique per token.
Integration kind: service_account (default) or connect.
Possible values: [connect, service_account]
Origins this integration is allowed to fill into.
Connect server URL when kind is connect, otherwise null.
ISO timestamp after which the integration is treated as expired, or null.
ISO timestamp of the last successful secret resolve, or null if never used.
ISO timestamp of when the integration was created.
ISO timestamp of the last metadata change.
{
"vaults": [
"string"
],
"id": "string",
"label": "string",
"kind": "connect",
"allowedDomains": [
"string"
],
"connectUrl": "string",
"expiresAt": "string",
"lastResolvedAt": "string",
"createdAt": "string",
"updatedAt": "string"
}
The request contains errors or didn't properly encode content.
The request is missing, or contains bad, authorization credentials.
The request targets a destination that is not allowed.
Resource couldn't be found.
The request took has taken too long to process.
Too many requests are currently being processed.
An internal error occurred when handling the request.
Service is unavailable.