Reconcile server accounts

POST

/api/v1/management/servers/{serverId}/accounts/reconcile

curl --request POST \
  --url https://api.koneth.com/api/v1/management/servers/6be9a699-2f28-402e-b64e-93ba6bdafe1b/accounts/reconcile \
  --header 'Authorization: <Authorization>' \
  --header 'X-Request-Id: onboarding-client-1042'

• Production
• Local development

Brings Koneth Main’s record of a server’s accounts back in line with what the server actually holds. Requires accounts:create.

Use it after an account create failed midway, or after a server was restored from a backup — the two ways the records drift apart. Neither case should cost anyone an account, so an account the server holds and Koneth Main does not is adopted into the organization that owns the server, and a record left failed whose account the server does report becomes a real account again. Only a failed record the server never created is cleared.

Authorizations

• managementKey

Parameters

Path Parameters

serverId

required

string format: uuid

UUID of a trading server owned by your organization.

Example

6be9a699-2f28-402e-b64e-93ba6bdafe1b

Header Parameters

X-Request-Id

string

Optional correlation ID used for API request billing and logs.

Example

onboarding-client-1042

Responses

200

Reconciliation completed.

Media typeapplication/json

object

adopted

required

Account numbers Koneth Main now manages and did not before, either registered for the first time or restored from a failed record. A paused account is adopted as disabled and an ended one as archived.

Array<string>

removedFailed

required

Number of failed account records cleared from Koneth Main.

integer

runtimeAccountCount

required

Number of accounts the server still reports.

integer

Example

{
  "adopted": [
    "7001042"
  ],
  "removedFailed": 1,
  "runtimeAccountCount": 24
}

400

Invalid request.

Media typeapplication/json

object

error

required

string

issues

Validation issue details when the request fails schema validation.

Array<object>

object

key

additional properties

any

Example^generated

{
  "error": "example",
  "issues": [
    {}
  ]
}

401

Management API authentication is missing or invalid.

Media typeapplication/json

object

error

required

string

issues

Validation issue details when the request fails schema validation.

Array<object>

object

key

additional properties

any

Example

{
  "error": "Management API authentication required"
}

402

The organization cannot cover the active API request price.

Media typeapplication/json

object

error

required

string

issues

Validation issue details when the request fails schema validation.

Array<object>

object

key

additional properties

any

Example

{
  "error": "Insufficient API credits"
}

403

The key lacks the required scope or server access.

Media typeapplication/json

object

error

required

string

issues

Validation issue details when the request fails schema validation.

Array<object>

object

key

additional properties

any

Example

{
  "error": "Missing API scope: accounts:read"
}

500

Unexpected server error.

Media typeapplication/json

object

error

required

string

issues

Validation issue details when the request fails schema validation.

Array<object>

object

key

additional properties

any

Example

{
  "error": "Internal server error"
}