GEN

GEN Agent Chat API

Conversational AI agent interface. All endpoints use base URL `https://agent.gen.pro/v1`.

GitHub OpenAPI

Operations 40

PUT /agents/{agent_id} Create, update, or remove assistants and their profiles — set name #
POST /agent/run Start an agent run #
GET /agent/runs/{run_id} Get agent run status #
POST /agent/runs/{run_id}/approve Approve or reject a pending agent action #
POST /agent/runs/{run_id}/stop Stop a run and return its queued messages #
GET /agent/conversations List conversations #
GET /agent/conversations/{id} Get a conversation #
GET /agent/conversations/{id}/pending Read the queued messages behind a run #
PATCH /agent/conversations/{id}/pending/{pending_id} Promote a queued message into the live run #
DELETE /agent/conversations/{id}/pending/{pending_id} Cancel a queued message #
GET /agent/conversations/{id}/session-preferences Get session preferences #
PATCH /agent/conversations/{id}/session-preferences Update session preferences #
POST /ideas/{idea_id}/expand Expand an idea into a project manifest #
GET /agent/ideas List content ideas #
PUT /agent/ideas/{id}/status/{status} Set idea status explicitly #
DELETE /agents/{agent_id}/core Create, update, or remove assistants and their profiles — reset agent profile #
PATCH /agents/{agent_id}/recurring-jobs Manage recurring jobs and monitoring tasks — update recurring job #
DELETE /agents/{agent_id}/recurring-jobs Manage recurring jobs and monitoring tasks — delete recurring job #
GET /agent/ideas/{idea_id} Discover — idea #
POST /agents/{agent_id}/core/complete-profile Create, update, or remove assistants and their profiles — complete profile #
POST /agents/{agent_id}/core/linked-accounts Create, update, or remove assistants and their profiles — add agent account #
DELETE /agents/{agent_id}/core/linked-accounts/{linked_account_id} Create, update, or remove assistants and their profiles — remove linked account #
POST /agents/{agent_id}/core/reference-images Create, update, or remove assistants and their profiles — add agent look #
DELETE /agents/{agent_id}/core/reference-images Create, update, or remove assistants and their profiles — add agent look #
GET /agents/{agent_id}/monitoring/effective Discover — monitoring #
POST /agents/{agent_id}/recurring-jobs/{job_id}/duplicate Manage recurring jobs and monitoring tasks — duplicate recurring job #
POST /agents/{agent_id}/recurring-jobs/{job_id}/test-run Manage recurring jobs and monitoring tasks — run recurring job now #
POST /analyze/clip_moments Analyze social trends, comments, hooks, and creators — clip moments #
GET /analyze/jobs/{job_id} Analyze social trends, comments, hooks, and creators — comment mining #
POST /analyze/research Analyze social trends, comments, hooks, and creators — comment mining #
POST /analyze/synthesis Analyze social trends, comments, hooks, and creators — comment mining #
POST /analyze/trends Analyze social trends, comments, hooks, and creators — comment mining #
GET /ideas/directions Discover — directions #
POST /ideas/generate Manage content resources and content ideas — generate ideas #
GET /ideas/jobs/{job_id} Discover — idea job #
POST /ideas/preferences Manage content resources and content ideas — set content preference #
DELETE /ideas/preferences Manage content resources and content ideas — remove content preference #
POST /ideas/recreate Manage content resources and content ideas — recreate video #
POST /ideas/reimagine Manage content resources and content ideas — reimagine video #
POST /ideas/{idea_id}/create-video Manage content resources and content ideas — create video from idea #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/gen-pro/openapi/gen-pro-agent-chat-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/gen-pro/json-schema/gen-pro-conversation-schema.json
📊
JSONSchema
https://artifacts.apis.io/gen-pro/json-schema/gen-pro-idea-schema.json
📊
JSONSchema
https://artifacts.apis.io/gen-pro/json-schema/gen-pro-automation-action-target-schema.json
📊
JSONSchema
https://artifacts.apis.io/gen-pro/json-schema/gen-pro-recurring-job-delivery-preferences-schema.json

Other Resources

🔗
APIsJSON
https://artifacts.apis.io/gen-pro/apis.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/gen-pro:gen-pro-agent-chat-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

gen-pro-agent-chat-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Auto Content Engine Agent Chat API
  description: 'The GEN Auto Content Engine API takes a raw idea all the way to a published video — agent setup, idea research, vidsheet production, layer composition, render, and publish.


    ## The 5-step journey


    Every operation belongs to one phase of a 5-step user journey. Each operation carries an `x-phase` extension you can filter on:


    | Phase | Meaning |

    |-------|---------|

    | `setup` | Step 1 — Set Up Your Agent (identity, voice, personality, API keys, workspaces) |

    | `ideas` | Step 2 — Generate Content Ideas (trending data, research, refinement, preferences) |

    | `convert` | Step 3 — Convert Idea to Vidsheet (clone template or build custom engine) |

    | `edit` | Step 4 — Edit & Generate (cells, layers, creation cards, trigger + poll) |

    | `export` | Step 5 — Export & Publish (render, download, publish to social) |


    Full journey-oriented docs: https://api.gen.pro


    ## Authentication


    All endpoints require authentication via one of:


    - **API Key** (recommended): Pass your API key in the `X-API-Key` header. Create keys on the agent''s API page in the GEN dashboard.

    - **JWT**: Pass a Bearer JWT in the `Authorization: Bearer ` header.


    ## Base URLs


    ```

    https://api.gen.pro/v1 — agent setup, vidsheets, generations, renders, publishing

    https://agent.gen.pro/v1 — content ideas, research, conversations, chat

    https://agent-core.gen.pro/v1 — agent core (brand profile, watchlists, scheduled tasks)

    https://python.gen.pro — social publishing integration (connect, schedule, remove posts)

    ```


    Each operation carries its own `servers` entry, so a generated client or a

    hand-written call goes to the backend that serves the route.


    ## Credits


    All `/v1/vidsheet/` endpoints require an active GEN credit balance.

    If your organization has no usable credits, requests return `422` with error code `usable_gen_credit_required`.


    Credits can be funded with x402 by calling `POST /v1/x402_credit_purchase`

    with `workspace_id` plus `amount_usd` or `credits`. If `network` is omitted,

    GEN returns every configured payment option in `payment_methods` and

    `payment_required.accepts`; show the Sui, Solana, and Base options to the

    user or calling agent and sign one selected accept entry. Workspace funding

    wallets are backend settlement infrastructure; the user-facing payment

    choices are the returned payment methods.'
  version: 1.0.0
  contact:
    name: GEN Support
    url: https://gen.pro
  license:
    name: Proprietary
servers:
- url: https://api.gen.pro/v1
  description: Auto Content Engine API
- url: https://agent.gen.pro/v1
  description: Agent Chat API
- url: https://agent-core.gen.pro/v1
  description: Agent Core API (watchlists)
- url: https://python.gen.pro
  description: Publishing integration API (social connect and scheduling)
security:
- apiKey: []
- bearerAuth: []
tags:


# --- truncated at 32 KB (83 KB total) ---
# Full source: https://artifacts.apis.io/gen-pro/openapi/gen-pro-agent-chat-api-openapi.yml