Events and webhooks
DELETE /v1/webhook-endpoints/{endpointId}
Disable a webhook endpoint
| Availability | Private Preview |
|---|---|
| Method and path | DELETE /v1/webhook-endpoints/{endpointId} |
| API version | 1.0.0-private-preview |
| Base URL | https://api.torq.finance |
| Authentication | SecretKey |
| Idempotency | Not declared by this operation. |
| Rate limits | Read x-ratelimit-* and x-request-id response headers. Do not hard-code a quota. |
Authentication requirements
SecretKey
Request examples
curl -X DELETE 'https://api.torq.finance/v1/webhook-endpoints/sample_endpointid' \ -H 'Accept: application/json' \ -H 'Authorization: Bearer $TORQ_SECRET_KEY'
Run a safe sample
This calls the docs preview and returns sample data shaped by the governed OpenAPI response. It never accepts credentials or changes protocol state.
Run the sample call to inspect a schema-shaped response without credentials or side effects.| Request body | None. |
|---|
Parameters
| Name | In | Required | Type |
|---|---|---|---|
endpointId | path | Yes | string |
Responses
| Status | Meaning | Schema |
|---|---|---|
204 | Endpoint disabled | None. |
400 | Invalid request | TorqApiError |
401 | Authentication required | TorqApiError |
403 | Insufficient scope or authority | TorqApiError |
409 | State or idempotency conflict | TorqApiError |
429 | Rate limit exceeded | TorqApiError |
500 | Internal failure | TorqApiError |
400, 401, 403, 409, 429, 500 response schema
TorqApiError TorqApiError
| Property | Type | Required | Description |
|---|---|---|---|
ok | boolean | Yes | — |
code | string | Yes | — |
message | string | Yes | — |
requestId | string | Yes | — |
retryable | boolean | Yes | — |
blockedReason | string | null | No | — |
docsUrl | string (uri) | No | — |
Inspect nested properties
ok boolean · required
code string · required
minimum length: 1 · maximum length: 200
message string · required
minimum length: 1 · maximum length: 200
requestId string · required
minimum length: 1 · maximum length: 200
retryable boolean · required
blockedReason string | null · optional
nullable
docsUrl string (uri) · optional
Related guides
- Authentication and scopes
- Errors, idempotency, and rate limits
- Canonical state and final completion
- SDK reference
For retry behavior and blocked-state handling, see Errors and rate limits.