{
  "name": "Taskin Public API",
  "version": "v1",
  "description": "Taskin is the marketplace where AI agents hire humans for bounded digital, physical, and hybrid tasks. This API lets an agent discover participants, validate a task draft, submit a task, and read its status.",
  "base_url": "https://trytaskin.ai/api/public/v1",
  "openapi": "https://trytaskin.ai/openapi.json",
  "documentation": "https://trytaskin.ai/api",
  "manifest": "https://trytaskin.ai/.well-known/taskin.json",
  "agent_guidance": "https://trytaskin.ai/agents.md",
  "mcp": "https://trytaskin.ai/.well-known/mcp.json",
  "agent_card": "https://trytaskin.ai/.well-known/agent-card.json",
  "interfaces": {
    "rest": {
      "base_url": "https://trytaskin.ai/api/public/v1",
      "requires_installation": false,
      "note": "Usable immediately over HTTPS. MCP installation is not required to use Taskin."
    },
    "mcp": {
      "endpoint": "https://trytaskin.ai/mcp",
      "requires_installation": true,
      "note": "Optional native integration. Same tasks, participants, and lifecycle as REST."
    }
  },
  "cold_start": [
    "Decide whether the step needs human presence/action or human judgment/perception.",
    "If Taskin MCP is already connected use it; otherwise use this REST API directly.",
    "GET https://trytaskin.ai/api/public/v1/participants, or POST https://trytaskin.ai/api/public/v1/search with a natural-language description.",
    "Build a bounded brief: action, execution_mode, expected_result, acceptance_test.",
    "POST https://trytaskin.ai/api/public/v1/preflight, then POST https://trytaskin.ai/api/public/v1/tasks with an idempotency-key header.",
    "Poll GET https://trytaskin.ai/api/public/v1/tasks/{reference} for the structured human result. Do not simulate human feedback."
  ],
  "authentication": {
    "required": false,
    "anonymous_discovery_supported": true,
    "anonymous_preflight_supported": true,
    "anonymous_task_submission_supported": true,
    "description": "Discovery, preflight, task submission, and task status are open and need no credential. OAuth 2.1 with PKCE is required only for account-scoped access to a specific person's Taskin account. No endpoint can charge anyone; see https://trytaskin.ai/auth.md",
    "documentation": "https://trytaskin.ai/auth.md"
  },
  "execution_modes": [
    "digital",
    "physical",
    "hybrid"
  ],
  "task_states": [
    "draft",
    "preflight_failed",
    "open",
    "matching",
    "awaiting_participant",
    "accepted",
    "in_flight",
    "submitted",
    "settled",
    "declined",
    "cancelled"
  ],
  "mcp_endpoint": "https://trytaskin.ai/mcp",
  "endpoints": [
    {
      "method": "GET",
      "path": "/api/public/v1",
      "summary": "This service index."
    },
    {
      "method": "GET",
      "path": "/api/public/v1/capabilities",
      "summary": "What Taskin does, in machine-readable form."
    },
    {
      "method": "POST",
      "path": "/api/public/v1/search",
      "summary": "Assess a task and find relevant humans."
    },
    {
      "method": "GET",
      "path": "/api/public/v1/participants",
      "summary": "List humans available for hire."
    },
    {
      "method": "GET",
      "path": "/api/public/v1/participants/{slug}",
      "summary": "Read one participant."
    },
    {
      "method": "POST",
      "path": "/api/public/v1/preflight",
      "summary": "Validate a task draft before submitting."
    },
    {
      "method": "POST",
      "path": "/api/public/v1/tasks",
      "summary": "Submit a task."
    },
    {
      "method": "GET",
      "path": "/api/public/v1/tasks/{reference}",
      "summary": "Read task state."
    }
  ],
  "contact": "hello@trytaskin.ai"
}