---
title: "Update Credential Sharing Endpoint"
method: PUT
path: "/manage/admin/credential/{credential_id}/sharing"
tags: ["public"]
---

# Update Credential Sharing Endpoint

`PUT /manage/admin/credential/{credential_id}/sharing`

## Request

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

Changes who may reuse a saved credential. Only its owner may do this, so
a credential with no owner keeps its sharing. ``name`` changes the name
when set.

## Path parameters

- `credential_id` integer, required

## Request body

- CredentialSharing: Who may reuse a credential: ``CredentialBase``'s sharing fields. ``admin_public`` shares with every admin (global MANAGE_CONNECTORS). ``groups`` (EE) shares with the users who hold Manage Connectors in one of the groups: its managers, and members who hold the permission globally. ``curator_public`` is kept for older clients and grants nothing.
  - `admin_public` boolean
  - `curator_public` boolean
  - `groups` integer[]
  - `name` string, nullable

## Response `200`

Successful Response

- CredentialSnapshot
  - `credential_json` object, required
  - `admin_public` boolean, required
  - `source` 'ingestion_api' | 'slack' | 'web' | 'google_drive' | 'gmail' | 'github' | 'gitbook' | 'gitlab' | 'guru' | 'bookstack' | 'outline' | 'confluence' | 'jira' | 'slab' | 'productboard' | 'file' | 'coda' | 'canvas' | 'notion' | 'zulip' | 'linear' | 'hubspot' | 'document360' | 'gong' | 'google_sites' | 'zendesk' | 'loopio' | 'box' | 'dropbox' | 'sharepoint' | 'onedrive' | 'teams' | 'outlook' | 'salesforce' | 'discourse' | 'axero' | 'clickup' | 'mediawiki' | 'wikipedia' | 'asana' | 's3' | 'r2' | 'google_cloud_storage' | 'oci_storage' | 'xenforo' | 'not_applicable' | 'discord' | 'freshdesk' | 'fireflies' | 'zoom' | 'egnyte' | 'airtable' | 'highspot' | 'drupal_wiki' | 'imap' | 'bitbucket' | 'testrail' | 'braintrust' | 'lumapps' | 'youtrack' | 'mock_connector' | 'user_file' | 'craft_file', required
  - `name` string, nullable
  - `curator_public` boolean
  - `groups` integer[]
  - `id` integer, required
  - `user_id` string, uuid, nullable, required
  - `user_email` string, nullable
  - `user_personal_name` string, nullable
  - `time_created` string, date-time, required
  - `time_updated` string, date-time, required
  - `is_owner` boolean, nullable

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-28** `76bc90bf55b6`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/onyx-dot-app/apis/onyx-api/changes/manage/admin/credential/:credential_id/sharing/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/76bc90bf55b6?raw)