DKBSignDocs

API reference

POSTRequires Bearer token

Import selected LDAP users

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

Submit /api/companies/{company}/ldap/import/users. Authenticated routes need Authorization: Bearer {token} from POST /api/v1/login.

Path parameters

FieldTypeDescription
company
Required
stringPath parameter company.

Query parameters

This endpoint has no query parameters.

Request body

FieldTypeDescription
emails
Required
array1–100 distinct emails.
e.g. ["ada@acme.test","jane@acme.test"]
role_id
integerOptional role id.

Responses

StatusMeaning
202Import started
401Missing or invalid Bearer token.

Request

curl
curl -X POST 'https://api.dkbsigns.com/api/companies/company/ldap/import/users' \
  -H 'Authorization: Bearer $DKBSIGN_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"emails":["ada@acme.test","jane@acme.test"]}'

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"
  }
}