# GEN Agent Chat API

**Canonical:** https://apis.io/apis/gen-pro/gen-pro-agent-chat-api/  
**Provider:** GEN — https://apis.io/providers/gen-pro/  
**Base URL:** https://api.gen.pro/v1  
**Documentation:** https://gen.pro/docs

GEN Agent Chat API is one of 27 APIs that [GEN](https://apis.io/providers/gen-pro/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 4 JSON Schema definitions. Tagged areas include Agent Chat. The published artifact set on APIs.io includes an OpenAPI specification and 4 JSON Schemas.

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

## Operations (40)

| Method | Path | Summary |
|---|---|---|
| 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 |

## Machine-readable artifacts (6)

- **OpenAPI** — https://artifacts.apis.io/gen-pro/openapi/gen-pro-agent-chat-api-openapi.yml
- **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
- **APIsJSON** — https://artifacts.apis.io/gen-pro/apis.yml

## Other GEN APIs (12)

- [GEN Agent Core API](https://apis.io/apis/gen-pro/gen-pro-agent-core-api/)
- [GEN Agent Profile API](https://apis.io/apis/gen-pro/gen-pro-agent-profile-api/)
- [GEN Agent Voice API](https://apis.io/apis/gen-pro/gen-pro-agent-voice-api/)
- [GEN Agents API](https://apis.io/apis/gen-pro/gen-pro-agents-api/)
- [GEN API Keys API](https://apis.io/apis/gen-pro/gen-pro-api-keys-api/)
- [GEN Asset Libraries API](https://apis.io/apis/gen-pro/gen-pro-asset-libraries-api/)
- [GEN Billing API](https://apis.io/apis/gen-pro/gen-pro-billing-api/)
- [GEN Cells API](https://apis.io/apis/gen-pro/gen-pro-cells-api/)
- [GEN Characters API](https://apis.io/apis/gen-pro/gen-pro-characters-api/)
- [GEN Columns API](https://apis.io/apis/gen-pro/gen-pro-columns-api/)
- [GEN Content Monitoring API](https://apis.io/apis/gen-pro/gen-pro-content-monitoring-api/)
- [GEN Content Resources API](https://apis.io/apis/gen-pro/gen-pro-content-resources-api/)

## Tags

Agent Chat

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/gen-pro/gen-pro-agent-chat-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/gen-pro/.