# create

Endpoint: POST /api/chats
Version: 1.0.0
Security: ApiKeyAuth

## Security:

  - `ApiKeyAuth` (unknown)
    http TD1

## Request fields (application/json):

  - `data` (object, required)

  - `data.type` (string, required)

  - `data.attributes` (object, required)

  - `data.attributes.agentId` (string)

  - `data.attributes.promptId` (string)

  - `data.attributes.integrationId` (string)

  - `data.attributes.attachments` (array)

  - `data.attributes.attachments.binaryBase64` (string, required)

  - `data.attributes.attachments.contentType` (string, required)

  - `data.attributes.attachments.inputFieldName` (string, required)

  - `data.attributes.actionId` (string)

  - `data.attributes.formInterfaceId` (string)

  - `data.attributes.inputParameters` (string)

  - `data.attributes.chatInterfaceId` (string)

  - `data.attributes.textResourceId` (string)

  - `data.attributes.userProperties` (array)

  - `data.attributes.userProperties.name` (string, required)

  - `data.attributes.userProperties.value` (string, required)

## Response 201:

  - `201` (unknown)
    POST /api/chats normalizes null userProperties to empty array

## Response 201 fields (application/vnd.api+json):

  - `data` (object, required)

  - `data.id` (string, required)

  - `data.type` (string, required)

  - `data.links` (object, required)

  - `data.links.self` (string, required)

  - `data.attributes` (object, required)

  - `data.attributes.createdAt` (string, required)

  - `data.attributes.updatedAt` (string, required)

  - `data.attributes.projectId` (string, required)

  - `data.attributes.agentId` (string, required)

  - `data.attributes.promptId` (string, required)

  - `data.attributes.integrationId` (string, required)

  - `data.attributes.actionId` (string, required)

  - `data.attributes.formInterfaceId` (string, required)

  - `data.attributes.chatInterfaceId` (string, required)

  - `data.attributes.inputParameters` (string, required)

  - `data.attributes.textResourceId` (string, required)

  - `data.attributes.userProperties` (array, required)

  - `data.attributes.userProperties.name` (string, required)

  - `data.attributes.userProperties.value` (string, required)

  - `data.attributes.firstInputContent` (any, required)

  - `data.attributes.createdByChatId` (any, required)

  - `data.attributes.createdByToolCallId` (any, required)

  - `data.attributes.lastConversationAt` (string, required)

  - `data.attributes.attachments` (array, required)

## Response 401:

  - `401` (unknown)
    Rejected by 401

## Response 401 fields (application/json):

  - `status` (string, required)

  - `error` (string, required)

## Response 403:

  - `403` (unknown)
    returns 403

## Response 403 fields (application/json):

  - `status` (string, required)

  - `error` (string, required)

## Response 422:

  - `422` (unknown)
    POST /api/chats rejects userProperties with more than 10 items

## Response 422 fields (application/vnd.api+json):

  - `errors` (array, required)

  - `errors.title` (string, required)

  - `errors.detail` (string, required)

  - `errors.code` (string, required)

  - `errors.source` (object, required)

  - `errors.source.pointer` (string, required)

  - `errors.status` (string, required)

  - `errors.meta` (object, required)

  - `errors.meta.validationCode` (string, required)

  - `errors.meta.originalType` (string)