Import a Story (XML)

PUT

https://mapi.storyblok.com/v1/spaces/:space_id/stories/:story_id/import.xml

Imports content onto an existing story from an XML payload that has been exported from the Export a Story (XML) endpoint.

Note

This endpoint is used by the Import and Export Translatable Fields apps. Exporting and importing stories is available in premium plans. Please refer to Storyblok’s pricing for further information.

Path parameters

• :space_id required number

  Numeric ID of a space

• :story_id required number

  The numeric ID of the story

Query parameters

• version string

  Default: 2. Possible values: 1, 2.

  Caution

  Version 1 is deprecated. See examples for more information on differences between versions.

• lang_code string

  A language code (required for translation imports)

• import_lang boolean

  Whether to import content for the specified lang_code. If false or omitted, it will fall back to default language values.

Request body properties

• data required string

  An XML string with the same structure as the one exported from Export a Story (XML).

Response properties

• story The Story Object

  A single story object

Examples

Import a Story as XML ExamplesExamples describing different ways to import a story as XML.