Update Application Credential

Partially updates an OAuth application credential. Only fields included in the request body are updated; omitted fields are left unchanged. Pass null to explicitly clear a field (e.g. client_secret or external_id).

Authentication

AuthorizationBearer

Token-based authentication with required prefix “Bearer”

Path parameters

idstringRequiredformat: "uuid"

ID of the application credential

Request

This endpoint expects an object.

client_idstringOptional<=255 characters

OAuth client ID

client_secretstring or nullOptional<=255 characters

OAuth client secret. Pass null to clear.

external_idstring or nullOptional

External identifier. Pass null to clear.

oauth2_scopes_overridestring or nullOptional<=2048 characters

Override for OAuth2 scopes

oauth2_user_scopes_overridestring or nullOptional<=2048 characters

Override for OAuth2 user scopes

oauth2_optional_scopes_overridestring or nullOptional<=2048 characters

Override for OAuth2 optional scopes

Response

idstringRead-onlyformat: "uuid"

Unique identifier for the application credential

connector_slugstringRead-only

Slug of the connector

client_idstringRead-only

OAuth client ID

created_atdatetimeRead-only

When the application credential was created

modified_atdatetimeRead-only

When the application credential was last modified

external_idstring or nullRead-only

External identifier for the application credential

oauth2_scopes_overridestring or nullRead-only

OAuth2 scopes override

oauth2_user_scopes_overridestring or nullRead-only

OAuth2 user scopes override

oauth2_optional_scopes_overridestring or nullRead-only

OAuth2 optional scopes override

1	import requests
2
3	url = "https://ah-api.merge.dev/api/v1/application-credentials/3c90c3c0-6d46-4b50-8888-8dd25736052f"
4
5	payload = {
6	"client_id": "new-client-id",
7	"client_secret": "new-secret"
8	}
9	headers = {
10	"Authorization": "Bearer <token>",
11	"Content-Type": "application/json"
12	}
13
14	response = requests.patch(url, json=payload, headers=headers)
15
16	print(response.json())

1	{
2	"id": "3c90c3c0-6d46-4b50-8888-8dd25736052f",
3	"connector_slug": "jira",
4	"client_id": "new-client-id",
5	"created_at": "2024-01-15T10:30:00Z",
6	"modified_at": "2024-01-16T08:00:00Z",
7	"external_id": "acme-corp"
8	}