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
Power Automate Standard All Power Automate regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
Power Apps Standard All Power Apps regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)

Creating a connection

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

Name Type Description
API Key securestring

API Key

Throttling Limits

Name Calls Renewal Period
API calls per connection10060 seconds
Frequency of trigger polls1120 seconds

Actions

Create a story

This operation is used to create a new story.

Delete a story

Deletes the specified story.

Get a story

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

List projects

List all projects for the current user.

Update a story

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

Create a story

This operation is used to create a new story.

Parameters

Name Key Required Type Description
Project Id
projectId True integer

Pick a project.

Title
name True string

Pick a project.

Description
description string

Pick a project.

Type
story_type string

Pick a story type.

State
current_state string

Pick a completion state.

Points
estimate integer

Point value of the story.

Acceptance Date-Time
accepted_at string

yyyy-MM-ddTHH:mm:ss.fffZ

Due Date-Time
deadline string

yyyy-MM-ddTHH:mm:ss.fffZ

Requestor Id
requested_by_id integer

User id of the person who requested the story.

Returns

Delete a story

Deletes the specified story.

Parameters

Name Key Required Type Description
Project Id
projectId True integer

Pick a project.

Story Id
storyId True string

The id of the story

Returns

Get a story

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

Parameters

Name Key Required Type Description
Project Id
projectId True integer

Pick a project.

Story Id
storyId True string

The id of the story

Returns

List projects

List all projects for the current user.

Returns

Update a story

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

Parameters

Name Key Required Type Description
Project Id
projectId True integer

Pick a project.

Story Id
storyId True string

The id of the story

Title
name string

Pick a project.

Description
description string

Pick a project.

Type
story_type string

Pick the story type.

State
current_state string

Pick the completion state.

Points
estimate integer

Point value of the story.

Acceptance Date-Time
accepted_at string

yyyy-MM-ddTHH:mm:ss.fffZ

Due Date-Time
deadline string

yyyy-MM-ddTHH:mm:ss.fffZ

Requestor Id
requested_by_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.

When a story is completed

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

When a story is updated

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

When a new story is created

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

Parameters

Name Key Required Type Description
Project Id
projectId True integer

Pick a project.

Returns

When a story is completed

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

Parameters

Name Key Required Type Description
Project Id
projectId True 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.

Parameters

Name Key Required Type Description
Project Id
projectId True integer

Pick a project.

Returns

Definitions

Listprojects_Response

Name Path Type Description
Account Id
account_id integer
Created Date/Time
created_at date-time

yyyy-MM-ddTHH:mm:ss.fffZ

Current Iteration Number
current_iteration_number integer
Enable Following
enable_following boolean

Allow users to follow stories and epics.

Enable Incoming Emails
enable_incoming_emails boolean

Allow incoming email responses and convert them to comments.

Enable Tasks
enable_tasks boolean

Allow individual tasks to be created and managed within each story in the project.

Project Id
id integer
Initial Velocity
initial_velocity integer
Iteration Length
iteration_length integer

The number of weeks in an iteration.

Project Name
name string
Point Scale
point_scale string
Project Type
project_type string
Is Public
public boolean
Start Date/Time
start_time date-time

yyyy-MM-ddTHH:mm:ss.fffZ

Update Date/Time
updated_at date-time

yyyy-MM-ddTHH:mm:ss.fffZ

Velocity Averaged Over
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
version integer
Week Start Day
week_start_day string

The day in the week the project's iterations are to start on.

Story_Response

Name Path Type Description
Acceptance Date-Time
accepted_at date-time

yyyy-MM-ddTHH:mm:ss.fffZ

Created Date-Time
created_at date-time

yyyy-MM-ddTHH:mm:ss.fffZ

State
current_state string

Story's state of completion.

Description
description string

In-depth explanation of the story requirements.

Points
estimate integer

Point value of the story (feature story type only).

Story Id
id integer

The Id of the story.

Labels
labels array of object

Story labels.

Label Id
labels.id integer

The Id of the label.

Label Name
labels.name string

The name of the label.

Title
name string

Story name.

owner_ids
owner_ids array of integer
Project Id
project_id integer

The Id of the project.

Requestor Id
requested_by_id integer

The id of the person who requested the story.

Story Type
story_type string

Type of story.

Updated Date-Time
updated_at date-time

yyyy-MM-ddTHH:mm:ss.fffZ

URL
url string

The URL of the story.