generated: '2026-08-13'
method: searched
source: https://docs.dyspatch.io/api/changelog.html
scheme: date-based
scheme_detail: >-
  API versions use a dated format (YYYY.MM, occasionally with a vN suffix) and
  are selected per request via the Accept header, e.g.
  application/vnd.dyspatch.2026.07+json. Omitting the version pins to the account
  default. Older versions remain retrievable via the changelog version selector.
current_version: '2026.07'
spec_downloads:
  detail: >-
    Every dated version has a downloadable OpenAPI YAML document, not just the
    latest — an unusually complete versioning posture. Twenty versions are
    published, from 2019.03 to 2026.07.
  pattern: https://docs.dyspatch.io/api/specs/<version>.yml
  latest: https://docs.dyspatch.io/api/specs/2026.07.yml
  versions: ['2019.03', '2019.10', '2020.04', '2020.11', '2023.01', '2023.02', '2023.03',
    '2023.07', '2024.07', '2024.08', '2024.11', '2024.12', '2025.05', '2025.05v2',
    '2025.06', '2025.09', '2026.01', '2026.06', '2026.07']
product_release_notes:
  url: https://www.dyspatch.io/release-notes/
  http_status: 200
  scope: >-
    A SECOND, separate changelog covering the product (builder, AI/Scribe,
    image library, workspaces) rather than the API contract. Dated entries,
    most recent 2026-04-02. Useful context but not a source of API change
    signal — it is the API changelog at docs.dyspatch.io/api/changelog.html that
    governs the contract.
  recent_entries:
  - date: '2026-04-02'
    title: March Updates
    highlights: [Autosave across email/SMS/push/voice builders, Dyspatch University
        (university.dyspatch.io), image library scoped per workspace, AI brand guidelines]
  - date: '2026-01-21'
    title: 'Generate Images in Dyspatch Instantly: Accessibility and Speed'
    highlights: [Scribe AI image generation, automatic alt text, organization-level
        brand guidelines, image upload limit raised 3MB to 5MB]
captured_spec_note: >-
  The spec harvested into openapi/ is 2026.06. The 2026.07 delta is additive only
  (a `channel` object on template responses) and changes no operation, so the
  derived artifacts in this repo — data-model, errors, conventions, crosswalk,
  skills, agentic-access — hold for both versions.
entries:
- version: '2026.07'
  date: null
  breaking: false
  additions: true
  highlights:
  - Added a `channel` field (id and name) to template responses across all five
    channel types — Email, SMS, Push, Voice and Live Activity — on both the
    list and get-by-id operations.
  - The field is omitted when no channel is assigned to the template.
  affected_operations: [getTemplates, getTemplateById, getSMSTemplates, getSMSTemplateById,
    getPushTemplates, getPushTemplateById, getVoiceTemplates, getVoiceTemplateById,
    getLiveActivityTemplates, getLiveActivityTemplateById]
- version: '2026.06'
  breaking: false
  highlights:
  - Added query filters (name, folderId, workspaceId) to template endpoints.
  - Added templateId filter to draft endpoints.
  - Introduced translation endpoints for all template types.
  - New Customer Profiles and Themes endpoints.
  - Renamed draft status awaitingTranslation to LOCKED_FOR_TRANSLATION.
- version: '2026.01'
  breaking: false
  highlights:
  - Draft duplicate, archive, and lock/unlock-for-translation endpoints added
    across Email, SMS, Push, Voice, and Live Activity.
- version: '2025.09'
  breaking: true
  highlights:
  - Responses now include a variables key in compiled data for template and
    draft endpoints.
- version: '2025.06'
  breaking: false
  highlights:
  - New Tag management endpoints; tag data included in block, draft, and template
    responses.
- version: '2025.05v2'
  breaking: false
  highlights:
  - Live Activity template and draft endpoints introduced with localization
    support.
- version: '2025.05'
  breaking: false
  highlights:
  - Optional themeId parameter added to template rendering and retrieval
    endpoints.
- version: '2024.12'
  breaking: false
  highlights:
  - Draft approval/rejection endpoints added for Email, SMS, Push, and Voice.
- version: '2024.11'
  breaking: false
  highlights:
  - Push and Voice template/draft endpoints launched with full localization
    support.
- version: '2024.07'
  breaking: false
  highlights:
  - SMS template/draft endpoints introduced; localized template rendering added.
- version: '2019.03'
  breaking: false
  highlights:
  - Initial public release of the Dyspatch API.