Cancel a running Clado deep research job via MPP micropayment on Tempo L2.
What it does
This endpoint cancels an in-progress deep research job on the Clado people-search and LinkedIn enrichment platform. It is part of a broader Clado API suite exposed through the Locus MPP (Micropayment Protocol) gateway, which settles payments on Tempo L2 using pathUSD (6 decimals). The cancel endpoint accepts a POST request with the `jobId` of the deep research task you want to stop.
The per-call cost is 3,000 base units of pathUSD, which equals $0.003 (three tenths of a cent). Payment is handled automatically via the MPP 402 challenge-response flow — callers receive a 402 with payment instructions, settle on Tempo, and replay the request with proof of payment. The endpoint is part of a family of Clado endpoints including search, deep research initiation, status polling, requesting more results, LinkedIn profile scraping, contact enrichment, post-reaction retrieval, and bulk contact operations.
Note that the probe returned 404 on HEAD and GET methods for this specific path; however, the OpenAPI spec declares it as a POST endpoint, so the 404 is expected for non-POST methods. No response schema is documented, so the exact shape of a successful cancellation response is unknown. Documentation references point to https://docs.clado.ai and https://beta.paywithlocus.com/mpp/clado.md for further details.
Capabilities
Use cases
- —Cancelling a deep research job that is no longer needed to avoid accumulating per-result charges
- —Programmatically managing deep research workflows by stopping jobs that have returned sufficient results
- —Cleaning up orphaned or erroneously started deep research tasks
Fit
Best for
- —Agents orchestrating multi-step lead generation pipelines that need job lifecycle control
- —Automated workflows that conditionally cancel research based on intermediate results
- —Cost management when deep research jobs exceed budget thresholds
Not for
- —Standalone people search — use the /clado/search or /clado/deep-research endpoints instead
- —Retrieving research results — use /clado/deep-research-status for that
Quick start
curl -X POST https://clado.mpp.paywithlocus.com/clado/deep-research-cancel \
-H "Content-Type: application/json" \
-d '{"jobId": "your-deep-research-job-id"}'Example
Request
{
"jobId": "dr_abc123def456"
}Endpoint
Quality
OpenAPI schema is present with clear request body and pricing metadata, but no response schema is documented, the probe returned 404 (expected for non-POST but no 402 was captured on POST), and crawled pages yielded no additional documentation. The endpoint's behavior must be inferred from the spec alone.
Warnings
- —No 402 challenge was captured — the probe only tried HEAD and GET, but the endpoint is POST-only. Liveness via MPP challenge is unconfirmed.
- —No response schema documented; the shape of a successful cancellation response is unknown.
- —External docs at https://docs.clado.ai and https://beta.paywithlocus.com/mpp/clado.md were not crawled and could not be verified.
Citations
- —The cancel endpoint costs 3000 base units of pathUSD per call (method: tempo, intent: charge).https://clado.mpp.paywithlocus.com
- —The endpoint accepts a POST with a required jobId field.https://clado.mpp.paywithlocus.com
- —Clado is described as 'People search, LinkedIn enrichment, and deep research for lead generation.'https://clado.mpp.paywithlocus.com
- —API reference docs are listed at https://docs.clado.ai.https://clado.mpp.paywithlocus.com