# GEN Agents API

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

GEN Agents 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 2 JSON Schema definitions. Tagged areas include Agents. The published artifact set on APIs.io includes an OpenAPI specification and 2 JSON Schemas.

Create, read, update, and delete agents and their avatars.

## Operations (11)

| Method | Path | Summary |
|---|---|---|
| POST | `/agents` | Create an agent |
| GET | `/agents/{agent_id}` | Get an agent |
| PATCH | `/agents/{agent_id}` | Update an agent |
| DELETE | `/agents/{agent_id}` | Delete an agent |
| GET | `/agents/{agent_id}/avatars` | List agent profile photos |
| POST | `/agents/{agent_id}/avatars` | Upload agent avatar |
| DELETE | `/agents/{agent_id}/avatars/{id}` | Delete avatar(s) |
| POST | `/user_shared_agents` | Create, update, or remove assistants and their profiles — share agent |
| GET | `/user_shared_agents/{id}` | Create, update, or remove assistants and their profiles — revoke agent share |
| PUT | `/user_shared_agents/{id}` | Create, update, or remove assistants and their profiles — set agent share role |
| DELETE | `/user_shared_agents/{id}` | Create, update, or remove assistants and their profiles — revoke agent share |

## Machine-readable artifacts (3)

- **OpenAPI** — https://artifacts.apis.io/gen-pro/openapi/gen-pro-agents-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/gen-pro/json-schema/gen-pro-agent-detail-schema.json
- **JSONSchema** — https://artifacts.apis.io/gen-pro/json-schema/gen-pro-avatar-schema.json

## Other GEN APIs (12)

- [GEN Agent Chat API](https://apis.io/apis/gen-pro/gen-pro-agent-chat-api/)
- [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 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

Agents

---

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