---
title: "Update Connection"
method: PUT
path: "/connections/{connection_id}"
tags: ["connections"]
---

# Update Connection

`PUT /connections/{connection_id}`

Updates a connections metadata or mode. These changes will be seen after the next sync.

## Path parameters

- `connection_id` string, uuid, required

## Request body

- ConnectionBase
  - `partition_strategy` union, required
    - 'hi_res' | 'fast' | 'agentic_ocr'
    - MediaModeParam
      - `static` 'hi_res' | 'fast' | 'agentic_ocr', nullable
      - `audio` boolean, nullable
      - `video` 'audio_only' | 'video_only' | 'audio_video', nullable
  - `metadata` object — Metadata for the document. Keys must be strings. Values may be strings, numbers, booleans, or lists of strings. Numbers may be integers or floating point and will be converted to 64 bit floating point. 1000 total values are allowed. Each item in an array counts towards the total. The following keys are reserved for internal use: `document_id`, `document_type`, `document_source`, `document_name`, `document_uploaded_at`, `start_time`, `end_time`, `chunk_content_type`.
  - `sync_filter` SyncFilter
  - `page_limit` integer, nullable — The maximum number of pages a connection will sync. The connection will be disabled after this limit is reached. Some in process documents may continue processing. Remove the limit by setting to `null`.

## Response `200`

Successful Response

- Connection
  - `id` string, uuid, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `metadata` object, required
  - `type` string, required
  - `name` string, required
  - `source` union, required
    - string
    - string[]
    - object
  - `enabled` boolean, required
  - `disabled_by_system_reason` 'connection_over_total_page_limit' | 'authentication_failed' | 'tenant_account_disabled', nullable, required
  - `last_synced_at` string, date-time, nullable
  - `syncing` boolean, nullable
  - `partition` string, nullable
  - `page_limit` integer, nullable, required
  - `sync_filter` SyncFilter, required
  - `disabled_by_system` boolean, required

## Other responses

- `401` — Unauthorized
- `402` — Payment Required
- `422` — Validation Error
- `429` — Too Many Requests
- `500` — Internal Server Error

---

[API](https://skmtc.dev/ragie/apis/ragie-api.md) · [All operations](https://skmtc.dev/ragie/apis/ragie-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ragie/ragie-api/revisions/ffdf960539ca/schema)