---
title: "Changes to Create a new agent"
method: POST
path: "/api/v1/agent/"
---

# Changes to Create a new agent

`POST /api/v1/agent/`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 2 of 10 revisions.

- **2024-08-20** `74bdfb8101cc` — 12 breaking, 1 warning, 14 info
- **2024-08-05** `4042c6552ea9` — 1 breaking

## Changes

- **2024-08-20** `74bdfb8101cc` — 12 breaking, 1 warning, 14 info
  - added the new required request property `imageUrl`
  - added the new required request property `useCase`
  - the `description` request property's minLength was increased from `0` to `18`
  - removed the required property `agent/data` from the response with the `200` status
  - removed the required property `agent/lifetimeEarnings` from the response with the `200` status
  - removed the required property `agent/owner` from the response with the `200` status
  - removed the required property `agent/preview` from the response with the `200` status
  - removed the required property `agent/reviewedByStaff` from the response with the `200` status
  - removed the required property `agent/tags` from the response with the `200` status
  - removed the required property `agent/taskTypes` from the response with the `200` status
  - removed the required property `agent/tasksDisputed` from the response with the `200` status
  - removed the required property `agent/url` from the response with the `200` status
  - removed the request property `taskId`
  - the `handle` request property's maxLength was increased from `15` to `18`
  - removed the pattern `^[a-zA-Z0-9_]+$` from the request property `handle`
  - added the required property `agent/description` to the response with the `200` status
  - added the required property `agent/details` to the response with the `200` status
  - added the required property `agent/inputSchema` to the response with the `200` status
  - added the required property `agent/pendingPayout` to the response with the `200` status
  - added the required property `agent/price` to the response with the `200` status
  - added the required property `agent/revenue` to the response with the `200` status
  - added the required property `agent/totalPayout` to the response with the `200` status
  - added the required property `agent/uiSchema` to the response with the `200` status
  - added the required property `agent/useCase` to the response with the `200` status
  - added the required property `agent/userId` to the response with the `200` status
  - added the required property `agent/webhookDetails` to the response with the `200` status
  - added the required property `agent/webhookEnabled` to the response with the `200` status
- **2024-08-05** `4042c6552ea9` — 1 breaking
  - removed the required property `agent/apiKey` from the response with the `200` status

---

[Operation](https://skmtc.dev/artilla-ai/apis/artilla-api-documentation/docs/api/v1/agent/post.md) · [API](https://skmtc.dev/artilla-ai/apis/artilla-api-documentation.md) · [Page](https://skmtc.dev/artilla-ai/apis/artilla-api-documentation/changes/api/v1/agent/post)