Get my new user stories for a release

The following flow demonstrates how to get a list of the new user stories assigned to you for a specific release.

Entity relationship diagram

We need to access the following entities for this flow, and understand the relationships between these entities.

Entity Relationships in this flow Description of relationship Reference fields
Story Workspace user Each story can be assigned to a workspace user. In this flow, that workspace user is you. owner
Phase Each story has a phase (status). In this flow, we are interested new stories. phase
Release Each story can be assigned to a release. release

Back to top


Let's create the REST API call step-by-step.

  1. To list all the stories in the workspace:

    GET .../api/shared_spaces/<space_id>/workspaces/<workspace_id>/stories

  2. Let's build our query_clause. We are only interested in the new stories that are assigned to me and are associated with a specific release.

    This query has two three sets of criteria: The release, the phase (status), and the owner. We separate each set with a semi-colon (;), which represents the And operator.

    Let's start with the first set of criteria, which will be filtering by release. We use the reference field release and filter the releases using the name field and the * wildcard. This lists any release that starts with 941.

    GET .../api/shared_spaces/<space_id>/workspaces/<workspace_id>/stories?query="release EQ {name EQ ^941*^}"

    Note the syntax for reference fields: 

    Standard request syntax Syntax for reference fields
    Equal sign (=) EQ operator
    Quotation marks (") Carots (^)
  3. Now let's filter by the phase of the story. We only want those stories that are New.

    This is similar to working with list nodes. We want to compare the story's phase with the logical_name whose value new.

    GET .../api/shared_spaces/<space_id>/workspaces/<workspace_id>/stories?query="release EQ {name EQ ^941*^};phase EQ {logical_name EQ ^^}"

  4. The last criteria is to filter by the owner. Assuming my owner ID is 1001, this query will list any story that is new, assigned to a release that starts with 941, and is assigned to me.

    GET .../api/shared_spaces/<space_id>/workspaces/<workspace_id>/stories?query="release EQ {name EQ ^941*^};phase EQ {logical_name EQ ^^};owner EQ {id EQ 1001}"

The complete REST API call for this flow is: 

GET .../api/shared_spaces/<space_id>/workspaces/<workspace_id>/stories?query="release EQ {name EQ ^941*^};phase EQ {logical_name EQ ^^};owner EQ {id EQ 1001}"

Back to top

See also: