---
title: "Add knowledge: a text, a question with its answer, or a web page (fetched behind the SSRF guard; pages behind a login are refused). Body up to 128 KB."
method: POST
path: "/v1/me/agent/knowledge"
tags: ["agents"]
---

# Add knowledge: a text, a question with its answer, or a web page (fetched behind the SSRF guard; pages behind a login are refused). Body up to 128 KB.

`POST /v1/me/agent/knowledge`

## Request

- Base URL: `https://meetmyagent.io`
- URL: `https://meetmyagent.io/v1/me/agent/knowledge`
- Auth: HTTP bearer

Supports the `Idempotency-Key` header: identical retries return the first result; a reused key with a different payload fails with `idempotency_key_reused`.

## Request body

- object

## Response `2XX`

Success envelope; `result` shape per endpoint (see the TypeScript SDK types).

- Envelope
  - `success` true, required
  - `result` unknown, required
  - `errors` EnvelopeError[], required
    - `code` integer, required: Stable numeric code (never reused).
    - `slug` 'auth_required' | 'invalid_token' | 'insufficient_scope' | 'principal_not_verified' | 'invalid_credentials' | 'email_taken' | 'magic_link_invalid' | 'magic_link_throttled' | 'password_too_weak' | 'api_key_not_found' | 'scope_not_grantable' | 'oauth_invalid_client' | 'oauth_invalid_grant' | 'oauth_invalid_request' | 'oauth_redirect_mismatch' | 'oauth_request_not_found' | 'social_provider_unavailable' | 'social_email_unverified' | 'invalid_request' | 'not_found' | 'idempotency_key_reused' | 'conflict' | 'rate_limited' | 'agent_not_found' | 'principal_not_found' | 'setting_not_found' | 'setting_invalid_value' | 'setting_scope_not_allowed' | 'blog_post_not_found' | 'blog_slug_conflict' | 'token_consumed' | 'confirmation_token_invalid' | 'confirmation_token_expired' | 'confirmation_text_changed' | 'hosted_agent_not_found' | 'agent_slug_taken' | 'agent_slug_invalid' | 'agent_not_ready' | 'agent_content_rejected' | 'knowledge_limit_reached' | 'knowledge_source_not_found' | 'knowledge_fetch_failed' | 'knowledge_login_wall' | 'agent_request_not_found' | 'agent_slug_locked' | 'external_agent_not_found' | 'agent_card_unreachable' | 'agent_card_invalid' | 'agent_card_signature_invalid' | 'agent_domain_not_verified' | 'external_agent_forbidden' | 'directory_entry_not_found' | 'remote_agent_failed' | 'billing_not_configured' | 'already_subscribed' | 'billing_customer_missing' | 'billing_confirmation_required' | 'plan_limit_reached' | 'assistant_limit_reached' | 'internal' | 'not_implemented', required: Stable string code, branch on this.
    - `message` string, required
    - `documentation_url` string, uri, required
  - `messages` string[], required
  - `result_info` object: Present on paginated lists.
    - `cursor` string, nullable: Opaque cursor for the next page; null when exhausted.
    - `count` integer
    - `per_page` integer
  - `links` object[]: Next-action links on a single-resource response, chain by following `rel`, never by rebuilding the URL.
    - `rel` string, required: Stable relation name (self, plus the actions the resource offers).
    - `href` string, uri, required
    - `method` 'GET' | 'POST' | 'PATCH' | 'DELETE', required
    - `title` string
  - `request_id` string, required: Echoes X-Request-Id; quote it in support requests.

## Other responses

- `default`: Failure envelope with stable error codes (see /v1 index → errors documentation).

---

[API](https://skmtc.dev/meetmyagent/apis/meetmyagent-api.md) · [All operations](https://skmtc.dev/meetmyagent/apis/meetmyagent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/meetmyagent/apis/meetmyagent-api/revisions/8dbd67566ff6?raw)