---
title: API catalog — Human For AI
description: Markdown twin of the RFC 9727 api-catalog at /.well-known/api-catalog: every machine-readable API surface of humanforai.dev in one list.
canonical: https://humanforai.dev/.well-known/api-catalog
last-updated: 2026-09-06
---

# API catalog

This is the markdown twin of https://humanforai.dev/.well-known/api-catalog, an RFC 9727 linkset (`application/linkset+json`) listing every API surface this domain publishes. Fetch the JSON for machine use; read this for orientation.

## APIs

| API | Base | Description | Documentation |
|-----|------|-------------|---------------|
| REST API v1 | https://humanforai.dev/api/v1 | Submit human tasks, poll status, message the operator. No authentication; free during the pilot. | https://humanforai.dev/openapi.json (OpenAPI 3.0.3) · https://humanforai.dev/api.md |
| MCP server | https://humanforai.dev/mcp | Streamable HTTP, stateless, POST only. Tools: get_human_services, submit_human_task, check_task_status, message_human_operator, check_message_thread, reply_in_message_thread. | https://humanforai.dev/.well-known/mcp · https://humanforai.dev/.well-known/mcp/server-card.json |
| Agent manifest | https://humanforai.dev/.well-known/agent.json | Platform self-description: interfaces, task types, response expectations, pricing, trust policy, roadmap. | https://humanforai.dev/for-agents.md |
| Agent card (A2A) | https://humanforai.dev/.well-known/agent-card.json | A2A-style agent card for the human operator. | https://humanforai.dev/for-agents.md |

## Related discovery files

- https://humanforai.dev/.well-known/capabilities.json — structured capabilities per service
- https://humanforai.dev/.well-known/services.json — the service catalog
- https://humanforai.dev/.well-known/human.json — the operator record
- https://humanforai.dev/.well-known/agent-skills/index.json — Agent Skills index (skill: hire-a-human, /skill.md)
- https://humanforai.dev/.well-known/ard.json — Agent Resource Directory catalog
- https://humanforai.dev/.well-known/jwks.json — public key for signed deliverable receipts
- https://humanforai.dev/llms.txt — curated summary for language models

## Conventions

- Every API response carries `RateLimit-Policy`, `RateLimit-Limit`, `RateLimit-Remaining`, and `RateLimit-Reset` (draft-ietf-httpapi-ratelimit-headers); 429s carry `Retry-After`.
- Errors are JSON: `{ "error": "<machine_code>", "message": "<human text>" }`.
- `POST /api/v1/tasks` and `POST /api/v1/messages` accept an `Idempotency-Key` header.
- Every HTML page has a markdown twin at the same path plus `.md`; the homepage also honors `Accept: text/markdown`.