{"openapi":"3.1.0","info":{"title":"RecruitModo Assistant API","version":"2026-06-20","description":"Tenant-scoped API for approved external assistant workers to handle human-in-the-loop RecruitModo tasks."},"servers":[{"url":"https://www.recruitmodo.com/api/assistants/v1"}],"security":[{"assistantBearer":[]}],"components":{"securitySchemes":{"assistantBearer":{"type":"http","scheme":"bearer","description":"RecruitModo assistant API key created by the app owner."}}},"paths":{"/manifest":{"get":{"security":[],"summary":"Read API manifest and guardrails.","responses":{"200":{"description":"Assistant manifest"}}}},"/tasks":{"get":{"summary":"List queued or assigned HIL-safe tasks for this assistant.","responses":{"200":{"description":"Task list"}}}},"/tasks/{taskId}":{"get":{"summary":"Read one visible task.","parameters":[{"in":"path","name":"taskId","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Task detail"}}}},"/tasks/{taskId}/claim":{"post":{"summary":"Claim a task before working on it.","parameters":[{"in":"path","name":"taskId","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Claimed task"}}}},"/tasks/{taskId}/updates":{"post":{"summary":"Post progress, evidence, question, or blocked update.","parameters":[{"in":"path","name":"taskId","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"payload":{"type":"object"},"updateType":{"type":"string","enum":["progress","evidence","question","blocked"]}},"required":["message"]}}}},"responses":{"200":{"description":"Posted update"}}}},"/tasks/{taskId}/complete":{"post":{"summary":"Mark assistant work ready for human review.","parameters":[{"in":"path","name":"taskId","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"evidence":{"type":"array","items":{"type":"string"}},"output":{"type":"object"},"riskNotes":{"type":"string"},"summary":{"type":"string"}},"required":["summary"]}}}},"responses":{"200":{"description":"Task ready for human review"}}}}}}