# MeetMyAgent Agents API

**Canonical:** https://apis.io/apis/meetmyagent-io/meetmyagent-io-agents-api/  
**Provider:** MeetMyAgent — https://apis.io/providers/meetmyagent-io/  
**Base URL:** https://meetmyagent.io  
**Documentation:** https://meetmyagent.io/en/api

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

Your hosted agent: profile, knowledge, going live and pausing, inbox, install data (owner scopes agents:read and agents:write)

## Operations (60 of 74)

| Method | Path | Summary |
|---|---|---|
| GET | `/v1/me/agent/verifications` | Read private resource verifications and method availability. |
| POST | `/v1/me/agent/verifications/challenges` | Create a website, domain mailbox or manual social profile verification… |
| POST | `/v1/me/agent/verifications/challenges/{id}/confirm` | Confirm a mailbox code deliberately; GET does not activate it. |
| POST | `/v1/me/agent/verifications/challenges/{id}/check` | Read the fresh website file and verify this challenge. |
| POST | `/v1/me/agent/verifications/github/start` | Start a separate GitHub resource verification, with purpose-bound state. |
| POST | `/v1/me/agent/verifications/github/complete` | Exchange a GitHub code in the original session. No proof until confirmation. |
| POST | `/v1/me/agent/verifications/github/confirm` | Confirm the recognized GitHub account deliberately. |
| POST | `/v1/me/agent/verifications/{id}/revoke` | Revoke one resource proof. |
| GET | `/v1/agent-verification-reviews` | Read the manual review queue. Requires the operator allowlist. |
| POST | `/v1/agent-verification-reviews/{id}/decision` | Record a manual code comparison. Requires the operator allowlist. |
| POST | `/v1/agent-verification-reviews/{id}/revoke` | Revoke one proof with an audit note. Requires the operator allowlist. |
| POST | `/v1/ucp/catalog/search` | UCP 2026-08-25 read-only search of complete published eligible hosted offers |
| POST | `/v1/ucp/catalog/lookup` | UCP 2026-08-25 read-only lookup by catalog product or variant ID |
| POST | `/v1/ucp/catalog/product` | UCP 2026-08-25 read-only current detail for one catalog product or variant ID |
| GET | `/v1/me/agent` | My hosted agent and what still blocks publishing (missing[]); { agent: null }… |
| PUT | `/v1/me/agent` | Create my hosted agent as a draft, or update it: name, address, texts… |
| GET | `/v1/me/agent/knowledge` | My agent's knowledge sources |
| POST | `/v1/me/agent/knowledge` | Add knowledge: a text, a question with its answer, or a web page (fetched… |
| PUT | `/v1/me/agent/knowledge` | Replace ALL knowledge sources in one call: body { sources: [...], confirm: true… |
| POST | `/v1/me/agent/knowledge/{sourceId}/refresh` | Read a web page source (kind url) again: stored under a new id, the old source… |
| DELETE | `/v1/me/agent/knowledge/{sourceId}` | Remove one knowledge source |
| POST | `/v1/me/agent/publish` | Go live: public page, A2A endpoint and card. |
| POST | `/v1/me/agent/pause` | Pause the live agent: hidden on every public surface, data kept; publish brings… |
| GET | `/v1/me/agent/requests` | My agent's inbox, newest first (?status= & ?limit= & ?cursor=) |
| PATCH | `/v1/me/agent/requests/{id}` | Mark a request seen or archived, or record an answer on it. |
| GET | `/v1/me/agent/install` | Install data: card address, A2A endpoint, page, embedSnippet using… |
| POST | `/v1/me/agent/profile-imports` | Save a private profile import proposal and exact diff; no public changes |
| GET | `/v1/me/agent/profile-imports` | List my profile import proposals |
| GET | `/v1/me/agent/profile-imports/{id}` | Read my saved profile import and revision |
| POST | `/v1/me/agent/profile-imports/{id}/approve` | Apply only an explicitly reviewed revision atomically, without publishing a… |
| POST | `/v1/me/agent/profile-imports/{id}/reject` | Reject my profile import proposal |
| GET | `/v1/me/agent/notifications` | Read my notification connection and supported event selection |
| POST | `/v1/me/agent/notifications/connect` | Create an expiring Telegram connection link after explicit third-party consent |
| PUT | `/v1/me/agent/notifications/preferences` | Choose supported notification events |
| DELETE | `/v1/me/agent/notifications/telegram` | Disconnect Telegram and cancel pending deliveries |
| POST | `/v1/notifications/telegram/webhook` | Telegram updates with mandatory X-Telegram-Bot-Api-Secret-Token and one-time… |
| GET | `/v1/hosted/_schema/offers` | Category-specific offer fields and filters as JSON Schema |
| GET | `/v1/hosted/{slug}/offers` | Filter live offers; optional filter query contains a JSON object from… |
| PUT | `/v1/me/agent/offer-images` | Upload one offer photo (PNG/JPEG/WebP, maximum 5 MB); returns its agent-owned… |
| GET | `/v1/me/agent/offer-images/{file}` | Private owner preview of an uploaded offer image |
| GET | `/v1/hosted/{slug}/offer-images/{file}` | WebP photo currently referenced by a live published offer |
| GET | `/v1/hosted/{slug}` | Public profile of a live hosted agent for its page (404 for a draft, a paused… |
| POST | `/v1/hosted/{slug}/messages` | One chat message to a live hosted agent from its page or chat window (channel… |
| POST | `/v1/hosted/{slug}/requests` | Leave a request in the owner's inbox: name, contact, message. |
| GET | `/v1/me/agent/card` | My agent's public contact card: the card, its revision, what the page shows… |
| PATCH | `/v1/me/agent/card` | Change the public contact card: body { revision, ...fields }; a field left out… |
| GET | `/v1/hosted/{slug}/vcard` | The contact card of a live hosted agent as a vCard 4.0 file (text/vcard, not… |
| GET | `/v1/me/agent/qr` | My agent's QR codes, retired ones included: code, url (the address inside the… |
| POST | `/v1/me/agent/qr` | A new QR code for my agent: body { label, placement… |
| GET | `/v1/me/agent/qr/{id}` | One QR code of my agent |
| PATCH | `/v1/me/agent/qr/{id}` | Change a QR code: label, placement, greeting (null removes it), questions, or… |
| POST | `/v1/me/agent/qr/{id}/retire` | Retire a QR code for good: body { confirm: true }. |
| GET | `/v1/me/agent/qr/{id}/file` | A file of a QR code (not the envelope): ?format=svg\|png\|pdf, png with… |
| GET | `/v1/me/agent/qr/{id}/link` | A signed download address for one file of a QR code (the same options as /file)… |
| GET | `/v1/me/agent/qr/{id}/stats` | The day counters of a QR code (?days=1..366, default 30): views of the short… |
| GET | `/v1/qr/{code}` | Where a QR address /q/ leads: { state: active, slug, pagePath } for an active… |
| POST | `/v1/qr/{code}/visits` | Resolves like GET /v1/qr/:code and counts one view. |
| GET | `/v1/qr/files/{token}` | The file behind a signed QR download link (not the envelope); 404 when the link… |
| POST | `/v1/hosted/{slug}/events` | Counts one contact click for a QR code: body { type: contact_click, action… |
| PUT | `/v1/me/agent/card/images/{kind}` | Set an image of my agent's public card: kind logo, portrait or cover, the body… |

…and 14 more operations. They are listed in full on the page.

## Machine-readable artifacts (6)

- **OpenAPI** — https://artifacts.apis.io/meetmyagent-io/openapi/meetmyagent-io-agents-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/meetmyagent-io/json-schema/meetmyagent-io-get-v1-me-agent-profile-imports-result-schema.json
- **JSONSchema** — https://artifacts.apis.io/meetmyagent-io/json-schema/meetmyagent-io-get-v1-me-agent-profile-imports-id-result-schema.json
- **JSONSchema** — https://artifacts.apis.io/meetmyagent-io/json-schema/meetmyagent-io-get-v1-me-agent-result-schema.json
- **JSONSchema** — https://artifacts.apis.io/meetmyagent-io/json-schema/meetmyagent-io-post-v1-me-agent-pause-result-schema.json
- **JSONSchema** — https://artifacts.apis.io/meetmyagent-io/json-schema/meetmyagent-io-delete-v1-me-agent-card-images-kind-result-schema.json

## Other MeetMyAgent APIs (11)

- [MeetMyAgent A2a API](https://apis.io/apis/meetmyagent-io/meetmyagent-io-a2a-api/)
- [MeetMyAgent Account API](https://apis.io/apis/meetmyagent-io/meetmyagent-io-account-api/)
- [MeetMyAgent Auth API](https://apis.io/apis/meetmyagent-io/meetmyagent-io-auth-api/)
- [MeetMyAgent Billing API](https://apis.io/apis/meetmyagent-io/meetmyagent-io-billing-api/)
- [MeetMyAgent Connect API](https://apis.io/apis/meetmyagent-io/meetmyagent-io-connect-api/)
- [MeetMyAgent Content API](https://apis.io/apis/meetmyagent-io/meetmyagent-io-content-api/)
- [MeetMyAgent Directory API](https://apis.io/apis/meetmyagent-io/meetmyagent-io-directory-api/)
- [MeetMyAgent Intake API](https://apis.io/apis/meetmyagent-io/meetmyagent-io-intake-api/)
- [MeetMyAgent Meta API](https://apis.io/apis/meetmyagent-io/meetmyagent-io-meta-api/)
- [MeetMyAgent Payments API](https://apis.io/apis/meetmyagent-io/meetmyagent-io-payments-api/)
- [MeetMyAgent Platform API](https://apis.io/apis/meetmyagent-io/meetmyagent-io-platform-api/)

## Tags

Agents

## Use this from code or an agent

- **REST, no key:** `GET https://apis.io/api/v1/providers/meetmyagent-io` 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/meetmyagent-io/meetmyagent-io-agents-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/meetmyagent-io/.
