Stories API ⚠

Last modified: March 7, 2024

1 Introduction

The Mendix Stories API allows you to retrieve, create, and update the Sprint, stories, and tasks in your Mendix apps.

To use the API, you need to set up a Consumed Web Service using the WDSL for this service, available here: Get WSDL. You can find out how to do this in How to Consume a Complex Web Service.

2 Published Microflows

2.1 Microflow CreateSprint

This microflow creates a new Sprint for the specified project and returns the ID of the new Sprint.

Parameter Name Parameter Type Description
ApiKey String The API Key the application uses to access the Stories API for this project.
DurationInWeeks Integer/Long Duration of the new Sprint in weeks.
Name String Name of the new Sprint.
ProjectID String The ID of the project.
StartDate Date and time Start date for the new Sprint. If not filled, the Sprint will automatically start directly after * the previous Sprint. (optional)
StartsAfterSprint Integer/Long ID of the Sprint directly preceding the new Sprint.
  • Return value – Integer/Long

2.2 Microflow CreateStory

This microflow creates a new story in the specified Sprint and returns the ID of the new story. Parameters:

Parameter Name Parameter Type Description
ApiKey String The API Key the application uses to access the Stories API for this project.
Description String Description of the story (optional)
Name String Name of the new story.
Points Enumeration StoryPoints Number of story points. If left empty will be set to 1. (_1/_2/_3/_5/_8/_13/_20/_40/_100, optional)
ProjectID String The ID of the project.
SprintID Integer/Long The ID of the Sprint.
StoryType Enumeration StoryType The type of the story (Feature or Bug)
  • Return value – Integer/Long

2.3 Microflow CreateTask

This microflow creates a new task for the specified story and returns the ID of the new task. Parameters:

Parameter Name Parameter Type Description
ApiKey String The API Key the application uses to access the Stories API for this project.
Description String Description of the task (optional)
Name String Name of the new task.
ProjectID String The ID of the project.
StoryID Integer/Long The ID of the story.
  • Return value – Integer/Long

2.4 Microflow GetSprintByID

This microflow retrieves a specific Sprint. Parameters:

Parameter Name Parameter Type Description
ApiKey String The API Key the application uses to access the Stories API for this project.
ProjectID String The ID of the project.
SprintID Integer/Long The ID of the Sprint.
  • Return value – Sprint_Transient

2.5 Microflow GetSprints

This microflow retrieves all Sprints in a specific project. Parameters:

Parameter Name Parameter Type Description
ApiKey String The API Key the application uses to access the Stories API for this project.
ProjectID String The ID of the project.
  • Return value – List of Sprint_Transient

2.6 Microflow GetStories

This microflow retrieves all stories in a specific Sprint. Parameters:

Parameter Name Parameter Type Description
ApiKey String The API Key the application uses to access the Stories API for this project.
ProjectID String The ID of the project.
SprintID Integer/Long The ID of the Sprint for which stories are being retrieved.
  • Return value – List of Story_Transient

2.7 Microflow GetStoryByID

This microflow retrieves a specific story. Parameters:

Parameter Name Parameter Type Description
ApiKey String The API Key the application uses to access the Stories API for this project.
ProjectID String The ID of the project.
StoryID Integer/Long The ID of the story.
  • Return value – Story_Transient

2.8 Microflow GetTaskByID

This microflow retrieves a specific task. Parameters:

Parameter Name Parameter Type Description
ApiKey String The API Key the application uses to access the Stories API for this project.
ProjectID String The ID of the project.
TaskID Integer/Long The ID of the task.
  • Return value – Task_Transient

2.9 Microflow GetTasks

This microflow retrieves all tasks for a specific story. Parameters:

Parameter Name Parameter Type Description
ApiKey String The API Key the application uses to access the Stories API for this project.
ProjectID String The ID of the project.
StoryID Integer/Long The ID of the story for which tasks are being retrieved.
  • Return value – List of Task_Transient

2.10 Microflow UpdateStory

This microflow updates a story with modified information. Parameters:

Parameter Name Parameter Type Description
ApiKey String The API Key the application uses to access the Stories API for this project.
Description String Description of the story (optional)
Name String Name of the story.
ParentSprintID Integer/Long The ID of the Sprint the story is in.
Points Enumeration StoryPoints Number of story points. (_1/_2/_3/_5/_8/_13/_20/_40/_100)
ProjectID String The ID of the project.
Status Enumeration BacklogState Status of the story, (Open/Started/Done)
StoryID Integer/Long ID of the Story
StoryType Enumeration StoryType The type of the story (Feature/Bug)
  • Return value – Boolean

2.11 Microflow UpdateTask

This microflow updates a task with modified information. Parameters:

Parameter Name Parameter Type Description
ApiKey String The API Key the application uses to access the Stories API for this project.
Description String Description of the task (optional)
IsCompleted Boolean Completion state of the task.
Name String Name of the new task.
ParentStoryID Integer/Long The ID of the story the task belongs to.
ProjectID String The ID of the project.
TaskID Integer/Long The ID of the task.
  • Return value – Boolean