> ## Documentation Index > Fetch the complete documentation index at: https://docs.meum.io/llms.txt > Use this file to discover all available pages before exploring further. # Update webhook endpoint > Managed (integration-owned) webhooks cannot be modified via this API. ## OpenAPI ````yaml /openapi.yaml patch /v1/webhook-endpoints/{id} openapi: 3.1.0 info: title: Meum Public Merchant API version: 1.0.0 description: > Public merchant API for programmatic payment management: invoices, transactions, payment links, webhooks, and WooCommerce integration. Authenticate with a store-scoped API key (`sk_live_*`) via Bearer token. Base URL: https://api.meum.io contact: name: Meum Support email: support@meum.io url: https://meum.io servers: - url: https://api.meum.io description: Production security: - bearerAuth: [] tags: - name: Health description: Service health checks - name: Invoices description: Invoice lifecycle - name: Transactions description: On-chain payment transactions - name: Payment Links description: Reusable payment link management - name: Webhooks description: Webhook endpoint and delivery management - name: Integrations description: Third-party platform integrations paths: /v1/webhook-endpoints/{id}: patch: tags: - Webhooks summary: Update webhook endpoint description: Managed (integration-owned) webhooks cannot be modified via this API. operationId: updateWebhookEndpoint parameters: - $ref: '#/components/parameters/WebhookEndpointId' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/UpdateWebhookEndpointRequest' responses: '200': description: Webhook endpoint updated content: application/json: schema: $ref: '#/components/schemas/WebhookEndpoint' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' '422': $ref: '#/components/responses/UnprocessableEntity' components: parameters: WebhookEndpointId: name: id in: path required: true description: Webhook endpoint public ID (`wh_...`). schema: type: string pattern: ^(inv_|txn_|plink_|wh_|whd_|evt_|int_)[0-9a-z]{20,32}$ schemas: UpdateWebhookEndpointRequest: type: object description: Partial update for a webhook endpoint. properties: name: type: string minLength: 1 description: Updated display name. url: type: string format: uri description: New destination URL for deliveries. events: type: array items: type: string description: Replace the list of subscribed event types. status: type: string enum: - ACTIVE - DISABLED description: Set to `DISABLED` to pause deliveries without deleting the endpoint. WebhookEndpoint: type: object description: Registered HTTPS endpoint that receives signed webhook events. properties: id: type: string pattern: ^(inv_|txn_|plink_|wh_|whd_|evt_|int_)[0-9a-z]{20,32}$ description: Webhook endpoint ID (`wh_...`). name: type: string description: Human-readable label in the merchant dashboard. example: Production webhook url: type: string format: uri description: HTTPS URL that receives POST requests for subscribed events. secret_prefix: type: string description: First characters of the signing secret (for identification only). example: a1b2c3d4 events: type: array items: type: string description: Event types this endpoint is subscribed to. example: - invoice.created - invoice.paid - invoice.expired - invoice.failed status: $ref: '#/components/schemas/WebhookEndpointStatus' managed: type: boolean description: >- True when owned by an integration (for example WooCommerce) and not fully editable in the dashboard. last_delivery_at: type: - string - 'null' format: date-time description: Timestamp of the most recent delivery attempt. last_delivery_status: type: - string - 'null' description: Outcome of the last delivery (for example `success`, `failed`). failure_count: type: integer description: >- Consecutive or recent failed delivery count, depending on endpoint policy. created_at: type: string format: date-time description: When the endpoint was registered. WebhookEndpointStatus: type: string description: | Webhook endpoint state: - `ACTIVE`: deliveries are sent - `DISABLED`: paused by merchant - `ARCHIVED`: permanently retired enum: - ACTIVE - DISABLED - ARCHIVED PublicApiError: type: object description: Standard error envelope for Public API v1 endpoints. required: - error properties: error: type: object description: Error details for the failed request. required: - type - code - message - request_id properties: type: type: string description: High-level error category used for programmatic handling. enum: - invalid_request - authentication_error - permission_error - not_found - conflict - rate_limit_error - api_error example: not_found code: type: string description: >- Stable machine-readable error code (for example `invoice_not_found`). example: invoice_not_found message: type: string description: Human-readable explanation suitable to show in logs or UI. example: Invoice not found param: type: string description: Request field associated with the error, when applicable. example: url request_id: type: string description: Unique request ID. Include when contacting support. example: req_a1b2c3d4e5f6789012345678 example: error: type: not_found code: invoice_not_found message: Invoice not found request_id: req_a1b2c3d4e5f6789012345678 responses: Forbidden: description: Insufficient scope or permission content: application/json: schema: $ref: '#/components/schemas/PublicApiError' NotFound: description: Resource not found content: application/json: schema: $ref: '#/components/schemas/PublicApiError' UnprocessableEntity: description: Validation failed content: application/json: schema: $ref: '#/components/schemas/PublicApiError' securitySchemes: bearerAuth: type: http scheme: bearer description: | Store-scoped API key. Prefix with `sk_live_`. Example: `Authorization: Bearer sk_live_EXAMPLE_DO_NOT_USE` ````