---
title: "Update connection"
method: PUT
path: "/v1/connections/{id}"
tags: ["Owner"]
---

# Update connection

`PUT /v1/connections/{id}`

## Request

- Base URL: `https://api.vicem.ai`
- URL: `https://api.vicem.ai/v1/connections/{id}`
- Auth: HTTP bearer

## Path parameters

- `id` string, required

## Request body

- UpdateConnectionRequest
  - `settings` object, required
    - `busyCalendarIds` string[]
    - `writeCalendarId` string
    - `bookHere` true
    - `categories` string[]

## Response `200`

OK

- PutSecretConnectionResponse
  - `id` string, required
  - `provider` 'google' | 'microsoft' | 'caldav' | 'slack' | 'teams' | 'hubspot' | 'jobber' | 'followupboss' | 'housecallpro' | 'highlevel' | 'ics' | 'cliogrow', required
  - `accountEmail` string, required
  - `purposes` string[], required
  - `status` 'active' | 'needs_reconnect' | 'revoked', required
  - `settings` object, required
    - `busyCalendarIds` string[]
    - `writeCalendarId` string
    - `bookHere` true
    - `categories` string[]
  - `createdAt` string, date-time, required
  - `lastSyncedAt` string, date-time, required
  - `sharing` boolean
  - `crm` object
    - `lastSentAt` string, date-time, required
    - `retrying` integer, required
    - `stuck` integer, required
    - `refused` integer
    - `refusedField` string, nullable

## Other responses

- `400`: Invalid request (body not JSON, or schema validation failed).
- `401`: Missing, expired or invalid bearer token.
- `404`: No such resource, or not visible to this caller.
- `413`: Body over the limit (64 KB; 512 KB for contact import).
- `500`: Unexpected server error (reported to Sentry).

---

[API](https://skmtc.dev/vicem/apis/vicem-api.md) · [All operations](https://skmtc.dev/vicem/apis/vicem-api/llms.txt) · [OpenAPI document](https://skmtc.dev/vicem/apis/vicem-api/revisions/9efcec07e5f4?raw)