---
title: "Publish my live agent to one approved directory now, or bring the entry up to date. The entry counts as published only after reading it back matched what was sent. Returns { ergebnis, status }; not_found while the directory is switched off."
method: POST
path: "/v1/me/agent/directories/{ziel}/publish"
tags: ["agents"]
---

# Publish my live agent to one approved directory now, or bring the entry up to date. The entry counts as published only after reading it back matched what was sent. Returns { ergebnis, status }; not_found while the directory is switched off.

`POST /v1/me/agent/directories/{ziel}/publish`

## Request

- Base URL: `https://meetmyagent.io`
- URL: `https://meetmyagent.io/v1/me/agent/directories/{ziel}/publish`
- Auth: HTTP bearer

## Path parameters

- `ziel` string, required

## 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)