---
title: "Set connection credentials"
method: POST
path: "/admin/connections/{id}/credentials"
tags: ["admin"]
---

# Set connection credentials

`POST /admin/connections/{id}/credentials`

Sets or rotates the credentials for a Connection. The accepted payload
depends on the provider's strategy and auth method. Returns the refreshed
connection metadata (never the credentials themselves).

## Path parameters

- `id` string, required

## Request body

- object

## Response `200`

connection is a single connection response.

- Connection — Wraps Connection with the provider snippet (so tenant UIs don't have to re-resolve the catalog) and the extracted identity at the top level.
  - `auth_method` string
  - `created_at` string, date-time
  - `display_name` string
  - `id` string, uuid
  - `identity` object
  - `metadata` object
  - `provider` ProviderView
    - `display_name` string
    - `id` string
    - `logo_url` string
  - `status` string
  - `tenant_id` string, uuid
  - `updated_at` string, date-time

## Other responses

- `400` — errorGeneric wraps the error model as a response.
- `404` — errorGeneric wraps the error model as a response.
- `500` — errorGeneric wraps the error model as a response.

---

[API](https://skmtc.net/hintoric/apis/contains-the-generated-openapi-specification-for-hekate.md) · [All operations](https://skmtc.net/hintoric/apis/contains-the-generated-openapi-specification-for-hekate/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hintoric/contains-the-generated-openapi-specification-for-hekate/versions/72bd83b55019/schema)