---
title: "Associate Credential To Connector"
method: PUT
path: "/manage/connector/{connector_id}/credential/{credential_id}"
tags: ["public"]
---

# Associate Credential To Connector

`PUT /manage/connector/{connector_id}/credential/{credential_id}`

## Request

- Base URL: `https://cloud.onyx.app/api`
- URL: `https://cloud.onyx.app/api/manage/connector/{connector_id}/credential/{credential_id}`
- Auth: HTTP bearer

NOTE(rkuo): internally discussed and the consensus is this endpoint
and create_connector_with_mock_credential should be combined.

The intent of this endpoint is to handle connectors that actually need credentials.

## Path parameters

- `connector_id` integer, required
- `credential_id` integer, required

## Request body

- ConnectorCredentialPairMetadata
  - `name` string, nullable
  - `access_type` 'public' | 'private' | 'sync', required
  - `auto_sync_options` object, nullable
  - `groups` integer[]

## Response `200`

Successful Response

- StatusResponseInt
  - `success` boolean, required
  - `message` string, nullable
  - `data` integer, nullable

## Other responses

- `422`: Validation Error

## Changes

- **2026-09-02** `fcb09658bc37`: 2 info
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status
- **2026-01-06** `2d941ea53eb3`: 2 info
  - api tag `public` added
  - the response property `success` became required for the status `200`
- **2025-08-21** `9321c45d93b5`: 1 breaking, 1 info
  - the response property `success` became optional for the status `200`
  - api tag `public` removed

[Operation history](https://skmtc.dev/onyx-dot-app/apis/onyx-api/changes/manage/connector/:connector_id/credential/:credential_id/put.md)

---

[API](https://skmtc.dev/onyx-dot-app/apis/onyx-api.md) - [All operations](https://skmtc.dev/onyx-dot-app/apis/onyx-api/llms.txt) - [OpenAPI document](https://skmtc.dev/onyx-dot-app/apis/onyx-api/revisions/fcb09658bc37?raw)