API reference
Create Job
POST /jobs · Jobs
POSThttps://api.clawifi.dev/jobs
- Send your key as
Authorization: Bearer $CLAWIFI_API_KEY; see Authentication. - Add
"dry_run": true(or?dry_run=true) to see what the call would cost; nothing runs and nothing is charged. - Hosted MCP tool:
create_jobonhttps://api.clawifi.dev/mcp. - Credits: see Pricing and credits.
Request#
curl -X POST https://api.clawifi.dev/jobs \
-H "Authorization: Bearer $CLAWIFI_API_KEY" \
-H "Content-Type: application/json" \
-d '{"operation":"fetch"}'
from clawifi import Clawifi
client = Clawifi() # reads CLAWIFI_API_KEY
result = client.create_job("fetch", {"url": "https://example.com"})
create_job(operation="fetch")
Body
| Field | Type | Default | Required |
|---|---|---|---|
operation | string (one of 10 values; see Sources) | yes | |
payload | object | no |
Response#
200 with a JobResponse object: created_at, error, job_id, operation, progress, result, status, updated_at.
Errors use the shared shape; see Errors. Try public operations without a key in the playground.
Was this page helpful? Tell us · Last updated 2026-10-22