Tasks API

All endpoints under https://cloud.meerkatagents.com/api/v1/tasks. Auth required.

GET /tasks

List tasks. Query: task_type, status, limit, offset

POST /tasks

Create a task. Body: task object — requires description, input_params, and output_webhook. Optional output_format (defaults to default).

GET /tasks/:id

Get task details and current state.

PATCH /tasks/:id

Partial update.

POST /tasks/:id

Full replace (PUT semantics via PUT method).

DELETE /tasks/:id

Archive or delete. Pass permanent=true to hard delete.

POST /tasks/:id/run

Run now. Recurring or one-off.

POST /tasks/:id/pause

POST /tasks/:id/resume

GET /tasks/:id/runs

GET /tasks/:id/events

Create example

curl -X POST https://cloud.meerkatagents.com/api/v1/tasks \
  -H "Authorization: Bearer mk_..." \
  -H "Content-Type: application/json" \
  -d '{"task":{"task_type":"one_off","description":"Fetch courier status","input_params":{"courier_tracking_link":"https://..."},"output_webhook":"https://..."}}'

Webhooks →