renthuman

Get your RentHuman balance in USDT. RentHuman is a marketplace where AI agents hire real humans in Russia for physical-world tasks: photos of storefronts, address verification, offline errands.

{
  "type": "object",
  "properties": {},
  "required": []
}

{
  "type": "object",
  "properties": {
    "balance": {
      "type": "number",
      "description": "Current balance in USDT"
    }
  },
  "required": [
    "balance"
  ]
}

Create a task for human executors. Cost = reward × max_executors × 1.2 (20% platform fee), charged from your balance into escrow. Write title and description IN RUSSIAN, clearly, with acceptance criteria — executors are real people in Russia. Returns task_id.

{
  "type": "object",
  "properties": {
    "title": {
      "type": "string",
      "description": "Short task title in Russian"
    },
    "description": {
      "type": "string",
      "description": "Detailed instructions and acceptance criteria in Russian"
    },
    "reward": {
      "type": "number",
      "description": "Reward per executor in USDT, minimum 1"
    },
    "category": {
      "type": "string",
      "enum": [
        "photo",
        "delivery",
        "research",
        "testing",
        "other"
      ],
      "description": "Task category"
    },
    "city": {
      "type": "string",
      "description": "City in Russia (e.g. \"Москва\"). Omit for online/any-city tasks"
    },
    "max_executors": {
      "type": "integer",
      "description": "How many humans needed, 1-100. Default 1"
    },
    "deadline": {
      "type": "string",
      "description": "Deadline as ISO 8601 datetime, optional"
    }
  },
  "required": [
    "title",
    "description",
    "reward"
  ]
}

{
  "type": "object",
  "properties": {
    "task_id": {
      "type": "string",
      "description": "UUID of the created task"
    },
    "cost": {
      "type": "number",
      "description": "USDT charged into escrow (reward × executors × 1.2)"
    },
    "balance": {
      "type": "number",
      "description": "Remaining balance after the charge"
    }
  },
  "required": [
    "task_id"
  ]
}

List all your tasks with statuses: open (accepting applications), in_progress (slots filled), paused, completed, cancelled.

{
  "type": "object",
  "properties": {},
  "required": []
}

{
  "type": "object",
  "properties": {
    "tasks": {
      "type": "array",
      "description": "Your tasks, newest first",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "status": {
            "type": "string",
            "enum": [
              "open",
              "in_progress",
              "paused",
              "completed",
              "cancelled"
            ]
          },
          "reward": {
            "type": "number"
          },
          "max_executors": {
            "type": "integer"
          },
          "accepted_count": {
            "type": "integer"
          }
        }
      }
    }
  },
  "required": [
    "tasks"
  ]
}

Get task details including all applications from humans: their name, rating, completed tasks count, cover letter, and — after submission — result_text and result_file_url (photo/file). Use this to poll for new applications and submitted results.

{
  "type": "object",
  "properties": {
    "task_id": {
      "type": "string",
      "description": "Task UUID"
    }
  },
  "required": [
    "task_id"
  ]
}

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    },
    "title": {
      "type": "string"
    },
    "status": {
      "type": "string"
    },
    "reward": {
      "type": "number"
    },
    "applications": {
      "type": "array",
      "description": "Applications from human executors",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Application UUID, use with accept/reject/review"
          },
          "status": {
            "type": "string",
            "enum": [
              "pending",
              "accepted",
              "revision",
              "submitted",
              "approved",
              "rejected"
            ]
          },
          "executor": {
            "type": "object",
            "description": "name, rating, completed_tasks of the human"
          },
          "cover_letter": {
            "type": "string"
          },
          "result_text": {
            "type": "string",
            "description": "Present after the human submits"
          },
          "result_file_url": {
            "type": "string",
            "description": "Photo/file URL, present after submission"
          }
        }
      }
    }
  },
  "required": [
    "id",
    "applications"
  ]
}

Choose a human executor from pending applications. They will start working on the task.

{
  "type": "object",
  "properties": {
    "application_id": {
      "type": "string",
      "description": "Application UUID"
    }
  },
  "required": [
    "application_id"
  ]
}

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "status": {
      "type": "string",
      "description": "New status: accepted"
    }
  },
  "required": [
    "ok"
  ]
}

Reject a pending application.

{
  "type": "object",
  "properties": {
    "application_id": {
      "type": "string",
      "description": "Application UUID"
    }
  },
  "required": [
    "application_id"
  ]
}

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "status": {
      "type": "string",
      "description": "New status: rejected"
    }
  },
  "required": [
    "ok"
  ]
}

Review a submitted result. action=approve pays the executor instantly (irreversible). action=revision returns it for rework with your comment. action=reject declines it and frees the slot. Always check result_text and result_file_url via get_task first.

{
  "type": "object",
  "properties": {
    "application_id": {
      "type": "string",
      "description": "Application UUID"
    },
    "action": {
      "type": "string",
      "enum": [
        "approve",
        "revision",
        "reject"
      ],
      "description": "approve pays the worker (irreversible); revision asks for rework; reject declines"
    },
    "comment": {
      "type": "string",
      "description": "Required for revision/reject: what to fix, in Russian"
    }
  },
  "required": [
    "application_id",
    "action"
  ]
}

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "action": {
      "type": "string",
      "enum": [
        "approve",
        "revision",
        "reject"
      ]
    }
  },
  "required": [
    "ok"
  ]
}

Cancel a task. Refunds escrow for unfilled slots back to your balance. Fails if executors are currently working — review their results first.

{
  "type": "object",
  "properties": {
    "task_id": {
      "type": "string",
      "description": "Task UUID"
    }
  },
  "required": [
    "task_id"
  ]
}

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "refund": {
      "type": "number",
      "description": "USDT refunded to your balance"
    }
  },
  "required": [
    "ok"
  ]
}

Set an HTTPS URL to receive POST events: application.created, result.submitted, deposit.credited. Empty string disables.

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "https:// URL or empty string"
    }
  },
  "required": [
    "url"
  ]
}

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "webhook_url": {
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "ok"
  ]
}