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

# Create local instance

`POST /api/v2/distributed-instances/local`

Creates a new local instance

## Request body

- CreateLocalInstanceRequest
  - `id` string
  - `accessKey` string
  - `centralInstanceURL` string
  - `accessToken` string

## Response `201`

Created

- LocalInstance
  - `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
  - `accessKey` string
  - `centralInstanceURL` string
  - `isSubscribed` boolean

## 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)