curl --request POST --fail-with-body --max-time 30 \
  "${AMLOK_API_BASE_URL}/v1/embedding-sessions" \
  --header "Authorization: Bearer ${AMLOK_API_KEY}" \
  --header 'Accept: application/json' \
  --header 'Idempotency-Key: createEmbeddingSession-synthetic-0042' \
  --header 'Content-Type: application/json' \
  --data '{"borrower_id":"bor_synthetic","embedding_version_id":"embed_synthetic","purpose":"connect","return_url":"https://institution.example.com/connected","consent_purposes":["credit_assessment","continuous_monitoring"],"embed_origin":"https://institution.example.com"}'

import os
import requests

headers = {'Accept': 'application/json', 'Idempotency-Key': 'createEmbeddingSession-synthetic-0042', 'Content-Type': 'application/json'}
headers["Authorization"] = "Bearer " + os.environ["AMLOK_API_KEY"]
response = requests.request('POST', os.environ["AMLOK_API_BASE_URL"] + '/v1/embedding-sessions', headers=headers, json={'borrower_id': 'bor_synthetic', 'embedding_version_id': 'embed_synthetic', 'purpose': 'connect', 'return_url': 'https://institution.example.com/connected', 'consent_purposes': ['credit_assessment', 'continuous_monitoring'], 'embed_origin': 'https://institution.example.com'}, timeout=30, allow_redirects=False)
response.raise_for_status()
print(response.json())

const headers = {"Accept": "application/json", "Idempotency-Key": "createEmbeddingSession-synthetic-0042", "Content-Type": "application/json"};
headers.Authorization = `Bearer ${process.env.AMLOK_API_KEY}`;
const response = await fetch(process.env.AMLOK_API_BASE_URL + "/v1/embedding-sessions", {
  method: "POST", headers, redirect: "error", signal: AbortSignal.timeout(30000),
  body: JSON.stringify({"borrower_id": "bor_synthetic", "embedding_version_id": "embed_synthetic", "purpose": "connect", "return_url": "https://institution.example.com/connected", "consent_purposes": ["credit_assessment", "continuous_monitoring"], "embed_origin": "https://institution.example.com"})
});
if (!response.ok) throw new Error(`HTTP ${response.status}: ${await response.text()}`);
console.log(await response.json());

{
  "data": {
    "id": "embs_synthetic",
    "borrower_id": "bor_synthetic",
    "status": "created",
    "launch_url": "https://borrower.example.com/session/synthetic",
    "expires_at": "2026-11-06T12:15:00Z",
    "connection_ids": [],
    "consent_ids": [],
    "record_version": 1,
    "embedding_version_id": "embed_synthetic",
    "purpose": "connect",
    "origination_id": null,
    "monitor_id": null,
    "requirement_id": null,
    "consent_purposes": [
      "credit_assessment",
      "continuous_monitoring"
    ],
    "embed_origin": "https://institution.example.com",
    "return_url": "https://institution.example.com/connected",
    "failure": null
  },
  "meta": {
    "request_id": "req_synthetic",
    "schema_version": "1.0.0",
    "environment": "sandbox"
  }
}

{
  "error": {
    "code": "validation_error",
    "message": "Validation error.",
    "retryable": false,
    "request_id": "req_synthetic",
    "field": null
  }
}

{
  "error": {
    "code": "unauthenticated",
    "message": "Unauthenticated.",
    "retryable": false,
    "request_id": "req_synthetic",
    "field": null
  }
}

{
  "error": {
    "code": "insufficient_credits",
    "message": "Insufficient credits.",
    "retryable": false,
    "request_id": "req_synthetic",
    "field": null
  }
}

{
  "error": {
    "code": "forbidden",
    "message": "Forbidden.",
    "retryable": false,
    "request_id": "req_synthetic",
    "field": null
  }
}

{
  "error": {
    "code": "not_found",
    "message": "Not found.",
    "retryable": false,
    "request_id": "req_synthetic",
    "field": null
  }
}

{
  "error": {
    "code": "idempotency_conflict",
    "message": "Idempotency conflict.",
    "retryable": false,
    "request_id": "req_synthetic",
    "field": null
  }
}

{
  "error": {
    "code": "cursor_expired",
    "message": "Cursor expired.",
    "retryable": false,
    "request_id": "req_synthetic",
    "field": null
  }
}

{
  "error": {
    "code": "payload_too_large",
    "message": "payload too large",
    "retryable": false,
    "request_id": "req_synthetic",
    "field": null
  }
}

{
  "error": {
    "code": "unsupported_media_type",
    "message": "unsupported media type",
    "retryable": false,
    "request_id": "req_synthetic",
    "field": null
  }
}

{
  "error": {
    "code": "validation_error",
    "message": "Validation error.",
    "retryable": false,
    "request_id": "req_synthetic",
    "field": null
  }
}

{
  "error": {
    "code": "rate_limited",
    "message": "Rate limited.",
    "retryable": true,
    "request_id": "req_synthetic",
    "field": null
  }
}

{
  "error": {
    "code": "temporarily_unavailable",
    "message": "Temporarily unavailable.",
    "retryable": true,
    "request_id": "req_synthetic",
    "field": null
  }
}