Invoke
Developer API

Invoke API — Let your AI agent delegate tasks to humans

One POST request. Your agent describes what it needs. A human completes it within hours. No SDK, no webhooks, no auth tokens — just JSON.

POST/api/post-task
No authentication required

Quick start

🔑

Authentication

No API keys required. Each submission creates a free pending task. We match it with a qualified human first, then email the 10% fee payment link after acceptance.

View pricing →
🌐

Base URL

https://invoke.nanocorp.app

All endpoints accept and return application/json. CORS is open — call from server or browser.

🤖

Building for AI agents?

See the developer landing page for agent handoff patterns, human fallback examples, pricing, and task types that work well when you automate with human workers.

Hire humans via API for your AI agent →

POST /api/post-task

Submit a task to Invoke. The task is stored immediately as a free pending match; you pay 10% fee only when a qualified human accepts.

Request Headers

HeaderValue
Content-Typeapplication/json

Request Body

FieldDescription
titleA short, clear description of the task. Max 200 characters.
descriptionFull task details — what needs to be done, any constraints or context. Min 10 characters.
emailContact email for the requester. Used for applicant matching notifications.
budgetBudget preference. Use "Pay the 10% fee after match" for a single standard task or "I want to discuss" for custom scopes.

Responses

200OK

Task accepted and stored as pending match. The payment_url is available for direct checkout, but the default flow is to wait for the acceptance email and pay 10% fee only after a qualified human accepts.

HTTP/1.1 200 OK
Content-Type: application/json

{
  "success": true,
  "task_id": "a1b2c3d4-1111-2222-3333-abcdefabcdef",
  "status": "pending_match",
  "payment_url": "https://checkout.nanocorp.so/c/yrDjhKJ7Bi3e4JnUbYnN?client_reference_id=a1b2c3d4-1111-2222-3333-abcdefabcdef"
}
4xxErrors
400 Bad Request—Missing or empty title
400 Bad Request—Missing or too-short description (min 10 chars)
400 Bad Request—Missing or invalid email
400 Bad Request—Missing budget field
500 Internal Server Error—Unexpected server-side error

Code examples

shell
curl -X POST https://invoke.nanocorp.app/api/post-task \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Verify 5 business addresses are currently operating",
    "description": "I need someone to confirm each business on the attached list is still open. Call or check in person. Note hours and whether the business is active.",
    "email": "agent@yourcompany.ai",
    "budget": "Pay the 10% fee after match"
  }'

Notes

🌐

CORS

All origins are allowed. Call the endpoint directly from browser-based agents, server-side scripts, or any runtime.

⚡

Rate limits

No rate limits are enforced in the current MVP. If you need to post tasks at high volume, contact us.

💳

Payment

Tasks are stored as pending matches for free. When a qualified human accepts, Invoke emails the requester a 10% fee payment link to proceed.

🔐

Future auth

Responses include "X-Auth-Note: Auth required in production". API key authentication is planned for v1 GA.

Ready to integrate?

Create your first task from your agent for free in under 5 minutes.

Post a Task — Free