Dyspatch API Changelog

Whenever a backwards-incompatible change is introduced we release a new dated API version. Use an Accept header to specify the version used when making API calls:

curl --request GET \
--url https://api.dyspatch.io/templates \
--header 'Authorization: Bearer EXAMPLEAPIKEYXXXXXXXX12345678' \
--header 'Accept: application/vnd.dyspatch.2023.03+json'

The latest version is 2023-03.

Earlier versions of the API can be accessed by clicking a title below.

2023-07

• Change /drafts/{draftId} and /drafts updated
  • designApprovedDate is now included in the draft responses.

2023-03

• New Added block localization endpoint /blocks/{blockId}/localizations.
• New Added block localization keys endpoint /blocks/{blockId}/localizationKeys.
• New Added block localization create/delete endpoint /blocks/{blockId}/localizations/{languageId}.
• New Added block localization translation update endpoint /blocks/{blockId}/localizations/{languageId}/translations.

2023-02

• New Added template render API endpoint /render/template/{templateId}.
• New Added block API endpoints /blocks/ and /blocks/{blockId}.

2023-01

• New Added workspace API endpoints /workspaces and /workspaces/{folderId}.
• Change /drafts/{draftId} and /drafts updated
  • templateName is now included in the draft responses.
  • status is now included in the draft response and reflects the status of the draft (IN_PROGRESS, LOCKED_FOR_TRANSLATION, PENDING_APPROVAL)
  • path and workspaceId are included in the draft responses, refecting where the draft fits in the folder hierarchy.
• Change /templates/{templateId} and /templates updated
  • publishedDraftId is included in the template responses and reflects the id of the currently published draft.
  • path and workspaceId are included in the template responses, refecting where the template fits in the folder hierarchy.

2020-11

• New Add ampHtml parameter to all compiled objects to support AMP output.
• New new endpoint /localizations/:draftId/localizations/:localizationId to return the value for a localization ID at a particular draft.
• Change url in draft localizations list will point to this new endpoint.

2020-04

• Add ability to create localizations that reference locale groups.
• Updated /drafts/{draftId} and /templates/{templateID}
  • language field has been renamed to languages and returns an array of languages.
  • localization has been renamed to id.

2019-10

• Add new /localizations/... endpoints for localization management.
• Draft content is available from the /drafts/... endpoints.
• A draft can be submitted for approval with a request to /drafts/{draftId}/publishRequest.

2019-03

• The first public version of the Dyspatch API.
• Add new required field targetLanguage to get template by ID method.
  • Required for versions after 2019.01.beta.
• Add new required field targetLanguage to get localization by ID method.
  • Required for versions after 2019.01.beta.