Replace integration authentication credentials

put

https://api.lingohub.com/v2/integration-authentications/{integrationAuthenticationId}/credentials

Replaces the complete manual credentials through the existing writer of the provider. provider must be the authentication's stored provider (422 on provider otherwise). Git hosts store them without a remote check; content systems validate them first. Preserves public identity, name, lifecycle and connected projects; OAuth or installation authentications return 409. No synchronization is queued. Credentials are write-only: use getIntegrationAuthentication for the If-Match validator. Requires workspace-level integration management permission.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

integrationAuthenticationId

string

required

^iau_[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$

Public id composed of the resource type prefix and its UUID.

Body Params

Request body to replace the access token of a manual authentication. Azure DevOps and Bitbucket store it without a remote check; Contentful, HubSpot and Stripo validate it with the provider first.

provider

string

enum

required

Selects this shape of the body.

Allowed:

access_token

string

required

length between 0 and 8192

Write-only provider access token; never returned.

Headers

If-Match

string

Optional precondition. Send the quoted ETag from a GET of this resource. The mutation only runs if a strong tag matches the current representation, checked under the write lock. A comma-separated list is allowed; '*' requires an existing representation. Weak tags never match. Omit this header for an unconditional write. For an action, use the ETag from GET of the target resource, without the action suffix. A stale tag returns 412; read the current state before retrying.

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

Language

Credentials

Bearer

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

application/problem+json

200Credential-free metadata. GET the authentication for its current ETag.

400The request is malformed: an unknown or invalid query parameter, an invalid id in the path, or a body that is not valid JSON. code names the problem, errors the parameter or field.

401Invalid or missing API key.

403Insufficient permissions.

404The resource does not exist, or the API key cannot see it.

409conflict: only manually provisioned credentials can be replaced.

412The current representation does not match If-Match (precondition_failed). No change was applied.

422The request is well-formed, but values are invalid; errors points at each of them.

429The API rate limit was exceeded. Wait for the number of seconds given in the Retry-After header, then retry.

500An unexpected internal server error occurred.

503The service is temporarily unavailable. Retry after the number of seconds in the Retry-After header.