Pivotal Tracker
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 - US Department of Defense (DoD) |
| Power Automate | Standard | All Power Automate regions except the following: - US Government (GCC) - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD) |
| Power Apps | Standard | All Power Apps regions except the following: - US Government (GCC) - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD) |
| Contact | |
|---|---|
| Name | Microsoft |
| URL | Microsoft LogicApps Support Microsoft Power Automate Support Microsoft Power Apps Support |
| Connector Metadata | |
|---|---|
| Publisher | Microsoft |
| Website | https://www.pivotaltracker.com/ |
| Privacy policy | https://pivotal.io/privacy-policy |
Creating a connection
The connector supports the following authentication types:
| Default | Parameters for creating connection. | All regions | Not shareable |
Default
Applicable: All regions
Parameters for creating connection.
This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.
| Name | Type | Description | Required |
|---|---|---|---|
| API Key | securestring | API Key | True |
Throttling Limits
| Name | Calls | Renewal Period |
|---|---|---|
| API calls per connection | 100 | 60 seconds |
| Frequency of trigger polls | 1 | 120 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 | |
|
Description
|
description | string | ||
|
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
- Body
- Story_Response
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
- Body
- Story_Response
List projects
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 | ||
|
Description
|
description | string | ||
|
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
- Body
- Story_Response
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
- Body
- Story_Response
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
- Body
- Story_Response
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
- Body
- Story_Response
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. |