DKBSignDocs

API reference

PUTRequires Bearer token

Save AD group role mappings

/api/companies/{company}/ldap/role-mappings

Used when ldap_role_mode is ad_groups.

Path parameters

FieldTypeDescription
company
Required
stringPath parameter company.

Query parameters

This endpoint has no query parameters.

Request body

FieldTypeDescription
mappings
Required
arrayGroup → role mappings.
e.g. [{"ldap_group_dn":"CN=Managers,OU=Groups,DC=acme,DC=test","role_id":3,"priority":10}]

Responses

StatusMeaning
200Mappings saved
401Missing or invalid Bearer token.

Request

curl
curl -X PUT 'https://api.dkbsigns.com/api/companies/company/ldap/role-mappings' \
  -H 'Authorization: Bearer $DKBSIGN_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"mappings":[{"ldap_group_dn":"CN=Managers,OU=Groups,DC=acme,DC=test","role_id":3,"priority":10}]}'

Response 200

json
{
  "message": "Correspondances enregistrées",
  "role_mappings": []
}