# needhuman-ai API

**Canonical:** https://apis.io/apis/needhuman-ai/needhuman-ai-api/  
**Provider:** needhuman-ai — https://apis.io/providers/needhuman-ai/  
**Documentation:** https://needhuman.ai/llms-full.txt

needhuman-ai API is one of 2 APIs that [needhuman-ai](https://apis.io/providers/needhuman-ai/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

needhuman-ai API as documented publicly: 6 operations. Contract generated from the documentation by API Evangelist (2026-10-30); not the provider's own document.

## Operations (6)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/v1/health` | Health check. No auth required. |
| POST | `/api/v1/keys/register` | POST /api/v1/keys/register |
| GET | `/api/v1/setup` | GET /api/v1/setup |
| GET | `/api/v1/tasks` | List all tasks for your API key, newest first. |
| POST | `/api/v1/tasks` | POST /api/v1/tasks |
| PATCH | `/api/v1/tasks/{taskId}` | Update a task (admin only). Used to record results and change status. |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/needhuman-ai/openapi/_ae-authored/needhuman-ai-openapi-generated.yml
- **JSONSchema** — https://artifacts.apis.io/needhuman-ai/json-schema/needhuman-ai-patch-api-v1-tasks-taskid-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/needhuman-ai/json-schema/needhuman-ai-patch-api-v1-tasks-taskid-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/needhuman-ai/json-schema/needhuman-ai-post-api-v1-tasks-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/needhuman-ai/json-schema/needhuman-ai-get-api-v1-health-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/needhuman-ai/json-schema/needhuman-ai-post-api-v1-keys-register-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/needhuman-ai/json-schema/needhuman-ai-get-api-v1-tasks-response-schema.json

## Other needhuman-ai APIs (1)

- [NeedHuman AI API](https://apis.io/apis/needhuman-ai/needhuman-ai-api-2/)

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/needhuman-ai/needhuman-ai-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/needhuman-ai/.