Conditionally update endpoint or event scopes.

Read as Markdown

PATCH /api/v1/webhook-subscriptions/{subscriptionId}

Conditionally update endpoint or event scopes.

Access

Use a credential with commentary.webhooks.write.

Provider access, workspace membership, and agent grants are enforced separately. A token does not expand access to a repository or resource. Set up developer access.

Parameters

Name	Location	Type	Required	Description
subscriptionId	path	string	Yes
If-Match	header	string	Yes
X-Commentary-Workspace-Id	header	string	No	Must match the credential workspace. This header cannot widen grant authority.
X-Correlation-Id	header	string	No

Request body

Required. Supported content types: application/json.

Field	Type	Required	Description
endpointUrl	string	No	Format: uri.
eventTypes	array of "interaction.created.v1" · "interaction.updated.v1" · "interaction.revision.created.v1" · "interaction.decision.recorded.v1" · "interaction.fulfillment.updated.v1" · "interaction.terminal.v1" · "interaction.content_purged.v1"	No

Call the endpoint

Replace path placeholders and your credential. For body operations, create request.json using the required fields above; this command does not invent resource identifiers or consent.

curl --request PATCH \
  'https://commentary.dev/api/v1/webhook-subscriptions/<subscriptionId>' \
  --header 'Authorization: Bearer <your-token>' \
  --header 'Content-Type: application/json' \
  --data-binary @request.json

Responses

Status	Meaning	Payload
200	Successful response.	object
400	The request was invalid.	ExternalError
401	Authentication is required.	ExternalError
403	The token or session does not have permission for this resource.	ExternalError
404	The resource was not found.	ExternalError
412	The ETag is stale.	See response headers or body contract
428	If-Match is required.	See response headers or body contract
429	The request was rate limited.	ExternalError

Successful response fields

Value type: object.

Recover from errors

Use the returned status and error body. Correct invalid fields before retrying; reconnect or narrow the target for authentication and permission errors. For conditional writes, reload the latest version before preparing a new request. Respect rate-limit headers and retry only when the operation’s idempotency contract permits it.

Contract and related guidance

Operation ID: updateWebhookSubscription. Download the OpenAPI contract for complete constraints and code generation. Browse endpoints.