Connect API: Design and DesignPage schemas now contain design type (preview)

Announcements
, ,
1

Hello everyone! :waving_hand:

We’ve recently added a new design_type field to the Design and DesignPages schemas.

These fields make it easier to identify, group, and handle different types of Canva content in your integration without needing to guess the type of design you are working with.

This is now available in preview.

What’s changed?

  • The Design schema now includes a new design_types field, which is an unordered list of unique types present across the pages of that design.
  • The DesignPage schema now includes a new design_type field, which indicates the type of that page.

We’re starting with a small set of types:

  • doc
  • email
  • presentation
  • sheet
  • whiteboard
  • custom

For now, any design types outside of this initial set will be returned as unknown. We’ll continue expanding the list over time, so make sure to handle a default case if a new value is added.

Reminder

As this is a preview API, breaking changes may occur. Be sure to keep an eye on the Changelog for updates.

Docs & Details

Full details, including example responses and schema definitions, are available in the Design API reference.

Feedback & Questions

We’d love to hear how you’re planning to use this:

  • What workflows or use cases would design_types help simplify in your integration?
  • Are there additional design types you’d like us to support?
  • Are there any edge cases or scenarios where the current values wouldn’t be sufficient?
  • What related capabilities would you find useful next?