Vault

Update vault connection tags

Replaces the tags on a connection. The list you send becomes the new set — tags you omit are removed. Scoped automatically to your credential.

patch/v1/vault/connections/{id}

Request

  • Base URL: https://api.withone.ai
  • URL: https://api.withone.ai/v1/vault/connections/{id}
  • Auth: one of:
    • API key in header X-One-Secret
    • OAuth 2 (authorization code, authorization URL https://api.withone.ai/oauth/authorize, token URL https://api.withone.ai/oauth/token, scopes: user:connections:write)
    • OAuth 2 (authorization code, authorization URL https://api.withone.ai/oauth/authorize, token URL https://api.withone.ai/oauth/token, scopes: org:connections:write)
    • OAuth 2 (authorization code, authorization URL https://api.withone.ai/oauth/authorize, token URL https://api.withone.ai/oauth/token, scopes: project:connections:write)

Path parameters

idstring uuid required

Connection ID

Headers

X-One-Organization-Idstring uuid

Selects the tenant this request acts in. Omit it to act in your personal scope.

X-One-Project-Idstring uuid

Selects the tenant this request acts in. Omit it to act in your personal scope.

Request body

namestring nullable

New display name for the connection. Empty string clears it; when omitted, the name is left untouched.

tagsstring[] nullable

New tag set for the connection, checked by the shared tag check in the handler. When omitted, tags are left untouched.

Response

Vault connection tags updated

Changes

No recorded changes to this operation across all 1 revision of this API.