# Create Crewai Agents

Endpoint: POST /crewai-agents/api/v1/agents
Version: 1.0.0

## Header parameters:

  - `X-Tenant-Id` (any, required)

  - `X-User-Id` (any, required)

## Request fields (application/json):

  - `name` (any, required)
    Unique name of the agent.

  - `role` (any, required)
    Title or function of the agent within the Crew.

  - `goal` (any, required)
    Primary objective or responsibility of the agent.

  - `backstory` (any)
    Optional narrative to give context and personality to the agent.

  - `tools` (any)
    List of tools this agent is allowed to use.

  - `llm` (any)
    The language model used to power the agent.

  - `max_iter` (any)
    Maximum number of reasoning iterations allowed during task execution.

  - `reasoning` (any)
    If true, the agent will perform reasoning steps before executing tasks.

  - `max_reasoning_steps` (any)
    Maximum number of reasoning steps the agent can take before executing a task.

  - `allow_code_execution` (any)
    If true, the agent can execute code as part of its reasoning process.

  - `code_execution_mode` (any)
    Determines when the agent can execute code: 'safe' (default), or 'unsafe'.

  - `max_retry_limit` (any)
    Maximum number of retries allowed for task execution in case of failures.

  - `knowledge_bases` (any)
    List of knowledge bases that the agent can access.

  - `tasks` (any)
    List of task definitions to be executed by the agents.

  - `planning` (any)
    If true, the agent can perform planning tasks.

## Response 422 fields (application/json):

  - `detail` (array)

  - `detail.loc` (array, required)

  - `detail.msg` (any, required)

  - `detail.type` (any, required)