curl --request POST \
--url https://api.platform.dakota.xyz/customers/import-persona-tokens \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--header 'x-idempotency-key: <x-idempotency-key>' \
--data '
{
"tokens": [
"cnst_ABC123def456",
"cnst_GHI789jkl012"
]
}
'const options = {
method: 'POST',
headers: {
'x-idempotency-key': '<x-idempotency-key>',
'x-api-key': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({tokens: ['cnst_ABC123def456', 'cnst_GHI789jkl012']})
};
fetch('https://api.platform.dakota.xyz/customers/import-persona-tokens', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.platform.dakota.xyz/customers/import-persona-tokens"
payload = { "tokens": ["cnst_ABC123def456", "cnst_GHI789jkl012"] }
headers = {
"x-idempotency-key": "<x-idempotency-key>",
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.platform.dakota.xyz/customers/import-persona-tokens"
payload := strings.NewReader("{\n \"tokens\": [\n \"cnst_ABC123def456\",\n \"cnst_GHI789jkl012\"\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-idempotency-key", "<x-idempotency-key>")
req.Header.Add("x-api-key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"job_id": "pij_2b8XyZ...",
"status": "running",
"total": 2,
"accepted": 2,
"skipped_count": 0,
"skipped": []
}{
"type": "https://docs.dakota.xyz/api-reference/errors#not-found",
"title": "Customer Not Found",
"status": 404,
"detail": "Customer cst_2abc123 was not found in your organization.",
"instance": "https://api.platform.dakota.xyz/customers/cst_2abc123",
"request_id": "req_7f3a8b2c"
}{
"type": "https://docs.dakota.xyz/api-reference/errors#not-found",
"title": "Customer Not Found",
"status": 404,
"detail": "Customer cst_2abc123 was not found in your organization.",
"instance": "https://api.platform.dakota.xyz/customers/cst_2abc123",
"request_id": "req_7f3a8b2c"
}{
"type": "https://docs.dakota.xyz/api-reference/errors#not-found",
"title": "Customer Not Found",
"status": 404,
"detail": "Customer cst_2abc123 was not found in your organization.",
"instance": "https://api.platform.dakota.xyz/customers/cst_2abc123",
"request_id": "req_7f3a8b2c"
}{
"type": "https://docs.dakota.xyz/api-reference/errors#not-found",
"title": "Customer Not Found",
"status": 404,
"detail": "Customer cst_2abc123 was not found in your organization.",
"instance": "https://api.platform.dakota.xyz/customers/cst_2abc123",
"request_id": "req_7f3a8b2c"
}{
"type": "https://docs.dakota.xyz/api-reference/errors#not-found",
"title": "Customer Not Found",
"status": 404,
"detail": "Customer cst_2abc123 was not found in your organization.",
"instance": "https://api.platform.dakota.xyz/customers/cst_2abc123",
"request_id": "req_7f3a8b2c"
}Import customers from Persona Connect share tokens
Starts an asynchronous import job for Persona Connect share tokens (cnst_...).
For each token, Dakota redeems it with Persona, maps the verified identity data
into a new customer and individual application, and imports documents.
Unlike the Sumsub import, Persona redemption is asynchronous on Persona’s side,
so this endpoint returns immediately with a job. Poll
GET /customers/persona-import-jobs/{job_id} for per-token results. Tokens are
validated and de-duplicated up front; skipped tokens never block accepted ones.
A skipped token is a token string that could not be queued (malformed, a
duplicate in the batch, or already imported) — it is NOT a compliance decision
about a person or application.
The import does not submit the application. Emits customer.application.imported
once for each token whose import succeeds: status is ready when the application
can be submitted, or incomplete with missing listing what it still needs (the
same validation GET /applications/{application_id}?include=validation returns; an
item with required: false, such as an optional proof of address, does not block
submission). A token that fails, expires or gets stuck sends nothing.
curl --request POST \
--url https://api.platform.dakota.xyz/customers/import-persona-tokens \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--header 'x-idempotency-key: <x-idempotency-key>' \
--data '
{
"tokens": [
"cnst_ABC123def456",
"cnst_GHI789jkl012"
]
}
'const options = {
method: 'POST',
headers: {
'x-idempotency-key': '<x-idempotency-key>',
'x-api-key': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({tokens: ['cnst_ABC123def456', 'cnst_GHI789jkl012']})
};
fetch('https://api.platform.dakota.xyz/customers/import-persona-tokens', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.platform.dakota.xyz/customers/import-persona-tokens"
payload = { "tokens": ["cnst_ABC123def456", "cnst_GHI789jkl012"] }
headers = {
"x-idempotency-key": "<x-idempotency-key>",
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.platform.dakota.xyz/customers/import-persona-tokens"
payload := strings.NewReader("{\n \"tokens\": [\n \"cnst_ABC123def456\",\n \"cnst_GHI789jkl012\"\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-idempotency-key", "<x-idempotency-key>")
req.Header.Add("x-api-key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"job_id": "pij_2b8XyZ...",
"status": "running",
"total": 2,
"accepted": 2,
"skipped_count": 0,
"skipped": []
}{
"type": "https://docs.dakota.xyz/api-reference/errors#not-found",
"title": "Customer Not Found",
"status": 404,
"detail": "Customer cst_2abc123 was not found in your organization.",
"instance": "https://api.platform.dakota.xyz/customers/cst_2abc123",
"request_id": "req_7f3a8b2c"
}{
"type": "https://docs.dakota.xyz/api-reference/errors#not-found",
"title": "Customer Not Found",
"status": 404,
"detail": "Customer cst_2abc123 was not found in your organization.",
"instance": "https://api.platform.dakota.xyz/customers/cst_2abc123",
"request_id": "req_7f3a8b2c"
}{
"type": "https://docs.dakota.xyz/api-reference/errors#not-found",
"title": "Customer Not Found",
"status": 404,
"detail": "Customer cst_2abc123 was not found in your organization.",
"instance": "https://api.platform.dakota.xyz/customers/cst_2abc123",
"request_id": "req_7f3a8b2c"
}{
"type": "https://docs.dakota.xyz/api-reference/errors#not-found",
"title": "Customer Not Found",
"status": 404,
"detail": "Customer cst_2abc123 was not found in your organization.",
"instance": "https://api.platform.dakota.xyz/customers/cst_2abc123",
"request_id": "req_7f3a8b2c"
}{
"type": "https://docs.dakota.xyz/api-reference/errors#not-found",
"title": "Customer Not Found",
"status": 404,
"detail": "Customer cst_2abc123 was not found in your organization.",
"instance": "https://api.platform.dakota.xyz/customers/cst_2abc123",
"request_id": "req_7f3a8b2c"
}Authorizations
Headers
Unique key (UUID) to ensure request idempotency on POST, PUT and PATCH requests.
A key is scoped to your client, the HTTP method and the path, and is remembered for 24 hours after a
successful (below 400) response. Repeating the same request (same JSON body, whatever the key order or
whitespace) with the same key within that window returns the original response with
X-Idempotent-Replayed: true instead of executing the request again. Using the same key on the same
endpoint with a different body returns 422 with problem type idempotency-key-reused; the request is
not executed. Error responses (4xx and 5xx) are not remembered, so a request refused for a fixable reason
can be corrected and retried under the same key. Request bodies that are not JSON (for example file
uploads) are not compared.
Body
Persona Connect share tokens (cnst_...) to import. Up to 5,000 per request — split larger migrations into multiple batches (each returns its own job).
1 - 5000 elementsResponse
Import job accepted and queued
Number of tokens accepted into the job
Number of token strings that could not be queued
Token strings that could not be queued, with their index and reason (malformed, duplicate in batch, or already imported). This is about the token string only — never a compliance decision about a person or application.
Show child attributes
Show child attributes
Was this page helpful?

