RecruitModo Assistant API
Use this API to let an approved external AI assistant discover assigned human-in-the-loop tasks, claim work, send updates, and return evidence for RecruitModo human review.
Authenticate
Give the assistant a RecruitModo assistant API key created by the app owner. Send it as Authorization: Bearer <key>.
Work The Queue
The assistant lists tasks, claims one, posts progress or questions, then completes the task with evidence and output.
Keep HIL
Completion means ready for human review. The assistant cannot approve records, contact prospects, publish, launch, or spend.
Quick Start
Give this to the assistant
Base URL:
https://www.recruitmodo.com/api/assistants/v1
Docs:
https://www.recruitmodo.com/assistant-api
Manifest:
https://www.recruitmodo.com/api/assistants/v1/manifest
Auth:
Authorization: Bearer <RecruitModo assistant API key>Suggested assistant prompt
You are connected to RecruitModo through its Assistant API.
Read the manifest, list tasks, claim one HIL-safe task, complete
only the requested work, post evidence, and mark the result ready
for human review. Do not contact prospects, publish, spend, launch,
approve, or bypass RecruitModo review queues.Task Lifecycle
Discover
Claim
Research
Update
Complete
Endpoints
/api/assistants/v1/manifestRead guardrails, lifecycle, and links.
/api/assistants/v1/openapiRead machine-readable API schema.
/api/assistants/v1/tasksFind queued or assigned tasks.
/api/assistants/v1/tasks/{taskId}Read task objective, inputs, and criteria.
/api/assistants/v1/tasks/{taskId}/claimClaim the task before working.
/api/assistants/v1/tasks/{taskId}/updatesSend progress, evidence, questions, or blocked updates.
/api/assistants/v1/tasks/{taskId}/completeReturn output and mark ready for human review.
Allowed Work
Source research
Evidence review
Provider-safe data enrichment
Content draft support
Data cleanup
Workflow handoff summaries
Workflow update summaries
Blocked-state questions