Languages
BASE URL: https://api.umbraco.io
Table of Contents
Common Headers
Authentication
Authentication is required for this API. You must supply a Bearer Token via an Authorization header or an API Key via an Authorization or Api-Key header.
Errors
If an error occours you will receive a HTTP status code along with an API error code and an error message in the response body.
Status Code | Error Code | Message |
---|---|---|
400 | BadRequest | Body cannot be empty. |
401 | Unauthorized | Authorization has been denied for this request. |
403 | Forbidden | You are not authorized to access the given resource. |
404 | NotFound | Language with id '{id}' could not be found. |
409 | LanguageForCultureAlreadyExist | The language '{isoCode}' already exists. |
422 | ValidationFailed | Validation error occured when trying to save or update the language. |
500 | InternalServerError | Internal server error. |
JSON example:
Get languages
Gets all languages available for content creation.
URL: /language
Method: GET
Permissions required : Access to Settings section of the Umbraco Backoffice
Success Response
Code: 200
Content Example:
Get by ISO code
Get a specific langauge by its ISO code.
URL: /language/{id}
Method: GET
Permissions required : Access to Settings section of the Umbraco Backoffice
Success Response
Code: 200
Content Example:
Create language
Create a new language for use on content.
The number of languages that can be created is determined by the pricing tier.
URL: /language
Method: POST
Permissions required : Access to Settings section of the Umbraco Backoffice
Request
Success Response
Code: 201
Content Example:
Update language
Updates an existing language.
URL: /language/{id}
Method: PUT
Permissions required : Access to Settings section of the Umbraco Backoffice
Request
Success Response
Code: 200
Content Example:
Delete language
Deletes an existing language.
Deleting a language that is in use will result in setting the content based on this language to invariant
.
URL: /language/{id}
Method: DELETE
Permissions required : Access to Settings section of the Umbraco Backoffice
Success Response
Code: 200
Content Example:
DELETE https://api.umbraco.io/language/da-DK
Last updated