---
title: "AgentCreateRequest"
url: "https://developers.bynder.com/apis/agents/versions/f5aecf98-613e-4ae8-b26a-ec2cdf804b2c/schemas/AgentCreateRequest"
---

> Full API specification: https://developers.bynder.com/apis/agents/versions/f5aecf98-613e-4ae8-b26a-ec2cdf804b2c.md

# AgentCreateRequest

The agent to create. `capabilities` defines what the agent can do and cannot be changed afterwards.

## OpenAPI definition

```yaml
openapi: 3.0.3
info:
  title: AI Agents
  version: "1.0"
servers:
  - url: https://{your-bynder-domain}/
components:
  schemas:
    PromptInput:
      type: object
      description: The prompt to set on an agent when you create or edit it. Unlike
        the read-only `Prompt` in responses, `id` and `version` are optional
        here.
      required:
        - text
      properties:
        id:
          type: string
          format: uuid
        version:
          type: integer
          format: int32
        text:
          type: string
          maxLength: 10000
    AgentCreateRequest:
      type: object
      description: The agent to create. `capabilities` defines what the agent can do
        and cannot be changed afterwards.
      required:
        - name
        - description
        - capabilities
        - agentProperties
      properties:
        autoApply:
          type: boolean
        name:
          type: string
          maxLength: 50
        description:
          type: string
          maxLength: 130
        capabilities:
          type: array
          minItems: 1
          items:
            type: string
            enum:
              - ENRICHMENT_AGENT
              - TRANSFORMATION_AGENT
              - BRAND_COMPLIANCE_AGENT
              - GOVERNANCE_AGENT
              - PATH_GENERATOR_AGENT
        agentProperties:
          type: object
          additionalProperties: true
        prompt:
          $ref: "#/components/schemas/PromptInput"
        status:
          type: string
          enum:
            - ACTIVE
            - INACTIVE
            - DRAFT
```