Post a story

Creating a story is one mutation, storyPost. Its input is large, so split the request into two parts: the mutation and the variables.

The mutation:

mutation storyPostExample($input: StoryPostInput!) {
  storyPost(input: $input) {
    story {
      id
      slug
      version {
        title
      }
    }
    errors {
      __typename
      ... on MutationError {
        path
      }
    }
  }
}

The variables:

{
  "input": {
    "publish": true,
    "spaceId": "SPACE_ID",
    "title": "My first story",
    "body": {
      "format": "MARKDOWN",
      "markup": "# Hello world\n\nThis story was created through the API."
    }
  }
}

The fields you will use most:

• spaceId is the GraphQL ID of the space. If you only know its slug, read the ID with space(slug:) { id }, as Get a story does for a story. Set it to null to post in the user's personal content.
• body.format is one of the body formats: MARKDOWN for plain Markdown, MARKDOWN_ELIUM for Markdown with Elium directives, HTML or HTML_ELIUM for HTML.
• publish is false by default: the story stays a draft. Set it to true to publish it.
• schemaId applies a template. tags and hashtags take lists of IDs. lang sets the language of the version.

The response:

{
  "data": {
    "storyPost": {
      "story": {
        "id": "U3Rvcnk6MTIz",
        "slug": 123,
        "version": {
          "title": "My first story"
        }
      },
      "errors": null
    }
  }
}

To attach a file to the new story, see Post a story with a file.