---
title: "Create Datamate"
method: POST
path: "/datamates/"
tags: ["Datamates"]
---

# Create Datamate

`POST /datamates/`

## Request

- Base URL: `https://api.myaltimate.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.myaltimate.com/datamates/`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

## Request body

- CreateDatamateRequest
  - `name` string, required
  - `description` string, nullable
  - `integrations` DatamateIntegration[], required
    - `id` union, required
      - string
      - integer
    - `tools` DatamateIntegrationTool[], required
      - `key` string, required
    - `connection_id` union
      - string
      - integer
    - `connection_ids` string[], nullable
  - `memory_enabled` boolean
  - `knowledge_engine_enabled` boolean
  - `privacy` 'public' | 'private'
  - `knowledge_bases` integer[], nullable

## Response `200`

Successful Response

- CreateDatamateResponse
  - `id` integer, required

## Other responses

- `400`: Malformed request body
- `403`: Forbidden
- `422`: Invalid request, grantee or connection

## Changes

- **2026-10-30** `77a7dface13f`: 1 info
  - added the new optional request property `integrations/items/connection_ids`
- **2026-10-27** `883849803623`: 2 info
  - added the new optional request property `integrations/items/connection_id`
  - added the non-success response with the status `400`
- **2026-09-30** `a1870d258a3a`: 1 info
  - the `memory_enabled` request property default value changed from `false` to `true`
- **2026-09-24** `eb8306fa77dd`: 1 info
  - the `knowledge_engine_enabled` request property default value changed from `false` to `true`
- **2026-09-04** `51aa5d004c49`: 1 breaking, 1 info
  - removed the media type `application/json` for the response with the status `422`
  - removed the non-success response with the status `400`

[Operation history](https://skmtc.dev/myaltimate/apis/myaltimate-api/changes/datamates/post.md)

---

[API](https://skmtc.dev/myaltimate/apis/myaltimate-api.md) - [All operations](https://skmtc.dev/myaltimate/apis/myaltimate-api/llms.txt) - [OpenAPI document](https://skmtc.dev/myaltimate/apis/myaltimate-api/revisions/727657ce54e9?raw)