# Pairoa Needs API

**Canonical:** https://apis.io/apis/pairoa-com/pairoa-com-needs-api/  
**Provider:** Pairoa — https://apis.io/providers/pairoa-com/  
**Base URL:** https://pairoa.com  
**Documentation:** https://pairoa.com/api

Pairoa Needs API is one of 4 APIs that [Pairoa](https://apis.io/providers/pairoa-com/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 4 JSON Schema definitions. Tagged areas include Needs. The published artifact set on APIs.io includes an OpenAPI specification and 4 JSON Schemas.

The Needs API from Pairoa — 2 operation(s) for needs.

## Operations (5)

| Method | Path | Summary |
|---|---|---|
| POST | `/api/needs` | Publish a need |
| GET | `/api/needs` | List the caller's needs |
| GET | `/api/needs/{id}` | Get current state of a need |
| PATCH | `/api/needs/{id}` | Edit a need (i_seek / i_offer / safe_tags) |
| DELETE | `/api/needs/{id}` | Close a need — deletes its raw text and embedding (content already shared in a… |

## Machine-readable artifacts (5)

- **OpenAPI** — https://artifacts.apis.io/pairoa-com/openapi/pairoa-com-needs-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/pairoa-com/json-schema/pairoa-com-publish-need-result-schema.json
- **JSONSchema** — https://artifacts.apis.io/pairoa-com/json-schema/pairoa-com-publish-need-input-schema.json
- **JSONSchema** — https://artifacts.apis.io/pairoa-com/json-schema/pairoa-com-need-summary-schema.json
- **JSONSchema** — https://artifacts.apis.io/pairoa-com/json-schema/pairoa-com-need-status-schema.json

## Other Pairoa APIs (3)

- [Pairoa Auth API](https://apis.io/apis/pairoa-com/pairoa-com-auth-api/)
- [Pairoa Contact API](https://apis.io/apis/pairoa-com/pairoa-com-contact-api/)
- [Pairoa Matches API](https://apis.io/apis/pairoa-com/pairoa-com-matches-api/)

## Tags

Needs

## Use this from code or an agent

- **REST, no key:** `GET https://apis.io/api/v1/providers/pairoa-com` returns the provider's full profile as JSON.
- **MCP:** `https://apis.io/mcp` (Streamable HTTP) — search the catalog, read any provider, compare providers, check agent readiness.
- **Free API key** for catalog-wide search, ratings and comparisons: sign in with GitHub, Google or LinkedIn at https://apis.io/developer/account/ (plans: https://apis.io/developer/plans/).

---

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