> ## Documentation Index > Fetch the complete documentation index at: https://docs.checkfu.com/llms.txt > Use this file to discover all available pages before exploring further. # Delete an MCP event subscription > Fence the subscription under a new generation, so no in-flight subscribe or renewal can reactivate it, then call events/unsubscribe with the original… ## OpenAPI ````yaml /openapi.json delete /v1/automations/{id}/mcp-event-subscriptions/{subscriptionId} openapi: 3.1.0 info: title: Checkfu API version: '2026-08-31' description: >- Authentication is declared per operation: API-key, runtime, or connector bearer; Automation signature; bootstrap poll token; or anonymous bootstrap creation and credential-free pairing redemption. Every general Checkfu REST request requires the dated `Checkfu-Version` header (one of: 2026-08-31); the three MCP JSON-RPC transports use `MCP-Protocol-Version`, A2A uses `A2A-Version`, and the provider OAuth callback carries neither Checkfu header. API keys resolve one Workspace without a request selector; authenticated responses identify it with `Checkfu-Workspace-Id`. servers: - url: https://api.checkfu.com security: - bearerAuth: [] tags: - name: organizations - name: sourceRepositories - name: tenants - name: workspaces - name: principals - name: principalGroups - name: principalAccessCredentials - name: apiKeys - name: agents - name: harnesses - name: harnessRuntime - name: permissionAssignments - name: actionPolicies - name: files - name: memoryStores - name: dreams - name: modelCredentials - name: modelRoutingProfiles - name: blueprintInstallations - name: toolSources - name: skills - name: skillSources - name: agentBlueprints - name: skillProposals - name: instructionProposals - name: catalog - name: managedTools - name: concepts - name: support - name: bootstrapRequests - name: connections - name: connectionVaults - name: connectionAssignments - name: connectedRuntimes - name: fileTrees - name: collaboration - name: automationGraphs - name: automations - name: actionApprovals - name: standingApprovals - name: workloadReviewPolicies - name: usage - name: models - name: outcomes - name: budgets - name: billing - name: sessions - name: audit - name: sessionExports - name: runs - name: runnerPools - name: transcripts - name: sessionWatches - name: sessionHandoffs - name: sessionCapsules - name: sessionTrajectories - name: webhookEndpoints - name: integrationGateway - name: workEnvironments - name: computers - name: computerScreens - name: computerBrowserObservations - name: computerBrowserActions - name: environments - name: computerHeadlessOperations - name: vaults - name: apiMcp - name: a2a paths: /v1/automations/{id}/mcp-event-subscriptions/{subscriptionId}: delete: tags: - automations summary: Delete an MCP event subscription description: >- Fence the subscription under a new generation, so no in-flight subscribe or renewal can reactivate it, then call `events/unsubscribe` with the original event name, arguments and callback URL. A definitive answer settles `deleted`, shreds the signing key and leaves the callback route answering gone; an unknown outcome stays `deleting` and maintenance retries it. Accepts an optional Idempotency-Key. Checkfu support posture: alpha; hosted. Required evidence journey: automation-firing. Deployment-specific readiness and the latest proven release are available from GET /v1/support/capabilities. operationId: automations.deleteMcpEventSubscription parameters: - name: id in: path schema: $ref: '#/components/schemas/AutomationId' required: true - name: subscriptionId in: path schema: $ref: '#/components/schemas/McpEventSubscriptionId' required: true - name: checkfu-version in: header schema: type: string enum: - '2026-08-31' required: true - name: idempotency-key in: header schema: type: string allOf: - maxLength: 255 required: false responses: '200': description: >- One inbound MCP Events webhook subscription for an Automation WebhookSource: the durable intent, its last-known remote lease and readiness. The callback route and signing key are platform-owned and never returned; a read shows last-known lease evidence, not live remote health. content: application/json: schema: $ref: '#/components/schemas/McpEventSubscription_1' headers: checkfu-workspace-id: description: The Workspace resolved from the authenticated bearer credential. required: true schema: $ref: '#/components/schemas/WorkspaceId' '400': description: Typed Checkfu wire error content: application/json: schema: $ref: '#/components/schemas/ValidationMalformedError' '401': description: Typed Checkfu wire error content: application/json: schema: type: object required: - error properties: error: type: object required: - type - message - more properties: type: type: string enum: - auth.invalid_key message: type: string more: type: string enum: - >- https://docs.checkfu.com/reference/errors#auth-invalid-key description: >- Stable public documentation and remedy for this error type. additionalProperties: false additionalProperties: false '403': description: >- The organization, tenant, or workspace backing this key is administratively disabled. | Deployment governance or retention policy denied the request. content: application/json: schema: anyOf: - type: object required: - error properties: error: type: object properties: type: type: string enum: - auth.disabled_tenancy message: type: string more: type: string enum: - >- https://docs.checkfu.com/reference/errors#auth-disabled-tenancy description: >- Stable public documentation and remedy for this error type. required: - type - message - more additionalProperties: false additionalProperties: false - $ref: '#/components/schemas/PolicyDeniedError' '404': description: >- The requested resource does not exist in the resolved deployment boundary. content: application/json: schema: $ref: '#/components/schemas/ValidationNotFoundError' '409': description: >- The request conflicts with the resource's current state. | An idempotent mutation conflicts with a completed or in-progress request for the same key. content: application/json: schema: anyOf: - $ref: '#/components/schemas/ValidationConflictError' - $ref: '#/components/schemas/IdempotencyConflictError' '429': description: Typed Checkfu wire error headers: retry-after: description: >- Delay in seconds for rate limits or deployment quotas with a known release or UTC reset boundary required: false schema: type: integer minimum: 1 content: application/json: schema: type: object required: - error properties: error: type: object required: - type - message - more properties: type: type: string enum: - budget.exceeded message: type: string more: type: string enum: - >- https://docs.checkfu.com/reference/errors#budget-exceeded description: >- Stable public documentation and remedy for this error type. additionalProperties: false additionalProperties: false '500': description: >- An unexpected internal failure occurred; the message contains an opaque incident reference. content: application/json: schema: $ref: '#/components/schemas/RuntimeInternalError' '503': description: >- The provider webhook host is unreachable, so provider catalogs and hook lifecycle calls cannot be served right now. content: application/json: schema: $ref: '#/components/schemas/RuntimeProviderHostUnavailableError' security: - bearerAuth: [] components: schemas: AutomationId: type: string pattern: ^auto_[0-9a-f]{32}$ McpEventSubscriptionId: type: string pattern: ^mevsub_[0-9a-f]{32}$ McpEventSubscription_1: type: object properties: id: $ref: '#/components/schemas/McpEventSubscriptionId' workspace_id: $ref: '#/components/schemas/WorkspaceId' automation_id: $ref: '#/components/schemas/AutomationId' webhook_source_id: $ref: '#/components/schemas/WebhookSourceId' connection_id: $ref: '#/components/schemas/ConnectionId' connection_version: type: integer allOf: - exclusiveMinimum: 0 - maximum: 9007199254740991 event_name: $ref: '#/components/schemas/McpEventName' arguments: $ref: '#/components/schemas/McpEventArguments' identity_digest: type: string pattern: ^sha256:[0-9a-f]{64}$ descriptor_digest: type: string pattern: ^sha256:[0-9a-f]{64}$ status: $ref: '#/components/schemas/McpEventSubscriptionStatus' readiness: $ref: '#/components/schemas/McpEventSubscriptionReadiness' lease: $ref: '#/components/schemas/Union_303' last_verified_at: anyOf: - $ref: '#/components/schemas/CurrentTimestamp' - type: 'null' last_error: $ref: '#/components/schemas/Union_304' version: type: integer allOf: - exclusiveMinimum: 0 - maximum: 9007199254740991 created_at: $ref: '#/components/schemas/CurrentTimestamp' updated_at: $ref: '#/components/schemas/CurrentTimestamp' required: - id - workspace_id - automation_id - webhook_source_id - connection_id - connection_version - event_name - arguments - identity_digest - descriptor_digest - status - readiness - lease - last_verified_at - last_error - version - created_at - updated_at additionalProperties: false description: >- One inbound MCP Events webhook subscription for an Automation WebhookSource: the durable intent, its last-known remote lease and readiness. The callback route and signing key are platform-owned and never returned; a read shows last-known lease evidence, not live remote health. WorkspaceId: type: string pattern: ^wrkspc_[0-9a-f]{32}$ ValidationMalformedError: type: object properties: error: type: object properties: type: type: string enum: - validation.malformed message: type: string more: type: string enum: - https://docs.checkfu.com/reference/errors#validation-malformed description: Stable public documentation and remedy for this error type. required: - type - message - more additionalProperties: false required: - error additionalProperties: false description: >- The request could not be decoded or violated a declared input constraint. PolicyDeniedError: type: object properties: error: type: object properties: type: type: string enum: - policy.denied message: type: string more: type: string enum: - https://docs.checkfu.com/reference/errors#policy-denied description: Stable public documentation and remedy for this error type. required: - type - message - more additionalProperties: false required: - error additionalProperties: false description: Deployment governance or retention policy denied the request. ValidationNotFoundError: type: object properties: error: type: object properties: type: type: string enum: - validation.not_found message: type: string more: type: string enum: - https://docs.checkfu.com/reference/errors#validation-not-found description: Stable public documentation and remedy for this error type. required: - type - message - more additionalProperties: false required: - error additionalProperties: false description: >- The requested resource does not exist in the resolved deployment boundary. ValidationConflictError: type: object properties: error: type: object properties: type: type: string enum: - validation.conflict message: type: string more: type: string enum: - https://docs.checkfu.com/reference/errors#validation-conflict description: Stable public documentation and remedy for this error type. required: - type - message - more additionalProperties: false required: - error additionalProperties: false description: The request conflicts with the resource's current state. IdempotencyConflictError: anyOf: - $ref: '#/components/schemas/ValidationIdempotencyConflictError' - $ref: '#/components/schemas/ValidationIdempotencyInProgressError' description: >- An idempotent mutation conflicts with a completed or in-progress request for the same key. RuntimeInternalError: type: object properties: error: type: object properties: type: type: string enum: - runtime.internal message: type: string more: type: string enum: - https://docs.checkfu.com/reference/errors#runtime-internal description: Stable public documentation and remedy for this error type. required: - type - message - more additionalProperties: false required: - error additionalProperties: false description: >- An unexpected internal failure occurred; the message contains an opaque incident reference. RuntimeProviderHostUnavailableError: type: object properties: error: type: object properties: type: type: string enum: - runtime.provider_host_unavailable message: type: string more: type: string enum: - >- https://docs.checkfu.com/reference/errors#runtime-provider-host-unavailable description: Stable public documentation and remedy for this error type. required: - type - message - more additionalProperties: false required: - error additionalProperties: false description: >- The provider webhook host is unreachable, so provider catalogs and hook lifecycle calls cannot be served right now. WebhookSourceId: type: string pattern: ^whsrc_[0-9a-f]{32}$ ConnectionId: type: string pattern: ^conn_[0-9a-f]{32}$ McpEventName: type: string allOf: - minLength: 1 - maxLength: 256 description: The exact upstream MCP event name, compared byte for byte. McpEventArguments: type: object additionalProperties: description: >- A value in the JSON data model: null, boolean, finite number, string, array, or object. allOf: - x-checkfu-json-budget: maximumBytes: 16384 maximumDepth: 16 maximumNodes: 1024 maximumInspectionWork: 4096 x-checkfu-unicode-scalar-values: true allOf: - x-checkfu-json-budget: maximumBytes: 16384 maximumDepth: 16 maximumNodes: 1024 maximumInspectionWork: 4096 x-checkfu-unicode-scalar-values: true - maxProperties: 1024 description: >- Secret-free MCP event subscription arguments of at most 16384 UTF-8 bytes, validated against the selected event's inputSchema. They are publicly readable and must not contain credentials. McpEventSubscriptionStatus: type: string enum: - pending - active - degraded - expired - revoked - failed - deleting - deleted McpEventSubscriptionReadiness: type: string enum: - awaiting_verification - active - renewal_degraded - lease_too_short - expired - revoked - needs_reconnection - subscribe_failed - cleanup_pending - deleted Union_303: anyOf: - $ref: '#/components/schemas/McpEventSubscriptionLease' - type: 'null' CurrentTimestamp: type: string allOf: - maxLength: 24 - pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$ description: A canonical UTC ISO-8601 timestamp with millisecond precision. Union_304: anyOf: - $ref: '#/components/schemas/McpEventSubscriptionError' - type: 'null' ValidationIdempotencyConflictError: type: object properties: error: type: object properties: type: type: string enum: - validation.idempotency_conflict message: type: string more: type: string enum: - >- https://docs.checkfu.com/reference/errors#validation-idempotency-conflict description: Stable public documentation and remedy for this error type. required: - type - message - more additionalProperties: false required: - error additionalProperties: false description: The Idempotency-Key is already bound to a different request. ValidationIdempotencyInProgressError: type: object properties: error: type: object properties: type: type: string enum: - validation.idempotency_in_progress message: type: string more: type: string enum: - >- https://docs.checkfu.com/reference/errors#validation-idempotency-in-progress description: Stable public documentation and remedy for this error type. required: - type - message - more additionalProperties: false required: - error additionalProperties: false description: >- An identical idempotent request is still in progress and may be retried later. McpEventSubscriptionLease: type: object properties: remote_subscription_id: type: string allOf: - minLength: 1 - maxLength: 256 expires_at: anyOf: - $ref: '#/components/schemas/CurrentTimestamp' - type: 'null' renew_at: anyOf: - $ref: '#/components/schemas/CurrentTimestamp' - type: 'null' last_renewed_at: $ref: '#/components/schemas/CurrentTimestamp' replay: type: string enum: - none - cursor history_gap: type: boolean required: - remote_subscription_id - expires_at - renew_at - last_renewed_at - replay - history_gap additionalProperties: false McpEventSubscriptionError: type: object properties: code: type: string pattern: ^[a-z0-9](?:[a-z0-9._-]{0,93})$ at: $ref: '#/components/schemas/CurrentTimestamp' required: - code - at additionalProperties: false securitySchemes: bearerAuth: type: http scheme: bearer ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.