Alias Service — Backend Specification
OpenAPI 3.0.3. Hosted by desp. Manages dean and alias creation/lookup.
Servers: http://alias.digital-euro.eu (production), https://test-alias.digital-euro.eu (test).
Endpoints
| Method | Path | operationId | Purpose |
|---|---|---|---|
| POST | /v1/aliases | createAlias | Create an Alias for an existing DEAN in DESP |
| POST | /v1/aliases-deans | createAliasDean | Create a DEAN and Alias together in DESP |
| POST | /v1/aliases-updates | updateAliasRequest | Update an existing Alias in DESP |
| POST | /v1/deans | createDean | Create a DEAN in DESP |
| POST | /v1/deans-bulks | CreateDeansBulk | Create a set of DEANs in bulk |
| POST | /v1/deans-deactivations | deactivateDean | Deactivate a DEAN in DESP |
| GET | /v1/lookups/aliases | getAlias | Retrieve a DEAN based on an Alias + Alias Type |
| GET | /v1/lookups/deans | getIntermediary | Retrieve an Intermediary based on a DEAN |
Common request parameters (referenced across endpoints)
Request-ID, Request-Timestamp, Requesting-Agent — standard headers on every call
(see components/parameters in the raw YAML for exact definitions).
Standard error responses
400 BadRequest · 401 Unauthorized · 403 Forbidden · 404 NotFound ·
405 MethodNotAllowed · (406+ continue per endpoint — check raw YAML for the full set
before assuming coverage).
Related
dean · alias · desp · spec-accessmanagement