Skip to main content
GET
/
api
/
v2
/
vaults
/
{vault_id}
Retrieve a vault
curl --request GET \
  --url https://agp.eu.hcompany.ai/api/v2/vaults/{vault_id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "<string>",
  "org_id": "<string>",
  "name": "<string>",
  "provider_config": {},
  "created_at": "<string>",
  "updated_at": "<string>"
}
Fetches a single vault config. The stored service account token is write-only and is never included in the response. Returns the vault object.

​
Path parameters

​
vault_id
string
required
The vault config’s id (UUID).

​
The vault object

​
id
string
Unique vault config identifier (UUID).
​
org_id
string
Organization that owns the config.
​
name
string
Human-readable label.
​
provider_config
object
Provider settings.
  • provider (string): Secrets provider. Currently always onepassword.
  • op_vault_id (string): Identifier of the 1Password vault credentials are read from.
​
created_at
string
ISO 8601 creation timestamp.
​
updated_at
string
ISO 8601 timestamp of the last change.

​
Examples

curl "https://agp.eu.hcompany.ai/api/v2/vaults/f47ac10b-58cc-4372-a567-0e02b2c3d479" \
  -H "Authorization: Bearer $HAI_API_KEY"
Response
{
  "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "org_id": "org_123",
  "name": "prod-1password",
  "provider_config": {"provider": "onepassword", "op_vault_id": "abcd1234efgh5678"},
  "created_at": "2026-05-07T14:30:00Z",
  "updated_at": "2026-05-07T14:30:00Z"
}

​
Errors

StatusCause
404Vault not found or you don’t have access.