DKBSignDocs

API reference

POSTRequires Bearer token

Import users from LDAP

/api/companies/{company}/ldap/import

Creates or updates users from AD. Never disables missing accounts. Returns 202 — poll GET .../ldap/import/latest. Status: pending → processing → completed / failed.

Path parameters

FieldTypeDescription
company
Required
stringPath parameter company.

Query parameters

This endpoint has no query parameters.

Request body

FieldTypeDescription
role_id
integerRole for imported users (default-mode).

Responses

StatusMeaning
202Import started
401Missing or invalid Bearer token.

Request

curl
curl -X POST 'https://api.dkbsigns.com/api/companies/company/ldap/import' \
  -H 'Authorization: Bearer $DKBSIGN_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"role_id":1}'

Response 202

json
{
  "message": "Import LDAP démarré",
  "import": {
    "id": 1,
    "company_id": 1,
    "status": "pending",
    "stats": {},
    "message": null,
    "error": null,
    "started_at": null,
    "completed_at": null,
    "created_at": "2026-03-01T10:00:00+00:00"
  }
}