# Mendly

Mendly is a home-services and events marketplace that turns a plain-language problem description into a matched, vetted professional. Instead of forms and dropdowns, you describe what is wrong ("my kitchen sink is leaking under the cabinet"), optionally attach a photo or video, and Mendly classifies the service type, urgency, and location, then matches a provider.

## Agent API

Mendly exposes a versioned, authenticated HTTP API so AI agents and integrations can submit service requests programmatically.

- Base URL: https://mendly.services/api/v1
- Authentication: Bearer token (API key). Request access at https://mendly.services/developers
- Create a request: POST /api/v1/agent/requests
- Check request status: GET /api/v1/agent/requests/{id}
- OpenAPI spec: https://mendly.services/api/v1/openapi.json

## Key endpoints

POST /api/v1/agent/requests
  Body: { "problem": "<natural language description>", "urgency"?: "low|medium|high|emergency", "hints"?: {...}, "media_refs"?: ["..."], "webhook_url"?: "..." }
  Headers: Authorization: Bearer <key>, Idempotency-Key: <optional>
  Returns: { request_id, job_draft_id, status, classified_service_type, classified_category, intent, urgency, confidence, agent_originated }

GET /api/v1/agent/requests/status?id={id}
  Headers: Authorization: Bearer <key>
  Returns: { request_id, status, job_status, workflow_state, provider_assigned, created_at, updated_at }

## Docs

Full developer documentation with example requests: https://mendly.services/developers