Pivotal Tracker (Preview)

Pivotal Tracker (Preview)

Pivotal Tracker is purpose-built to make it easy for you to convert an idea into a set of stories that you can prioritize, assign, and manage through completion.

This connector is available in the following products and regions:

Service Class Regions
Logic Apps Standard All Logic Apps regions except the following:
     -   Azure Government regions
     -   Azure China regions
Flow Standard All Flow regions except the following:
     -   US Government (GCC)
PowerApps Standard All PowerApps regions except the following:
     -   US Government (GCC)

Throttling Limits

Name Calls Renewal Period
API calls per connection 100 60 seconds
Frequency of trigger polls 1 120 seconds

Creating a connection

To connect your account, you will need the following information:

API Key
securestring
API Key

Actions

Create a story

This operation is used to create a new story.

Required Parameters

Project Id
integer
Pick a project.
Title
string

Optional Parameters

Description
string
Type
string
Pick a story type.
State
string
Pick a completion state.
Points
integer
Point value of the story.
Acceptance Date-Time
string
yyyy-MM-ddTHH:mm:ss.fffZ
Due Date-Time
string
yyyy-MM-ddTHH:mm:ss.fffZ
Requestor Id
integer
User id of the person who requested the story.

Returns

Delete a story

Deletes the specified story.

Required Parameters

Project Id
integer
Pick a project.
Story Id
string
The id of the story

Returns

Delete a story

Get a story

This operation retrieves all information about a story, given its id.

Required Parameters

Project Id
integer
Pick a project.
Story Id
string
The id of the story

Returns

List projects

List all projects for the current user.

Required Parameters

Project Id
integer
Pick a project.
Title
string

Optional Parameters

Description
string
Type
string
Pick a story type.
State
string
Pick a completion state.
Points
integer
Point value of the story.
Acceptance Date-Time
string
yyyy-MM-ddTHH:mm:ss.fffZ
Due Date-Time
string
yyyy-MM-ddTHH:mm:ss.fffZ
Requestor Id
integer
User id of the person who requested the story.

Returns

Update a story

This operation is used to update the details of a story, given its id.

Required Parameters

Project Id
integer
Pick a project.
Story Id
string
The id of the story

Optional Parameters

Title
string
Description
string
Type
string
Pick the story type.
State
string
Pick the completion state.
Points
integer
Point value of the story.
Acceptance Date-Time
string
yyyy-MM-ddTHH:mm:ss.fffZ
Due Date-Time
string
yyyy-MM-ddTHH:mm:ss.fffZ
Requestor Id
integer
User id of the person who requested the story.

Returns

Triggers

When a new story is created

Triggers when a new story is added to the given project.

Required Parameters

Project Id
integer
Pick a project.

Returns

When a story is completed

Triggers when an existing story is completed in the given project.

Required Parameters

Project Id
integer
Pick a project.

Returns

When a story is updated

Triggers when a story is created or the details of an existing story are updated in the given project.

Required Parameters

Project Id
integer
Pick a project.

Returns

Definitions

Listprojects_Response

Account Id
integer
Created Date/Time
date-time
yyyy-MM-ddTHH:mm:ss.fffZ
Current Iteration Number
integer
Enable Following
boolean
Allow users to follow stories and epics.
Enable Incoming Emails
boolean
Allow incoming email responses and convert them to comments.
Enable Tasks
boolean
Allow individual tasks to be created and managed within each story in the project.
Initial Velocity
integer
Is Public
boolean
Iteration Length
integer
The number of weeks in an iteration.
Point Scale
string
Project Id
integer
Project Name
string
Project Type
string
Start Date/Time
date-time
yyyy-MM-ddTHH:mm:ss.fffZ
Update Date/Time
date-time
yyyy-MM-ddTHH:mm:ss.fffZ
Velocity Averaged Over
integer
The number of iterations that should be used when averaging the number of points of Done stories in order to compute the project's velocity.
Version
integer
Week Start Day
string
The day in the week the project's iterations are to start on.

Story_Response

Acceptance Date-Time
date-time
yyyy-MM-ddTHH:mm:ss.fffZ
Created Date-Time
date-time
yyyy-MM-ddTHH:mm:ss.fffZ
Description
string
In-depth explanation of the story requirements.
Label Id
integer
The Id of the label.
Label Name
string
The name of the label.
Labels
array of object
Story labels.
Points
integer
Point value of the story (feature story type only).
Project Id
integer
The Id of the project.
Requestor Id
integer
The id of the person who requested the story.
State
string
Story's state of completion.
Story Id
integer
The Id of the story.
Story Type
string
Type of story.
Title
string
Story name.
URL
string
The URL of the story.
Updated Date-Time
date-time
yyyy-MM-ddTHH:mm:ss.fffZ
owner_ids
array of integer