---
title: "Update Integration Auth"
method: PATCH
path: "/v1/integrations/{integrationId}/auth/{authId}"
tags: ["Integration Auth"]
---

# Update Integration Auth

`PATCH /v1/integrations/{integrationId}/auth/{authId}`

Partially updates an existing auth record by authId. Only fields provided in the request body are updated — omitted fields remain unchanged. Returns the updated auth record.

## Path parameters

- `integrationId` string, required
- `authId` string, required

## Request body

- UpdateIntegrationAuthRequest — Request body to partially update an existing authentication credential record. Only fields included in the request body are updated — omitted fields are left unchanged. The authType set at creation time is permanent and cannot be changed via this endpoint. Provide only the credential fields that match the original authType.
  - `token` string — Replacement bearer token. Applicable only when the auth record was originally created with authType BEARER_TOKEN. Overwrites the previously stored token. The system will use this new value on all subsequent outbound requests. Omit this field to leave the existing token unchanged.
  - `username` string — Replacement username for Basic authentication. Applicable only when the auth record was originally created with authType BASIC_AUTH. Can be updated independently — omitting this field leaves the existing username unchanged.
  - `password` string — Replacement password for Basic authentication. Applicable only when the auth record was originally created with authType BASIC_AUTH. Can be updated independently — omitting this field leaves the existing password unchanged.
  - `apiKey` ApiKeyRequest — Defines how an API key is attached to outgoing requests. Use this when the API requires a key in headers or query parameters.
    - `key` string, required — Name of the header or query parameter that carries the API key. Must match what the target API expects.
    - `value` string, required — The API key or secret value sent with each request.
    - `position` 'header' | 'query', required — Where the API key should be added in the request. header → sent as an HTTP header (most common). query → appended to the request URL.
  - `headers` HeaderEntry[] — Replacement list of static headers attached to every outbound request for this auth record. Pass a non-empty list to overwrite all existing headers with the new set. Pass an empty list [] to remove all headers. Omit this field entirely to leave existing headers unchanged.
    - `key` string, required — HTTP header name exactly as expected by the target API.
    - `value` string, required — Static value for this header sent with every request. Must be a fixed string — use queryParams or bodyParams for dynamic values.

## Response `200`

OK

- IntegrationAuthResponse
  - `authId` string — Unique identifier for the auth record
  - `integrationId` string — Unique identifier of the parent integration
  - `authType` 'NO_AUTH' | 'BASIC_AUTH' | 'BEARER_TOKEN' | 'API_KEY' — The authentication strategy this credential set uses. Determines which credential fields are required: API_KEY — provide the apiKey object (key name, secret value, and position). BEARER_TOKEN — provide the token field. BASIC_AUTH — provide username and password fields. NO_AUTH — no credential fields required.
  - `headers` object — Optional list of static HTTP headers attached to every outbound request under this auth. Applied on top of any headers defined at the integration or tool level. Useful for fixed metadata headers required by the third-party API.
  - `createdAt` string, date-time — Timestamp when the record was created
  - `updatedAt` string, date-time — Timestamp when the record was last updated

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `500` — Internal Server Error

---

[API](https://skmtc.net/sigmamind/apis/sigmamind-apis.md) · [All operations](https://skmtc.net/sigmamind/apis/sigmamind-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sigmamind/sigmamind-apis/versions/d00f52b5123f/schema)