---
title: "Create distributed instance"
method: POST
path: "/api/v2/distributed-instances"
tags: ["v2 distributed instances"]
---

# Create distributed instance

`POST /api/v2/distributed-instances`

Creates a new distributed instance

## Request body

- CreateDistributedInstanceRequest
  - `name` string
  - `description` string

## Response `201`

Created

- DistributedInstance
  - `id` string
  - `name` string
  - `lastSynchronizationDate` string, date-time
  - `createdOn` string, date-time
  - `createdBy` string
  - `updatedOn` string, date-time
  - `updatedBy` string
  - `status` 'CREATED' | 'ACTIVE' | 'INACTIVE' | 'APPLYINGIDENTIFIER' | 'SYNCHRONIZING'
  - `entitySummaryList` EntitySummary[]
    - `entityClass` string
    - `count` integer
    - `countAddedUpdated` integer
    - `countRemoved` integer
    - `countIssues` integer
  - `description` string
  - `accessKeyId` string
  - `username` string
  - `token` string

## Other responses

- `409` — Conflict

---

[API](https://skmtc.net/keeps/apis/roda-rest-api.md) · [All operations](https://skmtc.net/keeps/apis/roda-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/keeps/roda-rest-api/revisions/afc3c5bcc0d9/schema)