Pour modifier une story, appelez la mutation storyEdit. Elle en crée une nouvelle version. Vous avez besoin de l’identifiant GraphQL de la story (voir Lire une story).

Cet exemple remplace l’asset principal par un autre fichier. Importez d’abord le fichier, comme dans Créer une story avec un fichier, puis utilisez le jeton obtenu de la même façon.

La mutation :

mutation storyEditExample($input: StoryEditInput!) {
  storyEdit(input: $input) {
    story {
      slug
      version {
        title
        mainAsset {
          __typename
          ... on FileAsset {
            downloadUrl
            embed
            mimetype
            filesize
          }
        }
      }
    }
    errors {
      __typename
      ... on MutationError {
        path
      }
    }
  }
}

Les variables :

{
  "input": {
    "id": "STORY_ID",
    "addedAssets": [
      {
        "type": "FILE",
        "file": ".eJw...xMWA",
        "uuid": "GENERATED_UUID"
      }
    ],
    "mainAsset": "GENERATED_UUID",
    "title": "My story with a new file as main asset",
    "publish": true
  }
}

Un champ omis garde en général la valeur de la version précédente. lang fait exception : sans ce champ, la nouvelle version n’a pas de langue.

Avec publish: true, le champ version de la réponse est la nouvelle version. Avec publish: false, version continue de renvoyer la dernière version publiée, et le brouillon se trouve dans story.editVersion.

title, body, attributes et lang définissent le contenu de la nouvelle version. body prend un format et un markup, comme dans Créer une story.
addedAssets et removedAssets modifient les pièces jointes ; mainAsset, coverAsset, removeMainAsset et removeCoverAsset modifient l’asset principal et la couverture.
addedTags, removedTags, addedHashtags et removedHashtags modifient les tags. Pour ne changer que les tags, utilisez la mutation plus simple décrite dans Modifier les tags d’une story.
publish vaut false par défaut, ce qui enregistre la nouvelle version comme brouillon. comment décrit la modification dans l’historique des versions.