REST API v5

This section of the Pivotal Tracker API documentation is a reference to all of the endpoints (URL paths) the API supports, the operations (request types) that can be performed with those endpoints, and the schema of the resource data encodings they return. It is applicable to API v5 only. Information about behaviors and request/response information that is common across the API is covered in the documentation Introduction.

Introduction

This section of the documentation is a reference for API version 'v5'. The bulk of the documentation is made up of the references for Endpoints (all of the URL paths the API makes available and the HTTP methods supported by each) and for Resources (the supported attributes for the different data structures maintained by the Tracker server and used to exchange data between client and server). Each resource is listed independently, sorted alphabetically by name. Endpoints are listed in groups with other, related endpoints. Groups are arranged in what is intended to be a logical reading/scanning order.

Pivotal Tracker API v5 behaves exactly as described in the API documentation's Essentials section. Each individual item reference below describes the deviations, if any, that that item has from the standard/default API behavior.

In particular, there are a handful of endpoints that either don't support any of the standard response-formatting parameters (their format is entirely fixed), or that don't support the date_format query parameter, see Selecting the Date/Time Format. These cases are noted in the description of each endpoint. In cases where date_format is not supported, the format is always an integer number of milliseconds since the epoch—the client is never forced to use an ISO 8601-format time value.

Endpoints

Me

ENDPOINT

/me

GET Returns information from the user's profile plus the list of projects to which the user has access.
PUT Update the person's personal settings and return thier profile and list of projects.

Provides information about the authenticated user.

In addition to authenticating this request like other API requests, this request can be made with authentication using "basic auth" to pass the user's normal Pivotal Tracker login credentials (their email address or user name plus their password). In this way, client software can use the user's name and password to obtain their API Token, and then use that token to authenticate future API requests made on behalf of that user. Obviously, the user's password should not be stored or otherwise retained.


export TOKEN='your Pivotal Tracker API token'
curl -X GET -H "X-TrackerToken: $TOKEN" "https://www.pivotaltracker.com/services/v5/me?fields=%3Adefault"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"accounts":[{"kind":"account_summary","id":100,"name":"Galactic Empire","status":"active","plan":"Enterprise"}],"api_token":"VadersToken","created_at":"2024-08-20T12:00:05Z","email":"vader@deathstar.mil","has_google_identity":false,"id":101,"initials":"DV","kind":"me","name":"Darth Vader","projects":[{"kind":"membership_summary","id":108,"project_id":98,"project_name":"Learn About the Force","project_color":"8100ea","favorite":false,"role":"owner","last_viewed_at":"2024-08-20T12:00:00Z"},{"kind":"membership_summary","id":101,"project_id":99,"project_name":"Death Star","project_color":"8100ea","favorite":false,"role":"member","last_viewed_at":"2024-08-20T12:00:00Z"}],"receives_in_app_notifications":true,"time_zone":{"kind":"time_zone","olson_name":"America/Los_Angeles","offset":"-08:00"},"twofactor_auth_enabled":false,"updated_at":"2024-08-20T12:00:10Z","username":"vader"}


curl -X GET --user vader:password "https://www.pivotaltracker.com/services/v5/me"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"accounts":[{"kind":"account_summary","id":100,"name":"Galactic Empire","status":"active","plan":"Enterprise"}],"api_token":"VadersToken","created_at":"2024-08-20T12:00:05Z","email":"vader@deathstar.mil","has_google_identity":false,"id":101,"initials":"DV","kind":"me","name":"Darth Vader","projects":[{"kind":"membership_summary","id":108,"project_id":98,"project_name":"Learn About the Force","project_color":"8100ea","favorite":false,"role":"owner","last_viewed_at":"2024-08-20T12:00:10Z"},{"kind":"membership_summary","id":101,"project_id":99,"project_name":"Death Star","project_color":"8100ea","favorite":false,"role":"member","last_viewed_at":"2024-08-20T12:00:10Z"}],"receives_in_app_notifications":true,"time_zone":{"kind":"time_zone","olson_name":"America/Los_Angeles","offset":"-08:00"},"twofactor_auth_enabled":false,"updated_at":"2024-08-20T12:00:10Z","username":"vader"}

Successful responses to this request return the me resource.

PARAMETERS

Only the information for the user matching the request authentication can be obtained. If a request is made to /me using basic-auth instead of an API Token, and the user does not yet have an API Token generated, Tracker will generate and store one, and return it in the response.

Successful responses to this request return the me resource.

PARAMETERS

personal_settings

personal_settings in the request body.
— Settings for the authenticated user.

ENDPOINT

Access a list of all the people you know


export TOKEN='your Pivotal Tracker API token'
curl -X GET -H "X-TrackerToken: $TOKEN" "https://www.pivotaltracker.com/services/v5/my/people?project_id=99"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Pagination-Offset: 
        X-Tracker-Pagination-Total: 10
        X-Tracker-Pagination-Returned: 10
        X-Tracker-Project-Version: 66
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           [{"kind":"known_person","person":{"kind":"person","id":109,"name":"3D-4X administrative droid","email":"threedeefourx@sith.mil","initials":"3D4X","username":"threedeefourx"},"collaboration_factor":0},{"kind":"known_person","person":{"kind":"person","id":107,"name":"Bevel Lemelisk","email":"bevel@sith.mil","initials":"bl","username":"bevel"},"collaboration_factor":0},{"kind":"known_person","person":{"kind":"person","id":104,"name":"Clone TK421","email":"tk421@deathstar.mil","initials":"TK421","username":"tk421"},"collaboration_factor":1},{"kind":"known_person","person":{"kind":"person","id":101,"name":"Darth Vader","email":"vader@deathstar.mil","initials":"DV","username":"vader"},"collaboration_factor":2},{"kind":"known_person","person":{"kind":"person","id":100,"name":"Emperor Palpatine","email":"emperor@galacticrepublic.gov","initials":"EP","username":"palpatine"},"collaboration_factor":1},{"kind":"known_person","person":{"kind":"person","id":106,"name":"Galen Marek","email":"marek@sith.mil","initials":"GM","username":"starkiller"},"collaboration_factor":0},{"kind":"known_person","person":{"kind":"person","id":103,"name":"Moradmin Bast","email":"bast@deathstar.mil","initials":"MB","username":"bast"},"collaboration_factor":2},{"kind":"known_person","person":{"kind":"person","id":105,"name":"Robotic Maintenance Team 4","email":"I662@deathstar.mil","initials":"i662","username":"i662"},"collaboration_factor":1},{"kind":"known_person","person":{"kind":"person","id":114,"name":"Tarfang","email":"tarfang@example.com","initials":"TF","username":"tarfang"},"collaboration_factor":0},{"kind":"known_person","person":{"kind":"person","id":102,"name":"Wilhuff Tarkin","email":"governor@eriadu.gov","initials":"WT","username":"tarkin"},"collaboration_factor":1}]

Successful responses to this request return an array containing zero or more instances of the known_person resource.

PARAMETERS

project_id

int in the request query.
required — The project

filter_by

string in the request query.
— Optional parameter that will filter people by name, email address, initials, or username

offset

int[pos] in the request query.
— With the first known person in your known_people list as 0, the index of the first known person you want returned.

limit

int[pos] in the request query.
— The number of known people you want returned.


export TOKEN='your Pivotal Tracker API token'
curl -X POST -H "X-TrackerToken: $TOKEN" -H "Content-Type: application/json" -d '{"emails":["threedeefourx@sith.mil","bevel@sith.mil","tk421@deathstar.mil","vader@deathstar.mil","emperor@galacticrepublic.gov","marek@sith.mil","bast@deathstar.mil","I662@deathstar.mil"]}' "https://www.pivotaltracker.com/services/v5/my/people"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Pagination-Offset: 
        X-Tracker-Pagination-Total: 8
        X-Tracker-Pagination-Returned: 8
        X-Tracker-Project-Version: 66
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           [{"kind":"known_person","person":{"kind":"person","id":109,"name":"3D-4X administrative droid","email":"threedeefourx@sith.mil","initials":"3D4X","username":"threedeefourx"},"collaboration_factor":0},{"kind":"known_person","person":{"kind":"person","id":107,"name":"Bevel Lemelisk","email":"bevel@sith.mil","initials":"bl","username":"bevel"},"collaboration_factor":0},{"kind":"known_person","person":{"kind":"person","id":104,"name":"Clone TK421","email":"tk421@deathstar.mil","initials":"TK421","username":"tk421"},"collaboration_factor":1},{"kind":"known_person","person":{"kind":"person","id":101,"name":"Darth Vader","email":"vader@deathstar.mil","initials":"DV","username":"vader"},"collaboration_factor":2},{"kind":"known_person","person":{"kind":"person","id":100,"name":"Emperor Palpatine","email":"emperor@galacticrepublic.gov","initials":"EP","username":"palpatine"},"collaboration_factor":1},{"kind":"known_person","person":{"kind":"person","id":106,"name":"Galen Marek","email":"marek@sith.mil","initials":"GM","username":"starkiller"},"collaboration_factor":0},{"kind":"known_person","person":{"kind":"person","id":103,"name":"Moradmin Bast","email":"bast@deathstar.mil","initials":"MB","username":"bast"},"collaboration_factor":2},{"kind":"known_person","person":{"kind":"person","id":105,"name":"Robotic Maintenance Team 4","email":"I662@deathstar.mil","initials":"i662","username":"i662"},"collaboration_factor":1}]

Successful responses to this request return an array containing zero or more instances of the known_person resource.

PARAMETERS

project_id

int in the request query.
required — The project

offset

int in the request query.
— With the first known person in your known_people list as 0, the index of the first known person you want returned.

limit

int in the request query.
— The number of known people you want returned.

emails

List[string] in the request body.
— Return the known people who match email addresses in this list

Notifications

ENDPOINT

/my/notifications

GET Return list of the notifications for the authenticated person. Response is sorted by notification created_at, most recent first.

Provides a list of all notifications.


export TOKEN='your Pivotal Tracker API token'
curl -X GET -H "X-TrackerToken: $TOKEN" "https://www.pivotaltracker.com/services/v5/my/notifications?envelope=true"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"data":[{"kind":"notification","id":22,"project":{"kind":"project","id":99,"name":"Death Star"},"performer":{"kind":"person","id":102,"name":"Wilhuff Tarkin"},"message":"Wilhuff Tarkin has made you an owner of this story:","notification_type":"story","new_attachment_count":0,"action":"ownership","story":{"kind":"story","id":559,"name":"All exhaust ports should be shielded"},"created_at":"2024-08-20T12:00:15Z","updated_at":"2024-08-20T12:00:20Z"},{"kind":"notification","id":18,"project":{"kind":"project","id":99,"name":"Death Star"},"performer":{"kind":"person","id":101,"name":"Darth Vader"},"message":"Darth Vader rejected your story","notification_type":"story","action":"rejection","story":{"kind":"story","id":559,"name":"All exhaust ports should be shielded"},"created_at":"2024-08-20T12:00:20Z","updated_at":"2024-08-20T12:00:20Z"},{"kind":"notification","id":8,"project":{"kind":"project","id":99,"name":"Death Star"},"performer":{"kind":"person","id":102,"name":"Wilhuff Tarkin"},"message":"Wilhuff Tarkin has made you an owner of this story","notification_type":"story","action":"ownership","story":{"kind":"story","id":559,"name":"All exhaust ports should be shielded"},"created_at":"2024-08-20T12:00:20Z","updated_at":"2024-08-20T12:00:20Z"},{"kind":"notification","id":5,"project":{"kind":"project","id":99,"name":"Death Star"},"performer":{"kind":"person","id":100,"name":"Emperor Palpatine"},"message":"Emperor Palpatine has made you an owner of this story","notification_type":"story","action":"ownership","story":{"kind":"story","id":551,"name":"Hire bounty hunters to bring in Solo"},"created_at":"2024-08-20T12:00:20Z","updated_at":"2024-08-20T12:00:20Z"},{"kind":"notification","id":21,"project":{"kind":"project","id":99,"name":"Death Star"},"performer":{"kind":"person","id":101,"name":"Darth Vader"},"message":"Darth Vader added the comment: \"Should we send a probe to Dantooine?\"","notification_type":"comment","new_attachment_count":0,"action":"create","epic":{"kind":"epic","id":5,"name":"Rebel Home Worlds"},"comment_id":110,"created_at":"2024-08-20T12:00:05Z","updated_at":"2024-08-20T12:00:20Z","read_at":"2024-08-20T12:00:10Z"}],"http_status":"200","last_notification_timestamp":1724155220000}

Successful responses to this request return an array containing zero or more instances of the notification resource.

PARAMETERS

created_after

datetime in the request query.
— Show notifications created after this date/time. If this parameter or updated_after is not provided, the default is 10 days prior to the request time.

updated_after

datetime in the request query.
— Show notifications updated after this date/time.

notification_types

enumerated string in the request query.
— Filter which notifications are included in the response. Specifying :default or omitting a notification type will include "story", "epic", "comment", and "comment_with_mention" notification types. Specifying :all will include all types provided by default as well as new or experimental notification types.

Valid enumeration values: :all, :default

limit

int in the request query.
— Max number of notifications to retrieve. Defaults to 1000.

ENDPOINT

/my/notifications/mark_read

PUT Marks the authenticated person's notifications as read up to the given notification id.

Marks all notifications read before a notification id.


export TOKEN='your Pivotal Tracker API token'
curl -X PUT -H "X-TrackerToken: $TOKEN" -H "Content-Type: application/json" "https://www.pivotaltracker.com/services/v5/my/notifications/mark_read"



  
    View Response
  

  
    Hide Response

    
      status: 204
    

    
      Headers
        Content-Type: application/json; potentially-other-variable-stuff

PARAMETERS

before

int in the request query.
required — Mark all notifications before this id as read (inclusive)

ENDPOINT

/my/notifications/read_list

PUT Marks a list of notifications read for the authenticated person.

Marks a list of notifications read.

PARAMETERS

ids

List[int] in the request query.
required — List of notification ids to mark as read.

ENDPOINT

/people/{person_id}/notifications/since/{timestamp}

GET Returns list of the notifications for the specified person whose updated_at values are less than the timestamp. The timestamp provided must match that of an existing notification. If the timestamp value is 0, a default value 10 days before the request time is used. Results are sorted by updated_at, most recent first.

Provides a list of notifications. Unlike most endpoints that allow you to control the response format with url parameters, this endpoint will always return responses with an envelope and a date_format in milliseconds.


export TOKEN='your Pivotal Tracker API token'
export PERSON_ID=104
curl -X GET -H "X-TrackerToken: $TOKEN" "https://www.pivotaltracker.com/services/v5/people/$PERSON_ID/notifications/since/1723377600000"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"data":[{"kind":"notification","id":22,"project":{"kind":"project","id":99,"name":"Death Star"},"performer":{"kind":"person","id":102,"name":"Wilhuff Tarkin"},"message":"Wilhuff Tarkin has made you an owner of this story:","notification_type":"story","new_attachment_count":0,"action":"ownership","story":{"kind":"story","id":559,"name":"All exhaust ports should be shielded"},"created_at":1724155205000,"updated_at":1724155205000},{"kind":"notification","id":18,"project":{"kind":"project","id":99,"name":"Death Star"},"performer":{"kind":"person","id":101,"name":"Darth Vader"},"message":"Darth Vader rejected your story","notification_type":"story","action":"rejection","story":{"kind":"story","id":559,"name":"All exhaust ports should be shielded"},"created_at":1724155205000,"updated_at":1724155205000},{"kind":"notification","id":8,"project":{"kind":"project","id":99,"name":"Death Star"},"performer":{"kind":"person","id":102,"name":"Wilhuff Tarkin"},"message":"Wilhuff Tarkin has made you an owner of this story","notification_type":"story","action":"ownership","story":{"kind":"story","id":559,"name":"All exhaust ports should be shielded"},"created_at":1724155205000,"updated_at":1724155205000},{"kind":"notification","id":5,"project":{"kind":"project","id":99,"name":"Death Star"},"performer":{"kind":"person","id":100,"name":"Emperor Palpatine"},"message":"Emperor Palpatine has made you an owner of this story","notification_type":"story","action":"ownership","story":{"kind":"story","id":551,"name":"Hire bounty hunters to bring in Solo"},"created_at":1724155205000,"updated_at":1724155205000}],"http_status":"200"}

Successful responses to this request return an array containing zero or more instances of the notification resource.

PARAMETERS

person_id

int in the request path.
required — The ID of the person.

timestamp

datetime in the request path.
required — Show notifications created after this timestamp. The timestamp provided must match that of an existing notification. Note that this datetime must be specified in number of milliseconds since the epoch; it does not support ISO 8601 like other datetimes.

notification_types

Valid enumeration values: :all, :default

limit

int in the request query.
— Max number of notifications to retrieve. Defaults to 500.

The standard formatting parameters cannot be included in requests for this operation. In particular, envelope= is prohibited and Tracker behaves as if envelope=true had been provided.

ENDPOINT

/my/notifications/{notification_id}

PUT Mark the notification as read

Access the notification specified by the notification_id value in the URL.


export TOKEN='your Pivotal Tracker API token'
curl -X PUT -H "X-TrackerToken: $TOKEN" -H "Content-Type: application/json" -d '{"read_at":"2024-08-20T12:00:00Z"}' "https://www.pivotaltracker.com/services/v5/my/notifications/22"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"action":"ownership","created_at":"2024-08-20T12:00:00Z","id":22,"kind":"notification","message":"Wilhuff Tarkin has made you an owner of this story:","new_attachment_count":0,"notification_type":"story","performer":{"kind":"person","id":102,"name":"Wilhuff Tarkin"},"project":{"kind":"project","id":99,"name":"Death Star"},"read_at":"2024-08-20T12:00:05Z","story":{"kind":"story","id":559,"name":"All exhaust ports should be shielded"},"updated_at":"2024-08-20T12:00:05Z"}

Successful responses to this request return the notification resource.

PARAMETERS

notification_id

int in the request path.
required — The ID of the notification.

read_at

datetime in the request body.
required — Time notification was read.

Projects

ENDPOINT

/projects

GET Get all of a user's active projects
POST Create a new empty project.

Access a user's projects


export TOKEN='your Pivotal Tracker API token'
curl -X GET -H "X-TrackerToken: $TOKEN" "https://www.pivotaltracker.com/services/v5/projects"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           [{"id":98,"kind":"project","name":"Learn About the Force","version":2,"iteration_length":1,"week_start_day":"Monday","point_scale":"0,1,2,3","point_scale_is_custom":false,"bugs_and_chores_are_estimatable":false,"automatic_planning":true,"enable_tasks":true,"time_zone":{"kind":"time_zone","olson_name":"America/Los_Angeles","offset":"-07:00"},"velocity_averaged_over":3,"number_of_done_iterations_to_show":4,"has_google_domain":false,"enable_incoming_emails":true,"initial_velocity":10,"public":false,"atom_enabled":true,"project_type":"private","start_time":"2024-08-20T12:00:05Z","created_at":"2024-08-20T12:00:10Z","updated_at":"2024-08-20T12:00:15Z","show_story_priority":true,"show_priority_icon":false,"show_priority_icon_in_all_panels":true,"account_id":100,"current_iteration_number":1,"enable_following":true},{"id":99,"kind":"project","name":"Death Star","version":66,"iteration_length":1,"week_start_day":"Monday","point_scale":"0,1,2,3","point_scale_is_custom":false,"bugs_and_chores_are_estimatable":false,"automatic_planning":true,"enable_tasks":true,"time_zone":{"kind":"time_zone","olson_name":"America/Los_Angeles","offset":"-07:00"},"velocity_averaged_over":3,"number_of_done_iterations_to_show":4,"has_google_domain":false,"description":"Expeditionary Battle Planetoid","profile_content":"This is a machine of war such as the universe has never known. It's colossal, the size of a class-four moon. And it possesses firepower unequaled in the history of warfare.","enable_incoming_emails":true,"initial_velocity":10,"public":false,"atom_enabled":true,"project_type":"private","start_date":"2024-05-06","start_time":"2024-08-20T12:00:15Z","created_at":"2024-08-20T12:00:10Z","updated_at":"2024-08-20T12:00:15Z","show_story_priority":true,"show_priority_icon":false,"show_priority_icon_in_all_panels":true,"account_id":100,"current_iteration_number":15,"enable_following":true}]


export TOKEN='your Pivotal Tracker API token'
curl -X GET -H "X-TrackerToken: $TOKEN" "https://www.pivotaltracker.com/services/v5/projects?account_ids=100"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           [{"id":98,"kind":"project","name":"Learn About the Force","version":2,"iteration_length":1,"week_start_day":"Monday","point_scale":"0,1,2,3","point_scale_is_custom":false,"bugs_and_chores_are_estimatable":false,"automatic_planning":true,"enable_tasks":true,"time_zone":{"kind":"time_zone","olson_name":"America/Los_Angeles","offset":"-07:00"},"velocity_averaged_over":3,"number_of_done_iterations_to_show":4,"has_google_domain":false,"enable_incoming_emails":true,"initial_velocity":10,"public":false,"atom_enabled":true,"project_type":"private","start_time":"2024-08-20T12:00:05Z","created_at":"2024-08-20T12:00:10Z","updated_at":"2024-08-20T12:00:15Z","show_story_priority":true,"show_priority_icon":false,"show_priority_icon_in_all_panels":true,"account_id":100,"current_iteration_number":1,"enable_following":true},{"id":99,"kind":"project","name":"Death Star","version":66,"iteration_length":1,"week_start_day":"Monday","point_scale":"0,1,2,3","point_scale_is_custom":false,"bugs_and_chores_are_estimatable":false,"automatic_planning":true,"enable_tasks":true,"time_zone":{"kind":"time_zone","olson_name":"America/Los_Angeles","offset":"-07:00"},"velocity_averaged_over":3,"number_of_done_iterations_to_show":4,"has_google_domain":false,"description":"Expeditionary Battle Planetoid","profile_content":"This is a machine of war such as the universe has never known. It's colossal, the size of a class-four moon. And it possesses firepower unequaled in the history of warfare.","enable_incoming_emails":true,"initial_velocity":10,"public":false,"atom_enabled":true,"project_type":"private","start_date":"2024-05-06","start_time":"2024-08-20T12:00:15Z","created_at":"2024-08-20T12:00:10Z","updated_at":"2024-08-20T12:00:15Z","show_story_priority":true,"show_priority_icon":false,"show_priority_icon_in_all_panels":true,"account_id":100,"current_iteration_number":15,"enable_following":true}]

Successful responses to this request return an array containing zero or more instances of the project resource.

PARAMETERS

account_ids

string in the request query.
— A comma separated list of account ids whose projects should be returned


export TOKEN='your Pivotal Tracker API token'
curl -X POST -H "X-TrackerToken: $TOKEN" -H "Content-Type: application/json" -d '{"name":"Executioner"}' "https://www.pivotaltracker.com/services/v5/projects"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 1
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"account_id":100,"atom_enabled":false,"automatic_planning":true,"bugs_and_chores_are_estimatable":false,"created_at":"2024-08-20T12:00:05Z","current_iteration_number":1,"enable_following":true,"enable_incoming_emails":true,"enable_tasks":true,"has_google_domain":false,"id":1900,"initial_velocity":10,"iteration_length":1,"kind":"project","name":"Executioner","number_of_done_iterations_to_show":4,"point_scale":"0,1,2,3","point_scale_is_custom":false,"project_type":"private","public":false,"show_priority_icon":false,"show_priority_icon_in_all_panels":true,"show_story_priority":false,"start_time":"2024-08-20T12:00:00Z","time_zone":{"kind":"time_zone","olson_name":"America/Los_Angeles","offset":"-07:00"},"updated_at":"2024-08-20T12:00:05Z","velocity_averaged_over":3,"version":1,"week_start_day":"Monday"}

Successful responses to this request return the project resource.

PARAMETERS

no_owner

boolean in the request body.
— By default, the user whose credentials are supplied will be added as a project owner. To leave the project without this owner, supply the no_owner key.

new_account_name

string[100] in the request body.
— If specified, creates a new account with the specified name, and adds the new project to that account.

name

extended string[50] in the request body.
— The name of the project.

status

string in the request body.
— The status of the project.

iteration_length

int in the request body.
— The number of weeks in an iteration.

week_start_day

enumerated string in the request body.
— The day in the week the project's iterations are to start on.

Valid enumeration values: Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday

point_scale

string[255] in the request body.
— The specification for the "point scale" available for entering story estimates within the project. It is specified as a comma-delimited series of values--any value that would be acceptable on the Project Settings page of the Tracker web application may be used here. If an exact match to one of the built-in point scales, the project will use that point scale. If another comma-separated point-scale string is passed, it will be treated as a "custom" point scale. The built-in scales are "0,1,2,3", "0,1,2,4,8", and "0,1,2,3,5,8".

bugs_and_chores_are_estimatable

boolean in the request body.
— When true, Tracker will allow estimates to be set on Bug- and Chore-type stories. This is strongly not recommended. Please see the FAQ for more information.

automatic_planning

boolean in the request body.
— When false, Tracker suspends the emergent planning of iterations based on the project's velocity, and allows users to manually control the set of unstarted stories included in the Current iteration. See the FAQ for more information.

enable_tasks

boolean in the request body.
— When true, Tracker allows individual tasks to be created and managed within each story in the project.

show_story_priority

boolean in the request body.
— When true, Tracker allows Priority field to be hidden within each story in the project.

show_priority_icon

boolean in the request body.
— When true, Tracker allows Priority field to be hidden within each story in the project.

show_priority_icon_in_all_panels

boolean in the request body.
— When true, Tracker allows Priority field to be hidden within each story in the project.

start_date

date in the request body.
— The first day that should be in an iteration of the project. If both this and "week_start_day" are supplied, they must be consistent. It is specified as a string in the format "YYYY-MM-DD" with "01" for January. If this is not supplied, it will remain blank (null), but "start_time" will have a default value based on the stories in the project. If a value is supplied for start_date, but that date is later than the accepted_at date of the earliest accepted story in your project, start_time will be based on the accepted_at date of the earliest accepted story.

time_zone

time_zone in the request body.
— The "native" time zone for the project, independent of the time zone(s) from which members of the project view or modify it.

velocity_averaged_over

int in the request body.
— 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.

number_of_done_iterations_to_show

int in the request body.
— There are areas within the Tracker UI and the API in which sets of stories automatically exclude the Done stories contained in older iterations. For example, in the web UI, the DONE panel doesn't necessarily show all Done stories by default, and provides a link to click to cause the full story set to be loaded/displayed. The value of this attribute is the maximum number of Done iterations that will be loaded/shown/included in these areas.

description

extended string[140] in the request body.
— A description of the project's content. Entered through the web UI on the Project Settings page.

profile_content

extended string[65535] in the request body.
— A long description of the project. This is displayed on the Project Overview page in the Tracker web UI.

enable_incoming_emails

boolean in the request body.
— When true, the project will accept incoming email responses to Tracker notification emails and convert them to comments on the appropriate stories.

initial_velocity

int in the request body.
— The number which should be used as the project's velocity when there are not enough recent iterations with Done stories for an actual velocity to be computed.

project_type

enumerated string in the request body.
— The project's type which determines visibility and permissions [demo is deprecated].

Valid enumeration values: demo, private, public, shared

public

boolean in the request body.
— When true, Tracker will allow any user on the web to view the content of the project. The project will not count toward the limits of a paid subscription, and may be included on Tracker's Public Projects listing page.

atom_enabled

boolean in the request body.
— When true, Tracker allows people to subscribe to the Atom (RSS, XML) feed of project changes.

account_id

int in the request body.
— The ID number for the account which contains the project.

join_as

enumerated string in the request body.
— The default join_as value for the project [viewer, member].

Valid enumeration values: owner, member, viewer

The new project is created with the currently-authenticated user as its original Owner. The server will supply a default value for any optional parameter that the request doesn't include. The default values are not defined as part of the API--they may change from time to time without an increase in the current API version number. Additionally, new project attributes may be added at any time without advance notice. The client will know what values the server has supplied from the response to the request. If the value set for a project attribute is important to an application, it should be included explicitly in the request without relying on the server to supply the default.

Project

ENDPOINT

/projects/{project_id}

GET Fetch the content of the specified project.
PUT Update the specified project.
DELETE Permanently delete the specified project.

Access the project specified by the project_id value in the URL.


export TOKEN='your Pivotal Tracker API token'
curl -X GET -H "X-TrackerToken: $TOKEN" "https://www.pivotaltracker.com/services/v5/projects/99"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 66
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"account_id":100,"atom_enabled":true,"automatic_planning":true,"bugs_and_chores_are_estimatable":false,"created_at":"2024-08-20T12:00:05Z","current_iteration_number":15,"description":"Expeditionary Battle Planetoid","enable_following":true,"enable_incoming_emails":true,"enable_tasks":true,"has_google_domain":false,"id":99,"initial_velocity":10,"iteration_length":1,"kind":"project","name":"Death Star","number_of_done_iterations_to_show":4,"point_scale":"0,1,2,3","point_scale_is_custom":false,"profile_content":"This is a machine of war such as the universe has never known. It's colossal, the size of a class-four moon. And it possesses firepower unequaled in the history of warfare.","project_type":"private","public":false,"show_priority_icon":false,"show_priority_icon_in_all_panels":true,"show_story_priority":true,"start_date":"2024-05-06","start_time":"2024-08-20T12:00:10Z","time_zone":{"kind":"time_zone","olson_name":"America/Los_Angeles","offset":"-07:00"},"updated_at":"2024-08-20T12:00:10Z","velocity_averaged_over":3,"version":66,"week_start_day":"Monday"}

Successful responses to this request return the project resource.

PARAMETERS

project_id

int in the request path.
required — The ID of the project.


export TOKEN='your Pivotal Tracker API token'
curl -X PUT -H "X-TrackerToken: $TOKEN" -H "Content-Type: application/json" -d '{"name":"totally a new project name"}' "https://www.pivotaltracker.com/services/v5/projects/99"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 67
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"account_id":100,"atom_enabled":true,"automatic_planning":true,"bugs_and_chores_are_estimatable":false,"created_at":"2024-08-20T12:00:05Z","current_iteration_number":15,"description":"Expeditionary Battle Planetoid","enable_following":true,"enable_incoming_emails":true,"enable_tasks":true,"has_google_domain":false,"id":99,"initial_velocity":10,"iteration_length":1,"kind":"project","name":"totally a new project name","number_of_done_iterations_to_show":4,"point_scale":"0,1,2,3","point_scale_is_custom":false,"profile_content":"This is a machine of war such as the universe has never known. It's colossal, the size of a class-four moon. And it possesses firepower unequaled in the history of warfare.","project_type":"private","public":false,"show_priority_icon":false,"show_priority_icon_in_all_panels":true,"show_story_priority":true,"start_date":"2024-05-06","start_time":"2024-08-20T12:00:00Z","time_zone":{"kind":"time_zone","olson_name":"America/Los_Angeles","offset":"-07:00"},"updated_at":"2024-08-20T12:00:10Z","velocity_averaged_over":3,"version":67,"week_start_day":"Monday"}

Successful responses to this request return the project resource.

PARAMETERS

project_id

int in the request path.
required — The ID of the project.

name

extended string[50] in the request body.
— The name of the project.

status

string in the request body.
— The status of the project.

iteration_length

int in the request body.
— The number of weeks in an iteration.

week_start_day

enumerated string in the request body.
— The day in the week the project's iterations are to start on.

Valid enumeration values: Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday

point_scale

bugs_and_chores_are_estimatable

boolean in the request body.
— When true, Tracker will allow estimates to be set on Bug- and Chore-type stories. This is strongly not recommended. Please see the FAQ for more information.

automatic_planning

enable_tasks

boolean in the request body.
— When true, Tracker allows individual tasks to be created and managed within each story in the project.

show_story_priority

boolean in the request body.
— When true, Tracker allows Priority field to be hidden within each story in the project.

show_priority_icon

boolean in the request body.
— When true, Tracker allows Priority field to be hidden within each story in the project.

show_priority_icon_in_all_panels

boolean in the request body.
— When true, Tracker allows Priority field to be hidden within each story in the project.

start_date

time_zone

time_zone in the request body.
— The "native" time zone for the project, independent of the time zone(s) from which members of the project view or modify it.

velocity_averaged_over

int in the request body.
— 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.

number_of_done_iterations_to_show

description

extended string[140] in the request body.
— A description of the project's content. Entered through the web UI on the Project Settings page.

profile_content

extended string[65535] in the request body.
— A long description of the project. This is displayed on the Project Overview page in the Tracker web UI.

enable_incoming_emails

boolean in the request body.
— When true, the project will accept incoming email responses to Tracker notification emails and convert them to comments on the appropriate stories.

initial_velocity

int in the request body.
— The number which should be used as the project's velocity when there are not enough recent iterations with Done stories for an actual velocity to be computed.

project_type

enumerated string in the request body.
— The project's type which determines visibility and permissions [demo is deprecated].

Valid enumeration values: demo, private, public, shared

public

atom_enabled

boolean in the request body.
— When true, Tracker allows people to subscribe to the Atom (RSS, XML) feed of project changes.

account_id

int in the request body.
— The ID number for the account which contains the project.

join_as

enumerated string in the request body.
— The default join_as value for the project [viewer, member].

Valid enumeration values: owner, member, viewer


export TOKEN='your Pivotal Tracker API token'
curl -X DELETE -H "X-TrackerToken: $TOKEN" -H "Content-Type: application/json" "https://www.pivotaltracker.com/services/v5/projects/99"



  
    View Response
  

  
    Hide Response

    
      status: 204
    

    
      Headers
        X-Tracker-Project-Version: 67
        Content-Type: application/json; potentially-other-variable-stuff

PARAMETERS

project_id

int in the request path.
required — The ID of the project.

Iterations

ENDPOINT

/projects/{project_id}/iterations

GET Return a set of iterations from the project. (Paginated)

Allows iterations to be retrieved, with optional scope, limit and offset. For the 'Done' scope, a negative offset can be passed, which specifies the number of iterations preceding the 'Current' iteration. Note that iterations are ordered with the oldest (lowest iteration number) first.


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
curl -X GET -H "X-TrackerToken: $TOKEN" "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/iterations?limit=10&offset=1"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Pagination-Limit: 10
        X-Tracker-Pagination-Offset: 1
        X-Tracker-Pagination-Total: 17
        X-Tracker-Pagination-Returned: 10
        X-Tracker-Project-Version: 66
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           [{"number":2,"project_id":99,"length":1,"team_strength":1,"stories":[{"kind":"story","id":563,"created_at":"2024-08-20T12:01:00Z","updated_at":"2024-08-20T12:01:00Z","accepted_at":"2024-08-20T12:00:05Z","estimate":3,"story_type":"feature","story_priority":"p3","name":"Complete construction of the Expeditionary Battle Planetoid","description":"Palpatine was impressed with the PoC, make this one bigger","current_state":"accepted","requested_by_id":102,"external_id":"abc123","integration_id":30,"url":"http://localhost/story/show/563","project_id":99,"owner_ids":[102,101],"labels":[{"id":2009,"project_id":99,"kind":"label","name":"plans","created_at":"2024-08-20T12:01:00Z","updated_at":"2024-08-20T12:01:00Z"}],"owned_by_id":102}],"start":"2024-08-20T12:01:00Z","finish":"2024-08-20T12:00:10Z","kind":"iteration"},{"number":3,"project_id":99,"length":1,"team_strength":1,"stories":[],"start":"2024-08-20T12:00:10Z","finish":"2024-08-20T12:00:15Z","kind":"iteration"},{"number":4,"project_id":99,"length":1,"team_strength":1,"stories":[],"start":"2024-08-20T12:00:15Z","finish":"2024-08-20T12:00:20Z","kind":"iteration"},{"number":5,"project_id":99,"length":1,"team_strength":1,"stories":[],"start":"2024-08-20T12:00:20Z","finish":"2024-08-20T12:00:25Z","kind":"iteration"},{"number":6,"project_id":99,"length":1,"team_strength":1,"stories":[],"start":"2024-08-20T12:00:25Z","finish":"2024-08-20T12:00:30Z","kind":"iteration"},{"number":7,"project_id":99,"length":1,"team_strength":1,"stories":[],"start":"2024-08-20T12:00:30Z","finish":"2024-08-20T12:00:35Z","kind":"iteration"},{"number":8,"project_id":99,"length":1,"team_strength":1,"stories":[],"start":"2024-08-20T12:00:35Z","finish":"2024-08-20T12:00:40Z","kind":"iteration"},{"number":9,"project_id":99,"length":1,"team_strength":1,"stories":[],"start":"2024-08-20T12:00:40Z","finish":"2024-08-20T12:00:45Z","kind":"iteration"},{"number":10,"project_id":99,"length":1,"team_strength":1,"stories":[],"start":"2024-08-20T12:00:45Z","finish":"2024-08-20T12:00:50Z","kind":"iteration"},{"number":11,"project_id":99,"length":1,"team_strength":1,"stories":[],"start":"2024-08-20T12:00:50Z","finish":"2024-08-20T12:00:55Z","kind":"iteration"}]

Successful responses to this request return an array containing zero or more instances of the iteration resource. The response from this request is paginated, see Paginating List Responses.

PARAMETERS

project_id

int in the request path.
required — The ID of the project.

offset

int in the request query.
— The offset of first iteration to return, relative to the set of iterations specified by 'scope', with zero being the first iteration in the scope. Defaults to zero. For the 'Done' scope, negative numbers can be passed, which specifies the number of iterations preceding the 'Current' iteration.

label

extended string in the request query.
— The label to filter on

limit

int in the request query.
— The number of iterations to return relative to the offset.

scope

enumerated string in the request query.
— Restricts the state of iterations to return. If not specified, it defaults to all iterations including done.

Valid enumeration values: done, current, backlog, current_backlog, done_current

ENDPOINT

/projects/{project_id}/iterations/{iteration_number}

GET Return an iteration from the project.

Allows an iteration to be retrieved.


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
curl -X GET -H "X-TrackerToken: $TOKEN" "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/iterations/15"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 66
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"finish":"2024-08-20T12:00:10Z","kind":"iteration","length":1,"number":15,"project_id":99,"start":"2024-08-20T12:00:05Z","stories":[{"kind":"story","id":558,"project_id":99,"name":"Contact Lando","story_type":"feature","current_state":"accepted","estimate":1,"accepted_at":"2024-08-20T12:00:05Z","requested_by_id":101,"owner_ids":[],"labels":[],"created_at":"2024-08-20T12:00:05Z","updated_at":"2024-08-20T12:00:05Z","url":"http://localhost/story/show/558","story_priority":"p3"},{"kind":"story","id":560,"project_id":99,"name":"Destroy Alderaan","description":"Dantooine is too remote to make an effective demonstration.","story_type":"feature","current_state":"accepted","estimate":1,"accepted_at":"2024-08-20T12:00:05Z","requested_by_id":102,"owned_by_id":101,"owner_ids":[101,105],"labels":[{"kind":"label","id":2008,"project_id":99,"name":"rebel bases","created_at":"2024-08-20T12:00:05Z","updated_at":"2024-08-20T12:00:05Z"}],"created_at":"2024-08-20T12:00:05Z","updated_at":"2024-08-20T12:00:05Z","url":"http://localhost/story/show/560","story_priority":"p3"},{"kind":"story","id":556,"project_id":99,"name":"Interrogate Leia Organa","description":"She is proving to be resistant to our mind probes","story_type":"feature","current_state":"started","estimate":2,"requested_by_id":101,"owned_by_id":101,"owner_ids":[101,105],"labels":[{"kind":"label","id":2009,"project_id":99,"name":"plans","created_at":"2024-08-20T12:00:05Z","updated_at":"2024-08-20T12:00:05Z"},{"kind":"label","id":2008,"project_id":99,"name":"rebel bases","created_at":"2024-08-20T12:00:05Z","updated_at":"2024-08-20T12:00:05Z"}],"created_at":"2024-08-20T12:00:05Z","updated_at":"2024-08-20T12:00:05Z","url":"http://localhost/story/show/556","story_priority":"p3"},{"kind":"story","id":559,"project_id":99,"name":"All exhaust ports should be shielded","description":"ray shielded, that is.","story_type":"feature","current_state":"rejected","estimate":3,"requested_by_id":102,"owned_by_id":104,"owner_ids":[104],"labels":[{"kind":"label","id":2009,"project_id":99,"name":"plans","created_at":"2024-08-20T12:00:05Z","updated_at":"2024-08-20T12:00:05Z"}],"created_at":"2024-08-20T12:00:05Z","updated_at":"2024-08-20T12:00:05Z","url":"http://localhost/story/show/559","story_priority":"p3"}],"team_strength":1}


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
curl -X GET -H "X-TrackerToken: $TOKEN" "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/iterations/15?fields=number%2Cproject_id%2Clength%2Cteam_strength%2Cstories%2Cstart%2Cfinish%2Ckind%2Cvelocity"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 66
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"finish":"2024-08-20T12:00:10Z","kind":"iteration","length":1,"number":15,"project_id":99,"start":"2024-08-20T12:00:05Z","stories":[{"kind":"story","id":558,"project_id":99,"name":"Contact Lando","story_type":"feature","current_state":"accepted","estimate":1,"accepted_at":"2024-08-20T12:00:05Z","requested_by_id":101,"owner_ids":[],"labels":[],"created_at":"2024-08-20T12:00:05Z","updated_at":"2024-08-20T12:00:05Z","url":"http://localhost/story/show/558","story_priority":"p3"},{"kind":"story","id":560,"project_id":99,"name":"Destroy Alderaan","description":"Dantooine is too remote to make an effective demonstration.","story_type":"feature","current_state":"accepted","estimate":1,"accepted_at":"2024-08-20T12:00:05Z","requested_by_id":102,"owned_by_id":101,"owner_ids":[101,105],"labels":[{"kind":"label","id":2008,"project_id":99,"name":"rebel bases","created_at":"2024-08-20T12:00:05Z","updated_at":"2024-08-20T12:00:05Z"}],"created_at":"2024-08-20T12:00:05Z","updated_at":"2024-08-20T12:00:05Z","url":"http://localhost/story/show/560","story_priority":"p3"},{"kind":"story","id":556,"project_id":99,"name":"Interrogate Leia Organa","description":"She is proving to be resistant to our mind probes","story_type":"feature","current_state":"started","estimate":2,"requested_by_id":101,"owned_by_id":101,"owner_ids":[101,105],"labels":[{"kind":"label","id":2009,"project_id":99,"name":"plans","created_at":"2024-08-20T12:00:05Z","updated_at":"2024-08-20T12:00:05Z"},{"kind":"label","id":2008,"project_id":99,"name":"rebel bases","created_at":"2024-08-20T12:00:05Z","updated_at":"2024-08-20T12:00:05Z"}],"created_at":"2024-08-20T12:00:05Z","updated_at":"2024-08-20T12:00:05Z","url":"http://localhost/story/show/556","story_priority":"p3"},{"kind":"story","id":559,"project_id":99,"name":"All exhaust ports should be shielded","description":"ray shielded, that is.","story_type":"feature","current_state":"rejected","estimate":3,"requested_by_id":102,"owned_by_id":104,"owner_ids":[104],"labels":[{"kind":"label","id":2009,"project_id":99,"name":"plans","created_at":"2024-08-20T12:00:05Z","updated_at":"2024-08-20T12:00:05Z"}],"created_at":"2024-08-20T12:00:05Z","updated_at":"2024-08-20T12:00:05Z","url":"http://localhost/story/show/559","story_priority":"p3"}],"team_strength":1,"velocity":1}

Successful responses to this request return the iteration resource.

PARAMETERS

project_id

int in the request path.
required — The ID of the project.

iteration_number

int in the request path.
required — The iteration number.

label

extended string in the request query.
— The label to filter on

ENDPOINT

/projects/{project_id}/iteration_overrides/{iteration_number}

PUT Updates an iteration's overrides.

Operations on an individual iteration's overrides.


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
curl -X PUT -H "X-TrackerToken: $TOKEN" -H "Content-Type: application/json" -d '{"length":5,"team_strength":0.7}' "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/iteration_overrides/3"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 67
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"kind":"iteration_override","length":5,"number":3,"project_id":99,"team_strength":0.7}

Successful responses to this request return the iteration_override resource.

PARAMETERS

project_id

int in the request path.
required — The ID of the project.

iteration_number

int in the request path.
required — The iteration number.

length

int in the request body.
— Iteration length in weeks.

team_strength

float in the request body.
— Iteration team strength, 1.0 is full-strength.

ENDPOINT

/projects/{project_id}/iterations/{iteration_number}/analytics

GET Gets the analytics for the specified iteration in a given project.

Gets analytics for the specified iteration. The iteration must fall entirely within the last six months.


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
export ITERATION_ID=15
curl -X GET -H "X-TrackerToken: $TOKEN" "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/iterations/$ITERATION_ID/analytics"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 66
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"bugs_created":2,"cycle_time":0,"kind":"analytics","rejection_rate":25.0,"stories_accepted":2}


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
export ITERATION_ID=15
curl -X GET -H "X-TrackerToken: $TOKEN" "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/iterations/$ITERATION_ID/analytics.csv"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        Content-Disposition: attachment; filename="analytics.csv"
        Content-Type: text/csv
    

       Response Body
         
           stories_accepted,bugs_created,cycle_time,rejection_rate
2,2,0,25.0

Successful responses to this request return the analytics resource. The response from this request can be encoded in CSV, see CSV Response Format.

PARAMETERS

project_id

int in the request path.
required — The ID of the project.

iteration_number

int in the request path.
required — The iteration number.

ENDPOINT

/projects/{project_id}/iterations/{iteration_number}/analytics/cycle_time_details

GET Gets the cycle time details for a given project's started stories, in the specified iteration.

Gets cycle time details for the stories in the specified iteration. The iteration must fall entirely within the last six months.


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=101
export ITERATION_ID=3
curl -X GET -H "X-TrackerToken: $TOKEN" "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/iterations/$ITERATION_ID/analytics/cycle_time_details"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 303
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           [{"kind":"cycle_time_details","total_cycle_time":309600000,"started_time":91880000,"started_count":1,"finished_time":217720000,"finished_count":1,"delivered_time":0,"delivered_count":1,"rejected_time":0,"rejected_count":0,"story_id":2141},{"kind":"cycle_time_details","total_cycle_time":550800000,"started_time":432000000,"started_count":1,"finished_time":0,"finished_count":1,"delivered_time":118800000,"delivered_count":1,"rejected_time":0,"rejected_count":0,"story_id":2117},{"kind":"cycle_time_details","total_cycle_time":646068000,"started_time":214068000,"started_count":1,"finished_time":473000,"finished_count":2,"delivered_time":222727000,"delivered_count":2,"rejected_time":208800000,"rejected_count":1,"story_id":2144},{"kind":"cycle_time_details","total_cycle_time":649693000,"started_time":217693000,"started_count":1,"finished_time":209418000,"finished_count":1,"delivered_time":222582000,"delivered_count":1,"rejected_time":0,"rejected_count":0,"story_id":2142},{"kind":"cycle_time_details","total_cycle_time":1328400000,"started_time":1328400000,"started_count":1,"finished_time":0,"finished_count":0,"delivered_time":0,"delivered_count":0,"rejected_time":0,"rejected_count":0,"story_id":2115},{"kind":"cycle_time_details","total_cycle_time":881149000,"started_time":525367000,"started_count":1,"finished_time":21745000,"finished_count":1,"delivered_time":334037000,"delivered_count":1,"rejected_time":0,"rejected_count":0,"story_id":2119}]


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
export ITERATION_ID=15
curl -X GET -H "X-TrackerToken: $TOKEN" "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/iterations/$ITERATION_ID/analytics/cycle_time_details.csv"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        Content-Disposition: attachment; filename="cycle_time_details.csv"
        Content-Type: text/csv
    

       Response Body
         
           State,Type,Estimate,Title,ID,Labels,Total Cycle Time (Seconds),Started Time (Seconds),Started Count,Finished Time (Seconds),Finished Count,Delivered Time (Seconds),Delivered Count,Rejected Time (Seconds),Rejected Count,Owned By,Owned By
accepted,feature,1,Contact Lando,558,"r&d,rebel bases",,0,0,0,0,0,0,0,0,,
accepted,feature,1,Destroy Alderaan,560,rebel bases,,0,1,0,1,0,1,0,0,Darth Vader,Robotic Maintenance Team 4
started,feature,2,Interrogate Leia Organa,556,"plans,rebel bases",86400,86400,1,0,0,0,0,0,0,Darth Vader,Robotic Maintenance Team 4
rejected,bug,,All exhaust ports should be shielded,559,plans,86400,0,1,0,1,0,1,86400,1,Darth Vader,Moradmin Bast

Successful responses to this request return an array containing zero or more instances of the cycle_time_details resource. The response from this request can be encoded in CSV, see CSV Response Format.

PARAMETERS

project_id

int in the request path.
required — The ID of the project.

iteration_number

int in the request path.
required — The iteration number.

Project Memberships

ENDPOINT

/projects/{project_id}/memberships

POST Add a user to the project
GET List all of the memberships in a project

Membership operations.

Note that currently none of our endpoints will return memberships marked as inactive for a person. This is likely to change with future additions to the V5 API, but as of right now, no responses should contain references to users who do not have active access to your project.


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
curl -X POST -H "X-TrackerToken: $TOKEN" -H "Content-Type: application/json" -d '{"email":"marek@sith.mil","role":"member"}' "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/memberships"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 67
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"created_at":"2024-08-20T12:00:00Z","favorite":false,"id":16200,"kind":"project_membership","person":{"kind":"person","id":106,"name":"Galen Marek","email":"marek@sith.mil","initials":"GM","username":"starkiller"},"project_color":"b800bb","project_id":99,"role":"member","updated_at":"2024-08-20T12:00:00Z","wants_comment_notification_emails":true,"will_receive_mention_notifications_or_emails":true}

Successful responses to this request return the project_membership resource.

PARAMETERS

project_id

int in the request path.
required — The ID of the project.

role

enumerated string in the request query.
— The role the user will assume on the project.

Valid enumeration values: owner, member, viewer

string in the request query.
— The email address of a new/existing Tracker user to be added to this project.

name

string in the request query.
— The name to be given to a new Tracker user, should a user with the given email address not already exist.

initials

string in the request query.
— The initials to be given to a new Tracker user, should a user with the given email address not already exist.

project_color

string in the request query.
— The hex-value color to give the project in multi-project views

favorite

boolean in the request query.
— The boolean to determine is a one of a user's favorites


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
curl -X GET -H "X-TrackerToken: $TOKEN" "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/memberships"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 66
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           [{"kind":"project_membership","project_id":99,"id":100,"last_viewed_at":"2024-08-20T12:00:10Z","created_at":"2024-08-20T12:00:10Z","updated_at":"2024-08-20T12:00:10Z","role":"owner","project_color":"8100ea","favorite":false,"wants_comment_notification_emails":false,"will_receive_mention_notifications_or_emails":true,"person":{"kind":"person","id":100,"name":"Emperor Palpatine","email":"emperor@galacticrepublic.gov","initials":"EP","username":"palpatine"}},{"kind":"project_membership","project_id":99,"id":101,"last_viewed_at":"2024-08-20T12:00:10Z","created_at":"2024-08-20T12:00:10Z","updated_at":"2024-08-20T12:00:10Z","role":"member","project_color":"8100ea","favorite":false,"wants_comment_notification_emails":true,"will_receive_mention_notifications_or_emails":true,"person":{"kind":"person","id":101,"name":"Darth Vader","email":"vader@deathstar.mil","initials":"DV","username":"vader"}},{"kind":"project_membership","project_id":99,"id":102,"last_viewed_at":"2024-08-20T12:00:10Z","created_at":"2024-08-20T12:00:10Z","updated_at":"2024-08-20T12:00:10Z","role":"owner","project_color":"8100ea","favorite":false,"wants_comment_notification_emails":false,"will_receive_mention_notifications_or_emails":true,"person":{"kind":"person","id":102,"name":"Wilhuff Tarkin","email":"governor@eriadu.gov","initials":"WT","username":"tarkin"}},{"kind":"project_membership","project_id":99,"id":103,"last_viewed_at":"2024-08-20T12:00:10Z","created_at":"2024-08-20T12:00:10Z","updated_at":"2024-08-20T12:00:10Z","role":"member","project_color":"8100ea","favorite":false,"wants_comment_notification_emails":true,"will_receive_mention_notifications_or_emails":true,"person":{"kind":"person","id":104,"name":"Clone TK421","email":"tk421@deathstar.mil","initials":"TK421","username":"tk421"}},{"kind":"project_membership","project_id":99,"id":104,"last_viewed_at":"2024-08-20T12:00:10Z","created_at":"2024-08-20T12:00:10Z","updated_at":"2024-08-20T12:00:10Z","role":"member","project_color":"8100ea","favorite":false,"wants_comment_notification_emails":true,"will_receive_mention_notifications_or_emails":true,"person":{"kind":"person","id":103,"name":"Moradmin Bast","email":"bast@deathstar.mil","initials":"MB","username":"bast"}},{"kind":"project_membership","project_id":99,"id":105,"last_viewed_at":"2024-08-20T12:00:10Z","created_at":"2024-08-20T12:00:10Z","updated_at":"2024-08-20T12:00:10Z","role":"member","project_color":"8100ea","favorite":false,"wants_comment_notification_emails":true,"will_receive_mention_notifications_or_emails":true,"person":{"kind":"person","id":105,"name":"Robotic Maintenance Team 4","email":"I662@deathstar.mil","initials":"i662","username":"i662"}},{"kind":"project_membership","project_id":99,"id":107,"last_viewed_at":"2024-08-20T12:00:05Z","created_at":"2024-08-20T12:00:10Z","updated_at":"2024-08-20T12:00:10Z","role":"viewer","project_color":"8100ea","favorite":false,"wants_comment_notification_emails":false,"will_receive_mention_notifications_or_emails":true,"person":{"kind":"person","id":107,"name":"Bevel Lemelisk","email":"bevel@sith.mil","initials":"bl","username":"bevel"}}]

Successful responses to this request return the project_membership resource.

PARAMETERS

project_id

int in the request path.
required — The ID of the project.

sort_by

enumerated string in the request query.
— The field to sort by. Default is id

Valid enumeration values: name

ENDPOINT

/projects/{project_id}/memberships/{membership_id}

GET Returns the specified project membership
DELETE Deletes the specified project membership
PUT Updates the specified project membership

Membership operations.


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
curl -X GET -H "X-TrackerToken: $TOKEN" "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/memberships/102"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 66
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"created_at":"2024-08-20T12:00:05Z","favorite":false,"id":102,"kind":"project_membership","last_viewed_at":"2024-08-20T12:00:05Z","person":{"kind":"person","id":102,"name":"Wilhuff Tarkin","email":"governor@eriadu.gov","initials":"WT","username":"tarkin"},"project_color":"8100ea","project_id":99,"role":"owner","updated_at":"2024-08-20T12:00:05Z","wants_comment_notification_emails":false,"will_receive_mention_notifications_or_emails":true}

Successful responses to this request return the project_membership resource.

PARAMETERS

project_id

int in the request path.
required — The ID of the project.

membership_id

int in the request path.
required — The ID of the membership.


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
curl -X DELETE -H "X-TrackerToken: $TOKEN" -H "Content-Type: application/json" "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/memberships/104"



  
    View Response
  

  
    Hide Response

    
      status: 204
    

    
      Headers
        X-Tracker-Project-Version: 67
        Content-Type: application/json; potentially-other-variable-stuff

PARAMETERS

project_id

int in the request path.
required — The ID of the project.

membership_id

int in the request path.
required — The ID of the membership.


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
curl -X PUT -H "X-TrackerToken: $TOKEN" -H "Content-Type: application/json" -d '{"role":"viewer"}' "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/memberships/104"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 67
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"created_at":"2024-08-20T12:00:05Z","favorite":false,"id":104,"kind":"project_membership","last_viewed_at":"2024-08-20T12:00:05Z","person":{"kind":"person","id":103,"name":"Moradmin Bast","email":"bast@deathstar.mil","initials":"MB","username":"bast"},"project_color":"8100ea","project_id":99,"role":"viewer","updated_at":"2024-08-20T12:00:10Z","wants_comment_notification_emails":true,"will_receive_mention_notifications_or_emails":true}


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
curl -X PUT -H "X-TrackerToken: $TOKEN" -H "Content-Type: application/json" -d '{"favorite":true,"project_color":"ffffff"}' "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/memberships/104"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 66
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"created_at":"2024-08-20T12:00:05Z","favorite":true,"id":104,"kind":"project_membership","last_viewed_at":"2024-08-20T12:00:05Z","person":{"kind":"person","id":103,"name":"Moradmin Bast","email":"bast@deathstar.mil","initials":"MB","username":"bast"},"project_color":"ffffff","project_id":99,"role":"member","updated_at":"2024-08-20T12:00:10Z","wants_comment_notification_emails":true,"will_receive_mention_notifications_or_emails":true}

Successful responses to this request return the project_membership resource.

PARAMETERS

project_id

int in the request path.
required — The ID of the project.

membership_id

int in the request path.
required — The ID of the membership.

role

enumerated string in the request body.
— The role the user will assume on the project

Valid enumeration values: owner, member, viewer

project_color

string in the request body.
— The hex-value color to give the project in multi-project views

favorite

boolean in the request query.
— The boolean to determine is a one of a user's favorites

Account Memberships

ENDPOINT

/accounts/{account_id}/memberships

GET List all of the memberships in an account.
POST Create a new membership in an account.

Membership operations.


export TOKEN='your Pivotal Tracker API token'
export ACCOUNT_ID=100
curl -X GET -H "X-TrackerToken: $TOKEN" "https://www.pivotaltracker.com/services/v5/accounts/$ACCOUNT_ID/memberships"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           [{"kind":"account_membership","id":100,"person":{"kind":"person","id":100,"name":"Emperor Palpatine","email":"emperor@galacticrepublic.gov","initials":"EP","username":"palpatine"},"account_id":100,"created_at":"2024-08-20T12:00:00Z","updated_at":"2024-08-20T12:00:00Z","owner":true,"admin":false,"project_creator":false},{"kind":"account_membership","id":101,"person":{"kind":"person","id":101,"name":"Darth Vader","email":"vader@deathstar.mil","initials":"DV","username":"vader"},"account_id":100,"created_at":"2024-08-20T12:00:00Z","updated_at":"2024-08-20T12:00:00Z","owner":false,"admin":true,"project_creator":false},{"kind":"account_membership","id":102,"person":{"kind":"person","id":102,"name":"Wilhuff Tarkin","email":"governor@eriadu.gov","initials":"WT","username":"tarkin"},"account_id":100,"created_at":"2024-08-20T12:00:00Z","updated_at":"2024-08-20T12:00:00Z","owner":false,"admin":false,"project_creator":false},{"kind":"account_membership","id":103,"person":{"kind":"person","id":103,"name":"Moradmin Bast","email":"bast@deathstar.mil","initials":"MB","username":"bast"},"account_id":100,"created_at":"2024-08-20T12:00:00Z","updated_at":"2024-08-20T12:00:00Z","owner":false,"admin":false,"project_creator":false},{"kind":"account_membership","id":104,"person":{"kind":"person","id":104,"name":"Clone TK421","email":"tk421@deathstar.mil","initials":"TK421","username":"tk421"},"account_id":100,"created_at":"2024-08-20T12:00:00Z","updated_at":"2024-08-20T12:00:00Z","owner":false,"admin":false,"project_creator":false},{"kind":"account_membership","id":106,"person":{"kind":"person","id":106,"name":"Galen Marek","email":"marek@sith.mil","initials":"GM","username":"starkiller"},"account_id":100,"created_at":"2024-08-20T12:00:00Z","updated_at":"2024-08-20T12:00:00Z","owner":false,"admin":false,"project_creator":false},{"kind":"account_membership","id":109,"person":{"kind":"person","id":109,"name":"3D-4X administrative droid","email":"threedeefourx@sith.mil","initials":"3D4X","username":"threedeefourx"},"account_id":100,"created_at":"2024-08-20T12:00:00Z","updated_at":"2024-08-20T12:00:00Z","owner":false,"admin":true,"project_creator":false}]

Successful responses to this request return the account_membership resource.

PARAMETERS

account_id

int in the request path.
required — The ID of the account.


export TOKEN='your Pivotal Tracker API token'
export ACCOUNT_ID=100
curl -X POST -H "X-TrackerToken: $TOKEN" -H "Content-Type: application/json" -d '{"email":"dooku@example.com","initials":"CD","name":"Count Dooku"}' "https://www.pivotaltracker.com/services/v5/accounts/$ACCOUNT_ID/memberships"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"account_id":100,"admin":false,"created_at":"2024-08-20T12:00:00Z","id":19200,"kind":"account_membership","owner":false,"person":{"kind":"person","id":1900,"name":"Count Dooku","email":"dooku@example.com","initials":"CD","username":"countd"},"project_creator":false,"updated_at":"2024-08-20T12:00:00Z"}


export TOKEN='your Pivotal Tracker API token'
export ACCOUNT_ID=100
curl -X POST -H "X-TrackerToken: $TOKEN" -H "Content-Type: application/json" -d '{"email":"monmothma@example.com","initials":"MM","name":"Mon Mothma"}' "https://www.pivotaltracker.com/services/v5/accounts/$ACCOUNT_ID/memberships"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"account_id":100,"admin":false,"created_at":"2024-08-20T12:00:00Z","id":19200,"kind":"account_membership","owner":false,"person":{"kind":"person","id":108,"name":"Mon Mothma","email":"monmothma@example.com","initials":"MM","username":"monmothma"},"project_creator":false,"updated_at":"2024-08-20T12:00:00Z"}

Successful responses to this request return the account_membership resource.

PARAMETERS

account_id

int in the request path.
required — The ID of the account.

string in the request body.
— The email address of a new/existing Tracker user to be added to this account.

name

string in the request body.
— The name to be given to a new Tracker user, should a user with the given email address not already exist.

initials

string in the request body.
— The initials to be given to a new Tracker user, should a user with the given email address not already exist.

admin

boolean in the request body.
— True if the person has administrative rights on the account.

project_creator

boolean in the request body.
— True if the person is allowed to create new projects within the account.

ENDPOINT

/accounts/{account_id}/memberships/{person_id}

GET Returns the specified account membership.
PUT Updates the specified account membership.
DELETE Delete the specified account membership.

Get an individual account membership, requested by the person_id.


export TOKEN='your Pivotal Tracker API token'
export ACCOUNT_ID=100
curl -X GET -H "X-TrackerToken: $TOKEN" "https://www.pivotaltracker.com/services/v5/accounts/$ACCOUNT_ID/memberships/101"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"account_id":100,"admin":true,"created_at":"2024-08-20T12:00:00Z","id":101,"kind":"account_membership","owner":false,"person":{"kind":"person","id":101,"name":"Darth Vader","email":"vader@deathstar.mil","initials":"DV","username":"vader"},"project_creator":false,"updated_at":"2024-08-20T12:00:00Z"}

Successful responses to this request return the account_membership resource.

PARAMETERS

account_id

int in the request path.
required — The ID of the account.

person_id

int in the request path.
required — The ID of the person.


export TOKEN='your Pivotal Tracker API token'
export ACCOUNT_ID=100
curl -X PUT -H "X-TrackerToken: $TOKEN" -H "Content-Type: application/json" -d '{"project_creator":true}' "https://www.pivotaltracker.com/services/v5/accounts/$ACCOUNT_ID/memberships/103"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"account_id":100,"admin":false,"created_at":"2024-08-20T12:00:00Z","id":103,"kind":"account_membership","owner":false,"person":{"kind":"person","id":103,"name":"Moradmin Bast","email":"bast@deathstar.mil","initials":"MB","username":"bast"},"project_creator":true,"updated_at":"2024-08-20T12:00:05Z"}

Successful responses to this request return the account_membership resource.

PARAMETERS

account_id

int in the request path.
required — The ID of the account.

person_id

int in the request path.
required — The ID of the person.

admin

boolean in the request body.
— True if the person has administrative rights on the account.

project_creator

boolean in the request body.
— True if the person is allowed to create new projects within the account.


export TOKEN='your Pivotal Tracker API token'
export ACCOUNT_ID=100
curl -X DELETE -H "X-TrackerToken: $TOKEN" -H "Content-Type: application/json" "https://www.pivotaltracker.com/services/v5/accounts/$ACCOUNT_ID/memberships/104"



  
    View Response
  

  
    Hide Response

    
      status: 204
    

    
      Headers
        Content-Type: application/json; potentially-other-variable-stuff

PARAMETERS

account_id

int in the request path.
required — The ID of the account.

person_id

int in the request path.
required — The ID of the person.

Accounts

ENDPOINT

/accounts

GET Get all the accounts of which a user is an owner or admin.

Access a user's accounts


export TOKEN='your Pivotal Tracker API token'
curl -X GET -H "X-TrackerToken: $TOKEN" "https://www.pivotaltracker.com/services/v5/accounts"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           [{"kind":"account","id":100,"name":"Galactic Empire","plan":"Enterprise","status":"active","created_at":"2024-08-20T12:00:00Z","updated_at":"2024-08-20T12:00:00Z"}]

Successful responses to this request return an array containing zero or more instances of the account resource.

ENDPOINT

/account_summaries

GET Fetch the summary of the accounts you are a member of.

Access the account summaries that you are a member of.


export TOKEN='your Pivotal Tracker API token'
curl -X GET -H "X-TrackerToken: $TOKEN" "https://www.pivotaltracker.com/services/v5/account_summaries?with_permission=project_creation"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           [{"kind":"account_summary","id":100,"name":"Galactic Empire","status":"active","plan":"Enterprise"},{"kind":"account_summary","id":1901,"name":"Tarkin Project","status":"active","plan":"Free"},{"kind":"account_summary","id":1902,"name":"Empire Operations","status":"active","plan":"Free"}]

Successful responses to this request return an array containing zero or more instances of the account_summary resource.

PARAMETERS

with_permission

enumerated string in the request query.
— Find accounts where you have the specified permission.

Valid enumeration values: none, project_creation, administration

When the owner_id and/or admin_ids associations are requested as hashes, the nested person resource(s) will not contain the 'email' field.

Account

ENDPOINT

/accounts/{account_id}

GET Fetch the content of the specified account.

Access the account specified by the account_id value in the URL.

Retrieving account resources via this endpoint is restricted to Owners and Administrators for the Account specified. Non authorized users will receive an error.


export TOKEN='your Pivotal Tracker API token'
curl -X GET -H "X-TrackerToken: $TOKEN" "https://www.pivotaltracker.com/services/v5/accounts/100"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"created_at":"2024-08-20T12:00:00Z","id":100,"kind":"account","name":"Galactic Empire","plan":"Enterprise","status":"active","updated_at":"2024-08-20T12:00:00Z"}

Successful responses to this request return the account resource.

PARAMETERS

account_id

int in the request path.
required — The ID of the account.

Labels

ENDPOINT

/projects/{project_id}/labels

GET Provides all of the project's labels.
POST Creates a label on the project.

Access the project's labels.


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
curl -X GET -H "X-TrackerToken: $TOKEN" "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/labels?date_format=millis"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 66
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           [{"kind":"label","id":2015,"project_id":99,"name":"diplomatic relations","created_at":1724155200000,"updated_at":1724155200000},{"kind":"label","id":2013,"project_id":99,"name":"fleet ops","created_at":1724155200000,"updated_at":1724155200000},{"kind":"label","id":2011,"project_id":99,"name":"mnt","created_at":1724155200000,"updated_at":1724155200000},{"kind":"label","id":2012,"project_id":99,"name":"personnel","created_at":1724155200000,"updated_at":1724155200000},{"kind":"label","id":2009,"project_id":99,"name":"plans","created_at":1724155200000,"updated_at":1724155200000},{"kind":"label","id":2014,"project_id":99,"name":"r&d","created_at":1724155200000,"updated_at":1724155200000},{"kind":"label","id":2008,"project_id":99,"name":"rebel bases","created_at":1724155200000,"updated_at":1724155200000},{"kind":"label","id":2017,"project_id":99,"name":"sanitation","created_at":1724155200000,"updated_at":1724155200000},{"kind":"label","id":2016,"project_id":99,"name":"security protocol","created_at":1724155200000,"updated_at":1724155200000},{"kind":"label","id":2010,"project_id":99,"name":"turning luke","created_at":1724155200000,"updated_at":1724155200000}]


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
curl -X GET -H "X-TrackerToken: $TOKEN" "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/labels?date_format=millis&with_type=epic"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 66
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           [{"kind":"label","id":2011,"project_id":99,"name":"mnt","created_at":1724155200000,"updated_at":1724155200000},{"kind":"label","id":2009,"project_id":99,"name":"plans","created_at":1724155200000,"updated_at":1724155200000},{"kind":"label","id":2008,"project_id":99,"name":"rebel bases","created_at":1724155200000,"updated_at":1724155200000},{"kind":"label","id":2017,"project_id":99,"name":"sanitation","created_at":1724155200000,"updated_at":1724155200000},{"kind":"label","id":2010,"project_id":99,"name":"turning luke","created_at":1724155200000,"updated_at":1724155200000}]


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
curl -X GET -H "X-TrackerToken: $TOKEN" "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/labels?date_format=millis&with_status=active"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 66
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           [{"kind":"label","id":2015,"project_id":99,"name":"diplomatic relations","created_at":1724155200000,"updated_at":1724155200000},{"kind":"label","id":2011,"project_id":99,"name":"mnt","created_at":1724155200000,"updated_at":1724155200000},{"kind":"label","id":2012,"project_id":99,"name":"personnel","created_at":1724155200000,"updated_at":1724155200000},{"kind":"label","id":2009,"project_id":99,"name":"plans","created_at":1724155200000,"updated_at":1724155200000},{"kind":"label","id":2014,"project_id":99,"name":"r&d","created_at":1724155200000,"updated_at":1724155200000},{"kind":"label","id":2008,"project_id":99,"name":"rebel bases","created_at":1724155200000,"updated_at":1724155200000}]

Successful responses to this request return an array containing zero or more instances of the label resource.

PARAMETERS

project_id

int in the request path.
required — The ID of the project.

with_type

enumerated string in the request query.
— Filters the returned labels by the given type.

Valid enumeration values: epic, standard

with_status

enumerated string in the request query.
— Filters the returned labels by the given status.

Valid enumeration values: active, inactive


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
curl -X POST -H "X-TrackerToken: $TOKEN" -H "Content-Type: application/json" -d '{"name":"a new hope"}' "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/labels"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 67
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"created_at":"2024-08-20T12:00:00Z","id":5100,"kind":"label","name":"a new hope","project_id":99,"updated_at":"2024-08-20T12:00:00Z"}

Successful responses to this request return the label resource.

PARAMETERS

project_id

int in the request path.
required — The ID of the project.

name

extended string[255] in the request body.
required — The label's name.

ENDPOINT

/projects/{project_id}/labels/{label_id}

GET Provides a project's label.
PUT Updates a project's label.
DELETE Delete a project's label.

Access the project's labels.


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
curl -X GET -H "X-TrackerToken: $TOKEN" "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/labels/2015"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 66
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"created_at":"2024-08-20T12:00:00Z","id":2015,"kind":"label","name":"diplomatic relations","project_id":99,"updated_at":"2024-08-20T12:00:00Z"}

Successful responses to this request return the label resource.

PARAMETERS

project_id

int in the request path.
required — The ID of the project.

label_id

int in the request path.
required — The ID of the label.


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
curl -X PUT -H "X-TrackerToken: $TOKEN" -H "Content-Type: application/json" -d '{"name":"detention"}' "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/labels/2015"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 67
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"created_at":"2024-08-20T12:00:00Z","id":2015,"kind":"label","name":"detention","project_id":99,"updated_at":"2024-08-20T12:00:05Z"}

Successful responses to this request return the label resource.

PARAMETERS

project_id

int in the request path.
required — The ID of the project.

label_id

int in the request path.
required — The ID of the label.

name

extended string[255] in the request body.
required — The label's name.


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
curl -X DELETE -H "X-TrackerToken: $TOKEN" -H "Content-Type: application/json" "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/labels/2015"



  
    View Response
  

  
    Hide Response

    
      status: 204
    

    
      Headers
        X-Tracker-Project-Version: 67
        Content-Type: application/json; potentially-other-variable-stuff

PARAMETERS

project_id

int in the request path.
required — The ID of the project.

label_id

int in the request path.
required — The ID of the label.

ENDPOINT

/projects/{project_id}/stories/{story_id}/labels

GET Returns the labels on a specified story.
POST Returns the label that was created.

Operations on a story's labels


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
export STORY_ID=556
curl -X GET -H "X-TrackerToken: $TOKEN" "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/stories/$STORY_ID/labels"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 66
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           [{"kind":"label","id":2009,"project_id":99,"name":"plans","created_at":"2024-08-20T12:00:00Z","updated_at":"2024-08-20T12:00:00Z"},{"kind":"label","id":2008,"project_id":99,"name":"rebel bases","created_at":"2024-08-20T12:00:00Z","updated_at":"2024-08-20T12:00:00Z"}]

Successful responses to this request return an array containing zero or more instances of the label resource.

PARAMETERS

project_id

int in the request path.
required — The ID of the project.

story_id

int in the request path.
required — The ID of the story.


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
export STORY_ID=556
curl -X POST -H "X-TrackerToken: $TOKEN" -H "Content-Type: application/json" -d '{"name":"my new label"}' "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/stories/$STORY_ID/labels"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 68
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"created_at":"2024-08-20T12:00:00Z","id":5100,"kind":"label","name":"my new label","project_id":99,"updated_at":"2024-08-20T12:00:00Z"}

Successful responses to this request return the label resource.

PARAMETERS

project_id

int in the request path.
required — The ID of the project.

story_id

int in the request path.
required — The ID of the story.

int in the request body.
— The id of a label that already exists within the project, which should be added to the selected story.

name

extended string[255] in the request body.
— The label's name.

ENDPOINT

/projects/{project_id}/stories/{story_id}/labels/{label_id}

DELETE Removes the label from the story.

Operations on a story label


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
export STORY_ID=556
curl -X DELETE -H "X-TrackerToken: $TOKEN" -H "Content-Type: application/json" "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/stories/$STORY_ID/labels/2009"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 67
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"created_at":"2024-08-20T12:00:00Z","id":2009,"kind":"label","name":"plans","project_id":99,"updated_at":"2024-08-20T12:00:00Z"}

PARAMETERS

project_id

int in the request path.
required — The ID of the project.

story_id

int in the request path.
required — The ID of the story.

label_id

int in the request path.
required — The ID of the label.

Releases

ENDPOINT

/projects/{project_id}/releases

GET Returns a list of all releases in the project. (Paginated)

GETs a paginated list of releases for a given project.


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
curl -X GET -H "X-TrackerToken: $TOKEN" "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/releases"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Pagination-Limit: 100
        X-Tracker-Pagination-Offset: 0
        X-Tracker-Pagination-Total: 1
        X-Tracker-Pagination-Returned: 1
        X-Tracker-Project-Version: 66
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           [{"kind":"release","id":552,"created_at":"2024-08-20T12:00:00Z","updated_at":"2024-08-20T12:00:00Z","deadline":"2024-08-20T12:00:05Z","name":"Battlestation fully operational","description":"Everything is proceeding as I have foreseen.","current_state":"unstarted","url":"http://localhost/story/show/552","project_id":99,"labels":[]}]


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
curl -X GET -H "X-TrackerToken: $TOKEN" "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/releases?with_state=accepted"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Pagination-Limit: 100
        X-Tracker-Pagination-Offset: 0
        X-Tracker-Pagination-Total: 1
        X-Tracker-Pagination-Returned: 1
        X-Tracker-Project-Version: 66
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           [{"kind":"release","id":2300,"created_at":"2024-08-20T12:00:00Z","updated_at":"2024-08-20T12:00:00Z","accepted_at":"2024-08-20T12:00:00Z","deadline":"2024-08-20T12:00:00Z","name":"Foo","current_state":"accepted","url":"http://localhost/story/show/2300","project_id":99,"labels":[]}]

Successful responses to this request return an array containing zero or more instances of the release resource. The response from this request is paginated, see Paginating List Responses.

PARAMETERS

project_id

int in the request path.
required — The ID of the project.

with_state

enumerated string in the request query.
— A release's current_state which all returned releases must match.

Valid enumeration values: accepted, unstarted, unscheduled, planned

accepted_before

datetime in the request query.
— A date and time (ISO 8601 format or milliseconds) which all returned releases are accepted before.

accepted_after

datetime in the request query.
— A date and time (ISO 8601 format or milliseconds) which all returned releases are accepted after.

deadline_before

datetime in the request query.
— A date and time (ISO 8601 format or milliseconds) that release dates fall before.

deadline_after

datetime in the request query.
— A date and time (ISO 8601 format or milliseconds) that release dates fall after.

limit

int in the request query.
— The number of releases you want returned.

offset

int in the request query.
— With the first release in your priority list as 0, the index of the first release you want returned.

ENDPOINT

/projects/{project_id}/releases/{id}

GET Returns a release in the project.

GETs a release for a given project.


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
curl -X GET -H "X-TrackerToken: $TOKEN" "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/releases/552"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 66
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"created_at":"2024-08-20T12:00:00Z","current_state":"unstarted","deadline":"2024-08-20T12:00:05Z","description":"Everything is proceeding as I have foreseen.","id":552,"kind":"release","labels":[],"name":"Battlestation fully operational","project_id":99,"updated_at":"2024-08-20T12:00:00Z","url":"http://localhost/story/show/552"}

Successful responses to this request return the release resource.

PARAMETERS

project_id

int in the request path.
required — The ID of the project.

int in the request path.
required — The ID of the id.

ENDPOINT

/projects/{project_id}/releases/{id}/stories

GET Returns a list of stories in the release.

GETs the stories in a given release.


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
export RELEASE_ID=552
curl -X GET -H "X-TrackerToken: $TOKEN" "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/releases/$RELEASE_ID/stories"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 66
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           [{"kind":"story","id":553,"created_at":"2024-08-20T12:00:15Z","updated_at":"2024-08-20T12:00:15Z","accepted_at":"2024-08-20T12:00:15Z","estimate":3,"story_type":"feature","story_priority":"p3","name":"Build protocol droid","description":"I want a friend","current_state":"accepted","requested_by_id":101,"url":"http://localhost/story/show/553","project_id":99,"owner_ids":[101],"labels":[{"id":2014,"project_id":99,"kind":"label","name":"r&d","created_at":"2024-08-20T12:00:15Z","updated_at":"2024-08-20T12:00:15Z"},{"id":2008,"project_id":99,"kind":"label","name":"rebel bases","created_at":"2024-08-20T12:00:15Z","updated_at":"2024-08-20T12:00:15Z"}],"owned_by_id":101},{"kind":"story","id":563,"created_at":"2024-08-20T12:00:15Z","updated_at":"2024-08-20T12:00:15Z","accepted_at":"2024-08-20T12:00:05Z","estimate":3,"story_type":"feature","story_priority":"p3","name":"Complete construction of the Expeditionary Battle Planetoid","description":"Palpatine was impressed with the PoC, make this one bigger","current_state":"accepted","requested_by_id":102,"external_id":"abc123","integration_id":30,"url":"http://localhost/story/show/563","project_id":99,"owner_ids":[102,101],"labels":[{"id":2009,"project_id":99,"kind":"label","name":"plans","created_at":"2024-08-20T12:00:15Z","updated_at":"2024-08-20T12:00:15Z"}],"owned_by_id":102},{"kind":"story","id":554,"created_at":"2024-08-20T12:00:15Z","updated_at":"2024-08-20T12:00:15Z","accepted_at":"2024-08-20T12:00:10Z","estimate":3,"story_type":"feature","story_priority":"p3","name":"Identify Bothan spies","description":"Infiltrate their spy network.","current_state":"accepted","requested_by_id":101,"url":"http://localhost/story/show/554","project_id":99,"owner_ids":[106],"labels":[],"owned_by_id":106},{"kind":"story","id":558,"created_at":"2024-08-20T12:00:15Z","updated_at":"2024-08-20T12:00:15Z","accepted_at":"2024-08-20T12:00:15Z","estimate":1,"story_type":"feature","story_priority":"p3","name":"Contact Lando","current_state":"accepted","requested_by_id":101,"url":"http://localhost/story/show/558","project_id":99,"owner_ids":[],"labels":[]},{"kind":"story","id":560,"created_at":"2024-08-20T12:00:15Z","updated_at":"2024-08-20T12:00:15Z","accepted_at":"2024-08-20T12:00:15Z","estimate":1,"story_type":"feature","story_priority":"p3","name":"Destroy Alderaan","description":"Dantooine is too remote to make an effective demonstration.","current_state":"accepted","requested_by_id":102,"url":"http://localhost/story/show/560","project_id":99,"owner_ids":[101,105],"labels":[{"id":2008,"project_id":99,"kind":"label","name":"rebel bases","created_at":"2024-08-20T12:00:15Z","updated_at":"2024-08-20T12:00:15Z"}],"owned_by_id":101},{"kind":"story","id":556,"created_at":"2024-08-20T12:00:15Z","updated_at":"2024-08-20T12:00:15Z","estimate":2,"story_type":"feature","story_priority":"p3","name":"Interrogate Leia Organa","description":"She is proving to be resistant to our mind probes","current_state":"started","requested_by_id":101,"url":"http://localhost/story/show/556","project_id":99,"owner_ids":[101,105],"labels":[{"id":2009,"project_id":99,"kind":"label","name":"plans","created_at":"2024-08-20T12:00:15Z","updated_at":"2024-08-20T12:00:15Z"},{"id":2008,"project_id":99,"kind":"label","name":"rebel bases","created_at":"2024-08-20T12:00:15Z","updated_at":"2024-08-20T12:00:15Z"}],"owned_by_id":101},{"kind":"story","id":559,"created_at":"2024-08-20T12:00:15Z","updated_at":"2024-08-20T12:00:15Z","estimate":3,"story_type":"feature","story_priority":"p3","name":"All exhaust ports should be shielded","description":"ray shielded, that is.","current_state":"rejected","requested_by_id":102,"url":"http://localhost/story/show/559","project_id":99,"owner_ids":[104],"labels":[{"id":2009,"project_id":99,"kind":"label","name":"plans","created_at":"2024-08-20T12:00:15Z","updated_at":"2024-08-20T12:00:15Z"}],"owned_by_id":104},{"kind":"story","id":561,"created_at":"2024-08-20T12:00:15Z","updated_at":"2024-08-20T12:00:15Z","story_type":"bug","story_priority":"p3","name":"Tractor beam loses power intermittently","current_state":"unstarted","requested_by_id":102,"url":"http://localhost/story/show/561","project_id":99,"owner_ids":[],"labels":[]},{"kind":"story","id":566,"created_at":"2024-08-20T12:00:15Z","updated_at":"2024-08-20T12:00:15Z","story_type":"chore","story_priority":"p3","name":"Repair CommLink","description":"It's malfunctioning.","current_state":"unstarted","requested_by_id":104,"url":"http://localhost/story/show/566","project_id":99,"owner_ids":[],"labels":[{"id":2011,"project_id":99,"kind":"label","name":"mnt","created_at":"2024-08-20T12:00:15Z","updated_at":"2024-08-20T12:00:15Z"}]}]


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
export RELEASE_ID=552
curl -X GET -H "X-TrackerToken: $TOKEN" "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/releases/$RELEASE_ID/stories.csv"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        Content-Disposition: attachment; filename="release_stories_552_AUG21.csv"
        Content-Type: text/csv
    

       Response Body
         
           State,Accepted at (PDT),Type,Estimate,Title,ID,Labels,Owned By,Owned By
accepted,5/14/2024 05:00:00,feature,3,Build protocol droid,553,"r&d,rebel bases",Darth Vader,
accepted,5/21/2024 05:00:00,feature,3,Complete construction of the Expeditionary Battle Planetoid,563,plans,Wilhuff Tarkin,Darth Vader
accepted,8/13/2024 05:00:00,feature,3,Identify Bothan spies,554,"",Galen Marek,
accepted,8/20/2024 05:00:00,feature,1,Contact Lando,558,"",,
accepted,8/20/2024 05:00:00,feature,1,Destroy Alderaan,560,rebel bases,Darth Vader,Robotic Maintenance Team 4
started,,feature,2,Interrogate Leia Organa,556,"plans,rebel bases",Darth Vader,Robotic Maintenance Team 4
rejected,,feature,3,All exhaust ports should be shielded,559,plans,Clone TK421,
unstarted,,bug,,Tractor beam loses power intermittently,561,"",,
unstarted,,chore,,Repair CommLink,566,mnt,,

Successful responses to this request return an array containing zero or more instances of the story resource. The response from this request can be encoded in CSV, see CSV Response Format.

PARAMETERS

project_id

int in the request path.
required — The ID of the project.

int in the request path.
required — The ID of the release.

Stories

ENDPOINT

/projects/{project_id}/stories

GET Provides selected stories. (Paginated)
POST Create a new story.

Fetch some or all stories for the specified project.

Note that labels or strings with a space must be quoted, and multiple filters must be separated with a space, and everything must be URL-escaped. You can also search on multiple values within the same search term, for example, 'filter=id:1,2,3' will return resources with the id 1, 2 or 3.

Searches can be refined with all of the modifications listed here: How can a search be refined?

On endpoints that support filters, 'filter' can only be combined with project_id, date_format, limit and offset. All other parameters will result in an error.

state:started requester:OWK label:"jedi stuff" keyword


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
curl -X GET -H "X-TrackerToken: $TOKEN" "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/stories?date_format=millis&with_state=unstarted"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Pagination-Limit: 100
        X-Tracker-Pagination-Offset: 0
        X-Tracker-Pagination-Total: 4
        X-Tracker-Pagination-Returned: 4
        X-Tracker-Project-Version: 66
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           [{"kind":"story","id":561,"created_at":1724155200000,"updated_at":1724155200000,"story_type":"bug","story_priority":"p3","name":"Tractor beam loses power intermittently","current_state":"unstarted","requested_by_id":102,"url":"http://localhost/story/show/561","project_id":99,"owner_ids":[],"labels":[]},{"kind":"story","id":566,"created_at":1724155200000,"updated_at":1724155200000,"story_type":"chore","story_priority":"p3","name":"Repair CommLink","description":"It's malfunctioning.","current_state":"unstarted","requested_by_id":104,"url":"http://localhost/story/show/566","project_id":99,"owner_ids":[],"labels":[{"id":2011,"project_id":99,"kind":"label","name":"mnt","created_at":1724155200000,"updated_at":1724155200000}]},{"kind":"story","id":552,"created_at":1724155200000,"updated_at":1724155200000,"deadline":1724155205000,"story_type":"release","story_priority":"p3","name":"Battlestation fully operational","description":"Everything is proceeding as I have foreseen.","current_state":"unstarted","requested_by_id":100,"url":"http://localhost/story/show/552","project_id":99,"owner_ids":[],"labels":[]},{"kind":"story","id":555,"created_at":1724155200000,"updated_at":1724155200000,"estimate":2,"story_type":"feature","story_priority":"p3","name":"Bring me the passengers","description":"ignore the droids","current_state":"unstarted","requested_by_id":101,"url":"http://localhost/story/show/555","project_id":99,"owner_ids":[],"labels":[]}]


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
curl -X GET -H "X-TrackerToken: $TOKEN" "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/stories?fields=current_state%2Clabels%2Ccomments%2Ctasks&with_state=unstarted"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Pagination-Limit: 100
        X-Tracker-Pagination-Offset: 0
        X-Tracker-Pagination-Total: 4
        X-Tracker-Pagination-Returned: 4
        X-Tracker-Project-Version: 66
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           [{"id":561,"current_state":"unstarted","labels":[],"tasks":[],"comments":[]},{"id":566,"current_state":"unstarted","labels":[{"id":2011,"project_id":99,"kind":"label","name":"mnt","created_at":"2024-08-20T12:00:00Z","updated_at":"2024-08-20T12:00:00Z"}],"tasks":[],"comments":[]},{"id":552,"current_state":"unstarted","labels":[],"tasks":[],"comments":[]},{"id":555,"current_state":"unstarted","labels":[],"tasks":[],"comments":[{"kind":"comment","id":112,"text":"I want them alive!","person_id":101,"created_at":"2024-08-20T12:00:00Z","updated_at":"2024-08-20T12:00:00Z","story_id":555}]}]


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
curl -X GET -H "X-TrackerToken: $TOKEN" "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/stories?fields=comments%28%3Adefault%2Cfile_attachments%28%3Adefault%2Cuploader%29%29&with_state=unstarted"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Pagination-Limit: 100
        X-Tracker-Pagination-Offset: 0
        X-Tracker-Pagination-Total: 4
        X-Tracker-Pagination-Returned: 4
        X-Tracker-Project-Version: 66
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           [{"id":561,"comments":[]},{"id":566,"comments":[]},{"id":552,"comments":[]},{"id":555,"comments":[{"kind":"comment","id":112,"text":"I want them alive!","person_id":101,"created_at":"2024-08-20T12:00:10Z","updated_at":"2024-08-20T12:00:10Z","story_id":555,"file_attachments":[{"kind":"file_attachment","uploader":{"kind":"person","id":100,"name":"Emperor Palpatine","email":"emperor@galacticrepublic.gov","initials":"EP","username":"palpatine"},"id":20,"filename":"empire.png","created_at":"2024-08-20T12:00:10Z","uploader_id":100,"thumbnailable":true,"height":804,"width":1000,"size":82382,"download_url":"/attachments/0000/0020/empire_big.png","thumbnail_url":"/attachments/0000/0020/empire_thumb.png"},{"kind":"file_attachment","uploader":{"kind":"person","id":101,"name":"Darth Vader","email":"vader@deathstar.mil","initials":"DV","username":"vader"},"id":21,"filename":"Corellian corvette deck plan.tiff","created_at":"2024-08-20T12:00:05Z","uploader_id":101,"thumbnailable":false,"height":216,"width":650,"size":561878,"download_url":"/attachments/0000/0021/Corellian corvette deck plan_big.tiff","thumbnail_url":"/attachments/0000/0021/Corellian corvette deck plan_thumb.tiff"}]}]}]


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
curl -X GET -H "X-TrackerToken: $TOKEN" "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/stories?after_story_id=553&before_story_id=551&with_label=mnt"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Pagination-Limit: 100
        X-Tracker-Pagination-Offset: 0
        X-Tracker-Pagination-Total: 4
        X-Tracker-Pagination-Returned: 4
        X-Tracker-Project-Version: 66
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           [{"kind":"story","id":566,"created_at":"2024-08-20T12:00:00Z","updated_at":"2024-08-20T12:00:00Z","story_type":"chore","story_priority":"p3","name":"Repair CommLink","description":"It's malfunctioning.","current_state":"unstarted","requested_by_id":104,"url":"http://localhost/story/show/566","project_id":99,"owner_ids":[],"labels":[{"id":2011,"project_id":99,"kind":"label","name":"mnt","created_at":"2024-08-20T12:00:00Z","updated_at":"2024-08-20T12:00:00Z"}]},{"kind":"story","id":567,"created_at":"2024-08-20T12:00:00Z","updated_at":"2024-08-20T12:00:00Z","story_type":"feature","story_priority":"p3","name":"Clean Cell Block 1138","description":"The large, hairy _Thing_ is being transferred away","current_state":"unscheduled","requested_by_id":104,"url":"http://localhost/story/show/567","project_id":99,"owner_ids":[],"labels":[{"id":2011,"project_id":99,"kind":"label","name":"mnt","created_at":"2024-08-20T12:00:00Z","updated_at":"2024-08-20T12:00:00Z"}]},{"kind":"story","id":565,"created_at":"2024-08-20T12:00:00Z","updated_at":"2024-08-20T12:00:00Z","story_type":"feature","story_priority":"p3","name":"Reactor leak reported in Detention Block AA-23","description":"large leak, very dangerous","current_state":"unscheduled","requested_by_id":103,"url":"http://localhost/story/show/565","project_id":99,"owner_ids":[],"labels":[{"id":2011,"project_id":99,"kind":"label","name":"mnt","created_at":"2024-08-20T12:00:00Z","updated_at":"2024-08-20T12:00:00Z"}]},{"kind":"story","id":562,"created_at":"2024-08-20T12:00:00Z","updated_at":"2024-08-20T12:00:00Z","story_type":"bug","story_priority":"p3","name":"Garbage smashers on the detention level have malfunctioned","current_state":"unscheduled","requested_by_id":102,"url":"http://localhost/story/show/562","project_id":99,"owner_ids":[],"labels":[{"id":2011,"project_id":99,"kind":"label","name":"mnt","created_at":"2024-08-20T12:00:00Z","updated_at":"2024-08-20T12:00:00Z"}]}]

Successful responses to this request return an array containing zero or more instances of the story resource. The response from this request is paginated, see Paginating List Responses.

PARAMETERS

project_id

int in the request path.
required — The ID of the project.

with_label

extended string in the request query.
— A label name which all returned stories must match.

with_story_type

enumerated string in the request query.
— A story's type which all returned stories must match.

Valid enumeration values: feature, bug, chore, release

with_story_priority

enumerated string in the request query.
— A story's priority which all returned stories must match.

Valid enumeration values: p0, p1, p2, p3, none

with_state

enumerated string in the request query.
— A story's current_state which all returned stories must match.

Valid enumeration values: accepted, delivered, finished, started, rejected, planned, unstarted, unscheduled

after_story_id

int in the request query.
— Filters results to stories that are after the given story id

before_story_id

int in the request query.
— Filters results to stories that are before the given story id

accepted_before

datetime in the request query.
— A date and time (ISO 8601 format or milliseconds) which all returned stories are accepted before.

accepted_after

datetime in the request query.
— A date and time (ISO 8601 format or milliseconds) which all returned stories are accepted after.

created_before

datetime in the request query.
— A date and time (ISO 8601 format or milliseconds) which all returned stories are created before.

created_after

datetime in the request query.
— A date and time (ISO 8601 format or milliseconds) which all returned stories are created after.

updated_before

datetime in the request query.
— A date and time (ISO 8601 format or milliseconds) which all returned stories are updated before.

updated_after

datetime in the request query.
— A date and time (ISO 8601 format or milliseconds) which all returned stories are updated after.

deadline_before

datetime in the request query.
— A date and time (ISO 8601 format or milliseconds) that release dates fall before.

deadline_after

datetime in the request query.
— A date and time (ISO 8601 format or milliseconds) that release dates fall after.

limit

int in the request query.
— The number of stories you want returned.

offset

int in the request query.
— With the first story in your priority list as 0, the index of the first story you want returned.

filter

extended string in the request query.
— This parameter supplies a search string; only stories that match the search criteria are returned. Cannot be used together with any other parameters. How can a search be refined?


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
curl -X POST -H "X-TrackerToken: $TOKEN" -H "Content-Type: application/json" -d '{"name":"Exhaust ports are ray shielded 👹"}' "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/stories"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 67
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"created_at":"2024-08-20T12:00:00Z","current_state":"unscheduled","id":2300,"kind":"story","labels":[],"name":"Exhaust ports are ray shielded 👹","owner_ids":[],"project_id":99,"requested_by_id":101,"story_priority":"p3","story_type":"feature","updated_at":"2024-08-20T12:00:00Z","url":"http://localhost/story/show/2300"}


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
curl -X POST -H "X-TrackerToken: $TOKEN" -H "Content-Type: application/json" -d '{"after_id":555,"before_id":567,"name":"Replace the lining in Darth Vader's helmet"}' "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/stories"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 67
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"created_at":"2024-08-20T12:00:00Z","current_state":"unscheduled","id":2300,"kind":"story","labels":[],"name":"Replace the lining in Darth Vader's helmet","owner_ids":[],"project_id":99,"requested_by_id":101,"story_priority":"p3","story_type":"feature","updated_at":"2024-08-20T12:00:00Z","url":"http://localhost/story/show/2300"}


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
curl -X POST -H "X-TrackerToken: $TOKEN" -H "Content-Type: application/json" -d '{"current_state":"accepted","estimate":1,"name":"Exhaust ports are ray shielded 👹"}' "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/stories"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 67
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"accepted_at":"2024-08-20T12:00:00Z","created_at":"2024-08-20T12:00:00Z","current_state":"accepted","estimate":1,"id":2300,"kind":"story","labels":[],"name":"Exhaust ports are ray shielded 👹","owner_ids":[],"project_id":99,"requested_by_id":101,"story_priority":"p3","story_type":"feature","updated_at":"2024-08-20T12:00:00Z","url":"http://localhost/story/show/2300"}


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
curl -X POST -H "X-TrackerToken: $TOKEN" -H "Content-Type: application/json" -d '{"description":null,"name":"Exhaust ports are ray shielded 👹"}' "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/stories"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 67
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"created_at":"2024-08-20T12:00:00Z","current_state":"unscheduled","id":2300,"kind":"story","labels":[],"name":"Exhaust ports are ray shielded 👹","owner_ids":[],"project_id":99,"requested_by_id":101,"story_priority":"p3","story_type":"feature","updated_at":"2024-08-20T12:00:00Z","url":"http://localhost/story/show/2300"}


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
curl -X POST -H "X-TrackerToken: $TOKEN" -H "Content-Type: application/json" -d '{"comments":[{"text":"Just ray shielding?  What about proton weapons?"}],"name":"Exhaust ports are ray shielded 👹"}' "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/stories?fields=%3Adefault%2Ccomments"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 67
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"comments":[{"kind":"comment","id":300,"story_id":2300,"text":"Just ray shielding?  What about proton weapons?","person_id":101,"created_at":"2024-08-20T12:00:00Z","updated_at":"2024-08-20T12:00:00Z"}],"created_at":"2024-08-20T12:00:00Z","current_state":"unscheduled","id":2300,"kind":"story","labels":[],"name":"Exhaust ports are ray shielded 👹","owner_ids":[],"project_id":99,"requested_by_id":101,"story_priority":"p3","story_type":"feature","updated_at":"2024-08-20T12:00:00Z","url":"http://localhost/story/show/2300"}


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
curl -X POST -H "X-TrackerToken: $TOKEN" -H "Content-Type: application/json" -d '{"comments":[{"text":"Make sure the stamp on the latest shipment of seals matches the new Imperial logo (attached).","file_attachments":[{"type":"file_attachment","id":20,"filename":"empire.png","created_at":1724155200000,"uploader_id":100,"thumbnailable":true,"height":804,"width":1000,"size":82382,"download_url":"/attachments/0000/0020/empire_big.png","thumbnail_url":"/attachments/0000/0020/empire_thumb.png"}]}],"name":"replace seals on trash compactors","story_type":"chore"}' "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/stories"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 67
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"created_at":"2024-08-20T12:00:00Z","current_state":"unscheduled","id":2300,"kind":"story","labels":[],"name":"replace seals on trash compactors","owner_ids":[],"project_id":99,"requested_by_id":101,"story_priority":"p3","story_type":"chore","updated_at":"2024-08-20T12:00:00Z","url":"http://localhost/story/show/2300"}


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
curl -X POST -H "X-TrackerToken: $TOKEN" -H "Content-Type: application/json" -d '{"label_ids":[2008],"name":"Exhaust ports are ray shielded 👹"}' "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/stories"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 67
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"created_at":"2024-08-20T12:00:05Z","current_state":"unscheduled","id":2300,"kind":"story","labels":[{"kind":"label","id":2008,"project_id":99,"name":"rebel bases","created_at":"2024-08-20T12:00:00Z","updated_at":"2024-08-20T12:00:00Z"}],"name":"Exhaust ports are ray shielded 👹","owner_ids":[],"project_id":99,"requested_by_id":101,"story_priority":"p3","story_type":"feature","updated_at":"2024-08-20T12:00:05Z","url":"http://localhost/story/show/2300"}


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
curl -X POST -H "X-TrackerToken: $TOKEN" -H "Content-Type: application/json" -d '{"labels":["plans","Inspected by TK-421"],"name":"Exhaust ports are ray shielded 👹"}' "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/stories"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 68
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"created_at":"2024-08-20T12:00:05Z","current_state":"unscheduled","id":2300,"kind":"story","labels":[{"kind":"label","id":5100,"project_id":99,"name":"inspected by tk-421","created_at":"2024-08-20T12:00:05Z","updated_at":"2024-08-20T12:00:05Z"},{"kind":"label","id":2009,"project_id":99,"name":"plans","created_at":"2024-08-20T12:00:00Z","updated_at":"2024-08-20T12:00:00Z"}],"name":"Exhaust ports are ray shielded 👹","owner_ids":[],"project_id":99,"requested_by_id":101,"story_priority":"p3","story_type":"feature","updated_at":"2024-08-20T12:00:05Z","url":"http://localhost/story/show/2300"}


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
curl -X POST -H "X-TrackerToken: $TOKEN" -H "Content-Type: application/json" -d '{"labels":["Inspected by TK-421",{"id":2009,"name":"plans"},{"name":"mnt"}],"name":"Exhaust ports are ray shielded 👹"}' "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/stories"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 68
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"created_at":"2024-08-20T12:00:05Z","current_state":"unscheduled","id":2300,"kind":"story","labels":[{"kind":"label","id":5100,"project_id":99,"name":"inspected by tk-421","created_at":"2024-08-20T12:00:05Z","updated_at":"2024-08-20T12:00:05Z"},{"kind":"label","id":2011,"project_id":99,"name":"mnt","created_at":"2024-08-20T12:00:00Z","updated_at":"2024-08-20T12:00:00Z"},{"kind":"label","id":2009,"project_id":99,"name":"plans","created_at":"2024-08-20T12:00:00Z","updated_at":"2024-08-20T12:00:00Z"}],"name":"Exhaust ports are ray shielded 👹","owner_ids":[],"project_id":99,"requested_by_id":101,"story_priority":"p3","story_type":"feature","updated_at":"2024-08-20T12:00:05Z","url":"http://localhost/story/show/2300"}

Successful responses to this request return the story resource.

PARAMETERS

project_id

int in the request path.
required — The ID of the project.

name

extended string[5000] in the request body.
required — Name of the story.

description

extended string[20000] in the request body.
— In-depth explanation of the story requirements.

story_type

enumerated string in the request body.
— Type of story.

Valid enumeration values: feature, bug, chore, release

current_state

enumerated string in the request body.
— Story's state of completion.

Valid enumeration values: accepted, delivered, finished, started, rejected, planned, unstarted, unscheduled

estimate

float in the request body.
— Point value of the story.

accepted_at

datetime in the request body.
— Acceptance time.

deadline

datetime in the request body.
— Due date/time (for a release-type story).

requested_by_id

int in the request body.
— The id of the person who requested the story.

owned_by_id

int in the request body.
— The id of the person who owns the story.

owner_ids

List[int] in the request body.
— IDs of the current story owners.

labels

List[label] in the request body.
— This parameter allows labels to be selected by content or to be created implicitly as part of the basic request. See the 'label_ids' attribute of the story resource. The labels' ids must not be included if creating a new one.

label_ids

List[int] in the request body.
— IDs of labels currently applied to story.

tasks

List[task] in the request body.
— This parameter allows creation of new tasks implicitly as part of the basic request. See the 'task_ids' attribute of the story resource for how the resources relate. See the parameters of the POST to /projects/{project_id}/stories/{story_id}/tasks operation for keys that can be included in the nested hash in the parameters. The nested tasks must not contain an id.

pull_requests

List[pull_request] in the request body.
— This parameter allows creation of new pull_requests implicitly as part of the basic request. See the 'pull_request_ids' attribute of the story resource. The nested pull_requests must not contain an id.

branches

List[branch] in the request body.
— This parameter allows creation of new branches implicitly as part of the basic request. See the 'branch_ids' attribute of the story resource. The nested branches must not contain an id.

blockers

List[blocker] in the request body.
— This parameter allows creation of new blockers implicitly as part of the basic request. See the 'blocker_ids' attribute of the story resource for how the resources relate. See the parameters of the POST to /projects/{project_id}/stories/{story_id}/blockers operation for keys that can be included in the nested hash in the parameters. The nested blockers must not contain an id.

follower_ids

List[int] in the request body.
— IDs of people currently following the story.

comments

List[comment] in the request body.
— This parameter allows creation of new comments implicitly as part of the basic request. See the 'comment_ids' attribute of the story resource for how the resources relate. See the parameters of the POST to /projects/{project_id}/stories/{story_id}/comments operation for keys that can be included in the nested hash in the parameters. The nested comments must not contain an id.

created_at

datetime in the request body.
— Creation time.

before_id

int in the request body.
— ID of the story that the current story is located before. Null if story is last one in the project.

after_id

int in the request body.
— ID of the story that the current story is located after. Null if story is the first one in the project.

integration_id

int in the request body.
— ID of the integration API that is linked to this story.

external_id

string[255] in the request body.
— The integration's specific ID for the story.

reviews

List[review] in the request body.
— This parameter allows creation of new reviews implicitly as part of the basic request. See the 'review_ids' attribute of the story resource for how the resources relate. See the parameters of the POST to /projects/{project_id}/stories/{story_id}/reviews operation for keys that can be included in the nested hash in the parameters. The nested reviews must not contain an id.

story_priority

enumerated string in the request body.
— Story Priority of the specified story.

Valid enumeration values: p0, p1, p2, p3, none

ENDPOINT

/projects/{project_id}/stories/bulk

GET Provides stories specified in ids param.

Fetch more than one story in a project with one request.


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
curl -X GET -H "X-TrackerToken: $TOKEN" "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/stories/bulk?ids=552%2C553%2C2%2C0"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 66
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           [{"kind":"story","id":553,"created_at":"2024-08-20T12:00:05Z","updated_at":"2024-08-20T12:00:05Z","accepted_at":"2024-08-20T12:00:05Z","estimate":3,"story_type":"feature","story_priority":"p3","name":"Build protocol droid","description":"I want a friend","current_state":"accepted","requested_by_id":101,"url":"http://localhost/story/show/553","project_id":99,"owner_ids":[101],"labels":[{"id":2014,"project_id":99,"kind":"label","name":"r&d","created_at":"2024-08-20T12:00:05Z","updated_at":"2024-08-20T12:00:05Z"},{"id":2008,"project_id":99,"kind":"label","name":"rebel bases","created_at":"2024-08-20T12:00:05Z","updated_at":"2024-08-20T12:00:05Z"}],"owned_by_id":101},{"kind":"story","id":552,"created_at":"2024-08-20T12:00:05Z","updated_at":"2024-08-20T12:00:05Z","deadline":"2024-08-20T12:00:10Z","story_type":"release","story_priority":"p3","name":"Battlestation fully operational","description":"Everything is proceeding as I have foreseen.","current_state":"unstarted","requested_by_id":100,"url":"http://localhost/story/show/552","project_id":99,"owner_ids":[],"labels":[]}]

Successful responses to this request return an array containing zero or more instances of the story resource.

PARAMETERS

project_id

int in the request path.
required — The ID of the project.

ids

string in the request query.
required — The comma separated list of ids of the stories in the project to be returned. Not found ids (deleted or moved to other projects) will be ignored. There is a limit of 500 ids.

Story

ENDPOINT

/projects/{project_id}/stories/{story_id}

GET Returns the specified story.
PUT Updates a story.
DELETE Deletes a story.

Operations on an individual story.


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
curl -X GET -H "X-TrackerToken: $TOKEN" "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/stories/555"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 66
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"created_at":"2024-08-20T12:00:00Z","current_state":"unstarted","description":"ignore the droids","estimate":2,"id":555,"kind":"story","labels":[],"name":"Bring me the passengers","owner_ids":[],"project_id":99,"requested_by_id":101,"story_priority":"p3","story_type":"feature","updated_at":"2024-08-20T12:00:00Z","url":"http://localhost/story/show/555"}

Successful responses to this request return the story resource.

PARAMETERS

project_id

int in the request path.
required — The ID of the project.

story_id

int in the request path.
required — The ID of the story.


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
curl -X PUT -H "X-TrackerToken: $TOKEN" -H "Content-Type: application/json" -d '{"labels":[{"name":"newnew"},{"name":"labellabel"},{"id":2011}]}' "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/stories/555"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 68
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"created_at":"2024-08-20T12:00:00Z","current_state":"unstarted","description":"ignore the droids","estimate":2,"id":555,"kind":"story","labels":[{"kind":"label","id":5101,"project_id":99,"name":"labellabel","created_at":"2024-08-20T12:00:05Z","updated_at":"2024-08-20T12:00:05Z"},{"kind":"label","id":2011,"project_id":99,"name":"mnt","created_at":"2024-08-20T12:00:00Z","updated_at":"2024-08-20T12:00:00Z"},{"kind":"label","id":5100,"project_id":99,"name":"newnew","created_at":"2024-08-20T12:00:05Z","updated_at":"2024-08-20T12:00:05Z"}],"name":"Bring me the passengers","owner_ids":[],"project_id":99,"requested_by_id":101,"story_priority":"p3","story_type":"feature","updated_at":"2024-08-20T12:00:05Z","url":"http://localhost/story/show/555"}


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
curl -X PUT -H "X-TrackerToken: $TOKEN" -H "Content-Type: application/json" -d '{"labels":["no life signs","look sir metal"]}' "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/stories/555"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 68
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"created_at":"2024-08-20T12:00:00Z","current_state":"unstarted","description":"ignore the droids","estimate":2,"id":555,"kind":"story","labels":[{"kind":"label","id":5101,"project_id":99,"name":"look sir metal","created_at":"2024-08-20T12:00:05Z","updated_at":"2024-08-20T12:00:05Z"},{"kind":"label","id":5100,"project_id":99,"name":"no life signs","created_at":"2024-08-20T12:00:05Z","updated_at":"2024-08-20T12:00:05Z"}],"name":"Bring me the passengers","owner_ids":[],"project_id":99,"requested_by_id":101,"story_priority":"p3","story_type":"feature","updated_at":"2024-08-20T12:00:05Z","url":"http://localhost/story/show/555"}


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
curl -X PUT -H "X-TrackerToken: $TOKEN" -H "Content-Type: application/json" -d '{"labels":[]}' "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/stories/555"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 67
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"created_at":"2024-08-20T12:00:00Z","current_state":"unstarted","description":"ignore the droids","estimate":2,"id":555,"kind":"story","labels":[],"name":"Bring me the passengers","owner_ids":[],"project_id":99,"requested_by_id":101,"story_priority":"p3","story_type":"feature","updated_at":"2024-08-20T12:00:05Z","url":"http://localhost/story/show/555"}


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
curl -X PUT -H "X-TrackerToken: $TOKEN" -H "Content-Type: application/json" -d '{"before_id":556,"current_state":"started","estimate":1}' "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/stories/567"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 68
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"created_at":"2024-08-20T12:00:00Z","current_state":"started","description":"The large, hairy _Thing_ is being transferred away","estimate":1,"id":567,"kind":"story","labels":[{"kind":"label","id":2011,"project_id":99,"name":"mnt","created_at":"2024-08-20T12:00:00Z","updated_at":"2024-08-20T12:00:00Z"}],"name":"Clean Cell Block 1138","owner_ids":[],"project_id":99,"requested_by_id":104,"story_priority":"p3","story_type":"feature","updated_at":"2024-08-20T12:00:05Z","url":"http://localhost/story/show/567"}


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
curl -X PUT -H "X-TrackerToken: $TOKEN" -H "Content-Type: application/json" -d '{"current_state":"accepted","estimate":1,"name":"Exhaust ports have ray shielding 👹"}' "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/stories/555"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 67
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"accepted_at":"2024-08-20T12:00:05Z","created_at":"2024-08-20T12:00:00Z","current_state":"accepted","description":"ignore the droids","estimate":1,"id":555,"kind":"story","labels":[],"name":"Exhaust ports have ray shielding 👹","owner_ids":[],"project_id":99,"requested_by_id":101,"story_priority":"p3","story_type":"feature","updated_at":"2024-08-20T12:00:05Z","url":"http://localhost/story/show/555"}


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
curl -X PUT -H "X-TrackerToken: $TOKEN" -H "Content-Type: application/json" -d '{"after_id":568,"before_id":null,"group":"scheduled","project_id":98}' "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/stories/555"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 67
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"created_at":"2024-08-20T12:00:00Z","current_state":"unstarted","description":"ignore the droids","estimate":2,"id":555,"kind":"story","labels":[],"name":"Bring me the passengers","owner_ids":[],"project_id":98,"requested_by_id":101,"story_priority":"p3","story_type":"feature","updated_at":"2024-08-20T12:00:05Z","url":"http://localhost/story/show/555"}

Successful responses to this request return the story resource.

PARAMETERS

project_id

int in the request path.
required — The ID of the project.

story_id

int in the request path.
required — The ID of the story.

comment

object in the request body.
— The content for a comment when rejecting a story (current state = rejected). For all other comment actions see the Comments endpoint.

follower_ids

List[int] in the request body.
— The ids of the users you would like to follow the story.

group

enumerated string in the request body.
— Should be supplied when specifying the story's before_id and/or after_id.

Valid enumeration values: scheduled, unscheduled, current

project_id

int in the request body.
— The value that the story's project_id should be updated to. Has the effect of moving the story being updated into that project from its current one.

name

extended string[5000] in the request body.
— Name of the story.

description

extended string[20000] in the request body.
— In-depth explanation of the story requirements.

story_type

enumerated string in the request body.
— Type of story.

Valid enumeration values: feature, bug, chore, release

current_state

enumerated string in the request body.
— Story's state of completion.

Valid enumeration values: accepted, delivered, finished, started, rejected, planned, unstarted, unscheduled

estimate

float in the request body.
— Point value of the story.

accepted_at

datetime in the request body.
— Acceptance time.

deadline

datetime in the request body.
— Due date/time (for a release-type story).

requested_by_id

int in the request body.
— The id of the person who requested the story.

owned_by_id

int in the request body.
— The id of the person who owns the story.

owner_ids

List[int] in the request body.
— IDs of the current story owners.

labels

label_ids

List[int] in the request body.
— IDs of labels currently applied to story.

before_id

int in the request body.
— ID of the story that the current story is located before. Null if story is last one in the project.

after_id

int in the request body.
— ID of the story that the current story is located after. Null if story is the first one in the project.

integration_id

int in the request body.
— ID of the integration API that is linked to this story.

external_id

string[255] in the request body.
— The integration's specific ID for the story.

story_priority

enumerated string in the request body.
— Story Priority of the specified story.

Valid enumeration values: p0, p1, p2, p3, none


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
curl -X DELETE -H "X-TrackerToken: $TOKEN" -H "Content-Type: application/json" "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/stories/555"



  
    View Response
  

  
    Hide Response

    
      status: 204
    

    
      Headers
        X-Tracker-Project-Version: 67
        Content-Type: application/json; potentially-other-variable-stuff

PARAMETERS

project_id

int in the request path.
required — The ID of the project.

story_id

int in the request path.
required — The ID of the story.

ENDPOINT

/projects/{project_id}/stories/{story_id}/owners

GET Returns the owners of a specified story.
POST Add a user as an owner of the story.

Operations on a story's owners


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
export STORY_ID=555
curl -X GET -H "X-TrackerToken: $TOKEN" "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/stories/$STORY_ID/owners"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 66
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           [{"kind":"person","id":100,"name":"Emperor Palpatine","email":"emperor@galacticrepublic.gov","initials":"EP","username":"palpatine"},{"kind":"person","id":103,"name":"Moradmin Bast","email":"bast@deathstar.mil","initials":"MB","username":"bast"}]

Successful responses to this request return an array containing zero or more instances of the person resource.

PARAMETERS

project_id

int in the request path.
required — The ID of the project.

story_id

int in the request path.
required — The ID of the story.


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
export STORY_ID=555
curl -X POST -H "X-TrackerToken: $TOKEN" -H "Content-Type: application/json" -d '{"id":100}' "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/stories/$STORY_ID/owners"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 67
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"email":"emperor@galacticrepublic.gov","id":100,"initials":"EP","kind":"person","name":"Emperor Palpatine","username":"palpatine"}

Successful responses to this request return an array containing zero or more instances of the person resource.

PARAMETERS

project_id

int in the request path.
required — The ID of the project.

story_id

int in the request path.
required — The ID of the story.

int in the request body.
— ID of the person to be added

ENDPOINT

/projects/{project_id}/stories/{story_id}/owners/{person_id}

DELETE Removes ownership of a story from a person.

Operations on a story's owners


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
export STORY_ID=555
curl -X DELETE -H "X-TrackerToken: $TOKEN" -H "Content-Type: application/json" "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/stories/$STORY_ID/owners/100"



  
    View Response
  

  
    Hide Response

    
      status: 204
    

    
      Headers
        X-Tracker-Project-Version: 67
        Content-Type: application/json; potentially-other-variable-stuff

PARAMETERS

project_id

int in the request path.
required — The ID of the project.

story_id

int in the request path.
required — The ID of the story.

person_id

int in the request path.
required — The ID of the person.

ENDPOINT

/stories/{story_id}

GET Returns the specified story.
PUT Updates the specified story.
DELETE Deletes the specified story.

Operations on an individual story.


export TOKEN='your Pivotal Tracker API token'
curl -X GET -H "X-TrackerToken: $TOKEN" "https://www.pivotaltracker.com/services/v5/stories/559"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 66
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"created_at":"2024-08-20T12:00:00Z","current_state":"rejected","description":"ray shielded, that is.","estimate":3,"id":559,"kind":"story","labels":[{"id":2009,"project_id":99,"kind":"label","name":"plans","created_at":"2024-08-20T12:00:00Z","updated_at":"2024-08-20T12:00:00Z"}],"name":"All exhaust ports should be shielded","owned_by_id":104,"owner_ids":[104],"project_id":99,"requested_by_id":102,"story_priority":"p3","story_type":"feature","updated_at":"2024-08-20T12:00:00Z","url":"http://localhost/story/show/559"}

Successful responses to this request return the story resource.

PARAMETERS

story_id

int in the request path.
required — The ID of the story.


export TOKEN='your Pivotal Tracker API token'
curl -X PUT -H "X-TrackerToken: $TOKEN" -H "Content-Type: application/json" -d '{"labels":[{"name":"newnew"},{"name":"labellabel"},{"id":2011}]}' "https://www.pivotaltracker.com/services/v5/stories/555"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 68
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"created_at":"2024-08-20T12:00:00Z","current_state":"unstarted","description":"ignore the droids","estimate":2,"id":555,"kind":"story","labels":[{"kind":"label","id":5101,"project_id":99,"name":"labellabel","created_at":"2024-08-20T12:00:05Z","updated_at":"2024-08-20T12:00:05Z"},{"kind":"label","id":2011,"project_id":99,"name":"mnt","created_at":"2024-08-20T12:00:00Z","updated_at":"2024-08-20T12:00:00Z"},{"kind":"label","id":5100,"project_id":99,"name":"newnew","created_at":"2024-08-20T12:00:05Z","updated_at":"2024-08-20T12:00:05Z"}],"name":"Bring me the passengers","owner_ids":[],"project_id":99,"requested_by_id":101,"story_priority":"p3","story_type":"feature","updated_at":"2024-08-20T12:00:05Z","url":"http://localhost/story/show/555"}


export TOKEN='your Pivotal Tracker API token'
curl -X PUT -H "X-TrackerToken: $TOKEN" -H "Content-Type: application/json" -d '{"before_id":556,"current_state":"started","estimate":1}' "https://www.pivotaltracker.com/services/v5/stories/567"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 68
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"created_at":"2024-08-20T12:00:00Z","current_state":"started","description":"The large, hairy _Thing_ is being transferred away","estimate":1,"id":567,"kind":"story","labels":[{"kind":"label","id":2011,"project_id":99,"name":"mnt","created_at":"2024-08-20T12:00:00Z","updated_at":"2024-08-20T12:00:00Z"}],"name":"Clean Cell Block 1138","owner_ids":[],"project_id":99,"requested_by_id":104,"story_priority":"p3","story_type":"feature","updated_at":"2024-08-20T12:00:05Z","url":"http://localhost/story/show/567"}


export TOKEN='your Pivotal Tracker API token'
curl -X PUT -H "X-TrackerToken: $TOKEN" -H "Content-Type: application/json" -d '{"comment":{"text":"Here are the new plans.","file_attachments":[{"type":"file_attachment","id":21,"filename":"Corellian corvette deck plan.tiff","created_at":1724155200000,"uploader_id":101,"thumbnailable":false,"height":216,"width":650,"size":561878,"download_url":"/attachments/0000/0021/Corellian corvette deck plan_big.tiff","thumbnail_url":"/attachments/0000/0021/Corellian corvette deck plan_thumb.tiff"}]},"current_state":"rejected"}' "https://www.pivotaltracker.com/services/v5/stories/555?fields=requested_by%2Cowned_by%2Clabels%2Ccomments%28text%2Cfile_attachments%29%2Ctasks"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 67
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"comments":[{"text":"I want them alive!","file_attachments":[{"kind":"file_attachment","id":20,"filename":"empire.png","created_at":"2024-08-20T12:00:00Z","uploader_id":100,"thumbnailable":true,"height":804,"width":1000,"size":82382,"download_url":"/attachments/0000/0020/empire_big.png","thumbnail_url":"/attachments/0000/0020/empire_thumb.png"},{"kind":"file_attachment","id":21,"filename":"Corellian corvette deck plan.tiff","created_at":"2024-08-20T12:00:05Z","uploader_id":101,"thumbnailable":false,"height":216,"width":650,"size":561878,"download_url":"/attachments/0000/0021/Corellian corvette deck plan_big.tiff","thumbnail_url":"/attachments/0000/0021/Corellian corvette deck plan_thumb.tiff"}],"id":112},{"text":"Here are the new plans.","file_attachments":[{"kind":"file_attachment","id":21,"filename":"Corellian corvette deck plan.tiff","created_at":"2024-08-20T12:00:05Z","uploader_id":101,"thumbnailable":false,"height":216,"width":650,"size":561878,"download_url":"/attachments/0000/0021/Corellian corvette deck plan_big.tiff","thumbnail_url":"/attachments/0000/0021/Corellian corvette deck plan_thumb.tiff"}],"id":300}],"id":555,"labels":[],"requested_by":{"kind":"person","id":101,"name":"Darth Vader","email":"vader@deathstar.mil","initials":"DV","username":"vader"},"tasks":[]}


export TOKEN='your Pivotal Tracker API token'
curl -X PUT -H "X-TrackerToken: $TOKEN" -H "Content-Type: application/json" -d '{"current_state":"accepted","estimate":1,"name":"Exhaust ports have ray shielding 👹"}' "https://www.pivotaltracker.com/services/v5/stories/555"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 67
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"accepted_at":"2024-08-20T12:00:05Z","created_at":"2024-08-20T12:00:00Z","current_state":"accepted","description":"ignore the droids","estimate":1,"id":555,"kind":"story","labels":[],"name":"Exhaust ports have ray shielding 👹","owner_ids":[],"project_id":99,"requested_by_id":101,"story_priority":"p3","story_type":"feature","updated_at":"2024-08-20T12:00:05Z","url":"http://localhost/story/show/555"}

Successful responses to this request return the story resource.

PARAMETERS

story_id

int in the request path.
required — The ID of the story.

comment

object in the request body.
— The content for a comment when rejecting a story (current state = rejected). For all other comment actions see the Comments endpoint.

follower_ids

List[int] in the request body.
— The ids of the users you would like to follow the story.

group

enumerated string in the request body.
— Should be supplied when specifying the story's before_id and/or after_id.

Valid enumeration values: scheduled, unscheduled, current

project_id

int in the request body.
— id of the project.

name

extended string[5000] in the request body.
— Name of the story.

description

extended string[20000] in the request body.
— In-depth explanation of the story requirements.

story_type

enumerated string in the request body.
— Type of story.

Valid enumeration values: feature, bug, chore, release

current_state

enumerated string in the request body.
— Story's state of completion.

Valid enumeration values: accepted, delivered, finished, started, rejected, planned, unstarted, unscheduled

estimate

float in the request body.
— Point value of the story.

accepted_at

datetime in the request body.
— Acceptance time.

deadline

datetime in the request body.
— Due date/time (for a release-type story).

requested_by_id

int in the request body.
— The id of the person who requested the story.

owned_by_id

int in the request body.
— The id of the person who owns the story.

owner_ids

List[int] in the request body.
— IDs of the current story owners.

labels

label_ids

List[int] in the request body.
— IDs of labels currently applied to story.

before_id

int in the request body.
— ID of the story that the current story is located before. Null if story is last one in the project.

after_id

int in the request body.
— ID of the story that the current story is located after. Null if story is the first one in the project.

integration_id

int in the request body.
— ID of the integration API that is linked to this story.

external_id

string[255] in the request body.
— The integration's specific ID for the story.

story_priority

enumerated string in the request body.
— Story Priority of the specified story.

Valid enumeration values: p0, p1, p2, p3, none


export TOKEN='your Pivotal Tracker API token'
curl -X DELETE -H "X-TrackerToken: $TOKEN" -H "Content-Type: application/json" "https://www.pivotaltracker.com/services/v5/stories/555"



  
    View Response
  

  
    Hide Response

    
      status: 204
    

    
      Headers
        X-Tracker-Project-Version: 67
        Content-Type: application/json; potentially-other-variable-stuff

PARAMETERS

story_id

int in the request path.
required — The ID of the story.

Story Tasks

ENDPOINT

/projects/{project_id}/stories/{story_id}/tasks

GET Returns the tasks on a specified story.
POST Returns the task that was created.

Operations on a story's tasks


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
export STORY_ID=559
curl -X GET -H "X-TrackerToken: $TOKEN" "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/stories/$STORY_ID/tasks"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 66
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           [{"kind":"task","id":5,"story_id":559,"description":"Port 0","complete":false,"position":1,"created_at":"2024-08-20T12:00:00Z","updated_at":"2024-08-20T12:00:00Z"},{"kind":"task","id":6,"story_id":559,"description":"Port 90","complete":false,"position":2,"created_at":"2024-08-20T12:00:00Z","updated_at":"2024-08-20T12:00:00Z"}]

Successful responses to this request return an array containing zero or more instances of the task resource.

PARAMETERS

project_id

int in the request path.
required — The ID of the project.

story_id

int in the request path.
required — The ID of the story.


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
export STORY_ID=559
curl -X POST -H "X-TrackerToken: $TOKEN" -H "Content-Type: application/json" -d '{"description":"port 270"}' "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/stories/$STORY_ID/tasks"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 67
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"complete":false,"created_at":"2024-08-20T12:00:00Z","description":"port 270","id":5100,"kind":"task","position":3,"story_id":559,"updated_at":"2024-08-20T12:00:00Z"}


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
export STORY_ID=559
curl -X POST -H "X-TrackerToken: $TOKEN" -H "Content-Type: application/json" -d '{"complete":true,"description":"port 270","position":1}' "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/stories/$STORY_ID/tasks"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 67
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"complete":true,"created_at":"2024-08-20T12:00:00Z","description":"port 270","id":5100,"kind":"task","position":1,"story_id":559,"updated_at":"2024-08-20T12:00:00Z"}

Successful responses to this request return the task resource.

PARAMETERS

project_id

int in the request path.
required — The ID of the project.

story_id

int in the request path.
required — The ID of the story.

description

extended string[1000] in the request body.
required — Content of the task.

complete

boolean in the request body.
— Flag showing the completion of the task.

position

int in the request body.
— Offset from the top of the task list. Positions start counting from 1 for the first task on a story.

ENDPOINT

/projects/{project_id}/stories/{story_id}/tasks/{task_id}

GET Returns the specified task on a specified story
DELETE Deletes the specified task
PUT Updates the specified task

Operations on a task


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
export STORY_ID=559
curl -X GET -H "X-TrackerToken: $TOKEN" "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/stories/$STORY_ID/tasks/5"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 66
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"complete":false,"created_at":"2024-08-20T12:00:00Z","description":"Port 0","id":5,"kind":"task","position":1,"story_id":559,"updated_at":"2024-08-20T12:00:00Z"}


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
export STORY_ID=559
curl -X GET -H "X-TrackerToken: $TOKEN" "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/stories/$STORY_ID/tasks/5?fields=description%2Ccomplete"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 66
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"complete":false,"description":"Port 0","id":5}

Successful responses to this request return the task resource.

PARAMETERS

project_id

int in the request path.
required — The ID of the project.

story_id

int in the request path.
required — The ID of the story.

task_id

int in the request path.
required — The ID of the task.


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
export STORY_ID=559
curl -X DELETE -H "X-TrackerToken: $TOKEN" -H "Content-Type: application/json" "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/stories/$STORY_ID/tasks/5"



  
    View Response
  

  
    Hide Response

    
      status: 204
    

    
      Headers
        X-Tracker-Project-Version: 67
        Content-Type: application/json; potentially-other-variable-stuff

PARAMETERS

project_id

int in the request path.
required — The ID of the project.

story_id

int in the request path.
required — The ID of the story.

task_id

int in the request path.
required — The ID of the task.


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
export STORY_ID=559
curl -X PUT -H "X-TrackerToken: $TOKEN" -H "Content-Type: application/json" -d '{"description":"port 360"}' "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/stories/$STORY_ID/tasks/5"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 67
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"complete":false,"created_at":"2024-08-20T12:00:00Z","description":"port 360","id":5,"kind":"task","position":1,"story_id":559,"updated_at":"2024-08-20T12:00:05Z"}


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
export STORY_ID=559
curl -X PUT -H "X-TrackerToken: $TOKEN" -H "Content-Type: application/json" -d '{"complete":true,"position":2}' "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/stories/$STORY_ID/tasks/5"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 67
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"complete":true,"created_at":"2024-08-20T12:00:00Z","description":"Port 0","id":5,"kind":"task","position":2,"story_id":559,"updated_at":"2024-08-20T12:00:05Z"}

Successful responses to this request return the task resource.

PARAMETERS

project_id

int in the request path.
required — The ID of the project.

story_id

int in the request path.
required — The ID of the story.

task_id

int in the request path.
required — The ID of the task.

description

extended string[1000] in the request body.
— Content of the task.

complete

boolean in the request body.
— Flag showing the completion of the task.

position

int in the request body.
— Offset from the top of the task list. Positions start counting from 1 for the first task on a story.

Epics

ENDPOINT

/projects/{project_id}/epics

GET Returns a list of all epics in the project.
POST Create a new epic.

Epic operations.

Searches can be refined with all of the modifications listed here: How can a search be refined?

On endpoints that support filters, 'filter' can only be combined with project_id, date_format, limit and offset. All other parameters will result in an error.

label:"jedi stuff" keyword

keyword created_since:11/16/2009 has_attachment:


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
curl -X GET -H "X-TrackerToken: $TOKEN" "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/epics"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 66
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           [{"id":555,"kind":"epic","created_at":"2024-08-20T12:00:00Z","updated_at":"2024-08-20T12:00:00Z","project_id":99,"name":"Sanitation","url":"http://localhost/epic/show/555","label":{"id":2017,"project_id":99,"kind":"label","name":"sanitation","created_at":"2024-08-20T12:00:00Z","updated_at":"2024-08-20T12:00:00Z"}},{"id":8,"kind":"epic","created_at":"2024-08-20T12:00:00Z","updated_at":"2024-08-20T12:00:00Z","project_id":99,"name":"Maintenance","url":"http://localhost/epic/show/8","label":{"id":2011,"project_id":99,"kind":"label","name":"mnt","created_at":"2024-08-20T12:00:00Z","updated_at":"2024-08-20T12:00:00Z"}},{"id":7,"kind":"epic","created_at":"2024-08-20T12:00:00Z","updated_at":"2024-08-20T12:00:00Z","project_id":99,"name":"Turn Luke Skywalker","url":"http://localhost/epic/show/7","label":{"id":2010,"project_id":99,"kind":"label","name":"turning luke","created_at":"2024-08-20T12:00:00Z","updated_at":"2024-08-20T12:00:00Z"}},{"id":6,"kind":"epic","created_at":"2024-08-20T12:00:00Z","updated_at":"2024-08-20T12:00:00Z","project_id":99,"name":"Death Star Plans","url":"http://localhost/epic/show/6","label":{"id":2009,"project_id":99,"kind":"label","name":"plans","created_at":"2024-08-20T12:00:00Z","updated_at":"2024-08-20T12:00:00Z"}},{"id":5,"kind":"epic","created_at":"2024-08-20T12:00:00Z","updated_at":"2024-08-20T12:00:00Z","project_id":99,"name":"Rebel Home Worlds","description":"Identify the systems and eliminate the rebel scum.","url":"http://localhost/epic/show/5","label":{"id":2008,"project_id":99,"kind":"label","name":"rebel bases","created_at":"2024-08-20T12:00:00Z","updated_at":"2024-08-20T12:00:00Z"}}]


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
curl -X GET -H "X-TrackerToken: $TOKEN" "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/epics?fields=id%2Ccomments"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 66
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           [{"id":555,"comments":[{"kind":"comment","id":113,"text":"Audit security of oscillator sanitation components","person_id":102,"created_at":"2024-08-20T12:00:00Z","updated_at":"2024-08-20T12:00:00Z","epic_id":555}]},{"id":8,"comments":[]},{"id":7,"comments":[]},{"id":6,"comments":[{"kind":"comment","id":111,"text":"Check out these Uffel mouse droids","person_id":103,"created_at":"2024-08-20T12:00:00Z","updated_at":"2024-08-20T12:00:00Z","epic_id":6}]},{"id":5,"comments":[{"kind":"comment","id":110,"text":"Should we send a probe to Dantooine?","person_id":103,"created_at":"2024-08-20T12:00:00Z","updated_at":"2024-08-20T12:00:00Z","epic_id":5}]}]

Successful responses to this request return an array containing zero or more instances of the epic resource.

PARAMETERS

project_id

int in the request path.
required — The ID of the project.

filter

extended string in the request query.
— This parameter supplies a search string; only epics that match the search criteria are returned. How can a search be refined?


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
curl -X POST -H "X-TrackerToken: $TOKEN" -H "Content-Type: application/json" -d '{"name":"Tractor Beams"}' "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/epics"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 68
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"created_at":"2024-08-20T12:00:00Z","id":2100,"kind":"epic","label":{"kind":"label","id":5100,"project_id":99,"name":"tractor beams","created_at":"2024-08-20T12:00:00Z","updated_at":"2024-08-20T12:00:00Z"},"name":"Tractor Beams","project_id":99,"updated_at":"2024-08-20T12:00:00Z","url":"http://localhost/epic/show/2100"}


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
curl -X POST -H "X-TrackerToken: $TOKEN" -H "Content-Type: application/json" -d '{"description":"Install tractor beam systems in all landing bays. Beam systems should report to central monitoring.","label":{"name":"tractor-beams"},"name":"Tractor Beams"}' "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/epics"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 68
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"created_at":"2024-08-20T12:00:00Z","description":"Install tractor beam systems in all landing bays. Beam systems should report to central monitoring.","id":2100,"kind":"epic","label":{"kind":"label","id":5100,"project_id":99,"name":"tractor-beams","created_at":"2024-08-20T12:00:00Z","updated_at":"2024-08-20T12:00:00Z"},"name":"Tractor Beams","project_id":99,"updated_at":"2024-08-20T12:00:00Z","url":"http://localhost/epic/show/2100"}


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
curl -X POST -H "X-TrackerToken: $TOKEN" -H "Content-Type: application/json" -d '{"comments":[{"text":"Use this image on all external comms","file_attachments":[{"id":20,"uploader_id":101,"size":82382,"uploaded":false,"thumbnail_url":"#","download_url":"#","filename":"empire.png","big_url":"#","thumbnailable":true,"content_type":"image/png","created_at":"2024-08-20T12:00:00Z","width":1000,"height":804}]}],"name":"PR"}' "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/epics"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 68
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"created_at":"2024-08-20T12:00:00Z","id":2100,"kind":"epic","label":{"kind":"label","id":5100,"project_id":99,"name":"pr","created_at":"2024-08-20T12:00:00Z","updated_at":"2024-08-20T12:00:00Z"},"name":"PR","project_id":99,"updated_at":"2024-08-20T12:00:00Z","url":"http://localhost/epic/show/2100"}

Successful responses to this request return the epic resource.

PARAMETERS

project_id

int in the request path.
required — The ID of the project.

name

extended string[5000] in the request body.
required — Name of the epic.

label

label in the request body.
— This parameter allows a label to be selected by content or to be created implicitly as part of the basic request. See the 'label_id' attribute of the epic resource. The label's id must not be included if creating a new one.

label_id

int in the request body.
— id of the epic's label.

description

extended string[20000] in the request body.
— In-depth explanation of the epic's goals, scope, etc.

comments

List[comment] in the request body.
— This parameter allows creation of new comments implicitly as part of the basic request. See the 'comment_ids' attribute of the epic resource for how the resources relate. See the parameters of the POST to /projects/{project_id}/epics/{epic_id}/comments operation for keys that can be included in the nested hash in the parameters. The nested comments must not contain an id.

pull_requests

List[pull_request] in the request body.
— This parameter allows creation of new pull_requests implicitly as part of the basic request. See the 'pull_request_ids' attribute of the epic resource. The nested pull_requests must not contain an id.

branches

List[branch] in the request body.
— This parameter allows creation of new branches implicitly as part of the basic request. See the 'branch_ids' attribute of the epic resource. The nested branches must not contain an id.

followers

List[follower] in the request body.
— This parameter allows followers to be selected by content or to be created implicitly as part of the basic request. See the 'follower_ids' attribute of the epic resource. The followers' ids must not be included if creating a new one.

follower_ids

List[int] in the request body.
— IDs of people currently following the story.

after_id

int in the request body.
— id of the epic preceding the epic.

before_id

int in the request body.
— id of the epic following the epic.

Epic

ENDPOINT

/projects/{project_id}/epics/{epic_id}

GET Returns the specified epic.
PUT Updates an epic.
DELETE Deletes an epic.

Operations on an individual epic.


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
curl -X GET -H "X-TrackerToken: $TOKEN" "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/epics/5"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 66
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"created_at":"2024-08-20T12:00:00Z","description":"Identify the systems and eliminate the rebel scum.","id":5,"kind":"epic","label":{"id":2008,"project_id":99,"kind":"label","name":"rebel bases","created_at":"2024-08-20T12:00:00Z","updated_at":"2024-08-20T12:00:00Z"},"name":"Rebel Home Worlds","project_id":99,"updated_at":"2024-08-20T12:00:00Z","url":"http://localhost/epic/show/5"}


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
curl -X GET -H "X-TrackerToken: $TOKEN" "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/epics/5?fields=name%2Cproject%28enable_following%2Ctime_zone%2Cweek_start_day%2Cname%29"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 66
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"id":5,"name":"Rebel Home Worlds","project":{"id":99,"name":"Death Star","week_start_day":"Monday","time_zone":{"kind":"time_zone","olson_name":"America/Los_Angeles","offset":"-07:00"},"enable_following":true}}

Successful responses to this request return the epic resource.

PARAMETERS

project_id

int in the request path.
required — The ID of the project.

epic_id

int in the request path.
required — The ID of the epic.


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
curl -X PUT -H "X-TrackerToken: $TOKEN" -H "Content-Type: application/json" -d '{"description":"new desc"}' "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/epics/5"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 67
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"created_at":"2024-08-20T12:00:00Z","description":"new desc","id":5,"kind":"epic","label":{"kind":"label","id":2008,"project_id":99,"name":"rebel bases","created_at":"2024-08-20T12:00:00Z","updated_at":"2024-08-20T12:00:00Z"},"name":"Rebel Home Worlds","project_id":99,"updated_at":"2024-08-20T12:00:05Z","url":"http://localhost/epic/show/5"}


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
curl -X PUT -H "X-TrackerToken: $TOKEN" -H "Content-Type: application/json" -d '{"label":{"name":"find-rebels"}}' "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/epics/5?fields=name%2Clabel_id"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 68
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"id":5,"label_id":5100,"name":"Rebel Home Worlds"}

Successful responses to this request return the epic resource.

PARAMETERS

project_id

int in the request path.
required — The ID of the project.

epic_id

int in the request path.
required — The ID of the epic.

follower_ids

List[int] in the request body.
— The ids of the project members to follow the epic.

name

extended string[5000] in the request body.
— Name of the epic.

label

label_id

int in the request body.
— id of the epic's label.

description

extended string[20000] in the request body.
— In-depth explanation of the epic's goals, scope, etc.

after_id

int in the request body.
— id of the epic preceding the epic.

before_id

int in the request body.
— id of the epic following the epic.


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
curl -X DELETE -H "X-TrackerToken: $TOKEN" -H "Content-Type: application/json" "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/epics/5"



  
    View Response
  

  
    Hide Response

    
      status: 204
    

    
      Headers
        X-Tracker-Project-Version: 67
        Content-Type: application/json; potentially-other-variable-stuff

PARAMETERS

project_id

int in the request path.
required — The ID of the project.

epic_id

int in the request path.
required — The ID of the epic.

ENDPOINT

/epics/{epic_id}

GET Returns the specified epic.

Get an individual epic.


export TOKEN='your Pivotal Tracker API token'
curl -X GET -H "X-TrackerToken: $TOKEN" "https://www.pivotaltracker.com/services/v5/epics/5"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 66
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"created_at":"2024-08-20T12:00:00Z","description":"Identify the systems and eliminate the rebel scum.","id":5,"kind":"epic","label":{"id":2008,"project_id":99,"kind":"label","name":"rebel bases","created_at":"2024-08-20T12:00:00Z","updated_at":"2024-08-20T12:00:00Z"},"name":"Rebel Home Worlds","project_id":99,"updated_at":"2024-08-20T12:00:00Z","url":"http://localhost/epic/show/5"}

Successful responses to this request return the epic resource.

PARAMETERS

epic_id

int in the request path.
required — The ID of the epic.

Comments

ENDPOINT

/projects/{project_id}/stories/{story_id}/comments

GET Returns the specified story's comments.
POST Add a new comment.

Index of comments on an individual story.


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
export STORY_ID=555
curl -X GET -H "X-TrackerToken: $TOKEN" "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/stories/$STORY_ID/comments"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 66
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           [{"kind":"comment","id":112,"story_id":555,"text":"I want them alive!","person_id":101,"created_at":"2024-08-20T12:00:00Z","updated_at":"2024-08-20T12:00:00Z"}]

Successful responses to this request return the comment resource.

PARAMETERS

project_id

int in the request path.
required — The ID of the project.

story_id

int in the request path.
required — The ID of the story.

Note that to include file_attachments or google_attachments in a new comment, they must be identified using complete nested resources (JSON hashes, like the one in the response from performing an upload to /projects/{project_id}/uploads) rather than solely by ID. When attaching an uploaded file, the client should include the entire file_attachment resource hash that was received from the server in response to uploading the file—this includes the file_attachment resource's id attribute.


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
export STORY_ID=555
curl -X POST -H "X-TrackerToken: $TOKEN" -H "Content-Type: application/json" -d '{"text":"If this is a consular ship, then where is the ambassador 👅?"}' "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/stories/$STORY_ID/comments"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 67
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"created_at":"2024-08-20T12:00:00Z","id":300,"kind":"comment","person_id":101,"story_id":555,"text":"If this is a consular ship, then where is the ambassador 👅?","updated_at":"2024-08-20T12:00:00Z"}


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
export STORY_ID=555
curl -X POST -H "X-TrackerToken: $TOKEN" -H "Content-Type: application/json" -d '{"commit_identifier":"abc123","commit_type":"github"}' "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/stories/$STORY_ID/comments?fields=commit_identifier"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 67
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"commit_identifier":"abc123","id":300}


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
export STORY_ID=555
curl -X POST -H "X-TrackerToken: $TOKEN" -H "Content-Type: application/json" -d '{"person_id":104,"text":"Blame the clone for saying this."}' "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/stories/$STORY_ID/comments"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 67
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"created_at":"2024-08-20T12:00:00Z","id":300,"kind":"comment","person_id":104,"story_id":555,"text":"Blame the clone for saying this.","updated_at":"2024-08-20T12:00:00Z"}


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
export STORY_ID=555
curl -X POST -H "X-TrackerToken: $TOKEN" -H "Content-Type: application/json" -d '{"file_attachments":[{"id":24,"kind":"file_attachment","filename":"empire.png","size":82382,"width":1000,"height":804,"uploader_id":100,"thumbnail_url":"/attachments/0000/0024/empire_thumb.png","thumbnailable":true,"uploaded":true,"download_url":"/attachments/0000/0024/empire_big.png","created_at":"2024-08-20T12:00:00Z","content_type":"image/png"}],"text":"What if this were our new sigil?"}' "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/stories/$STORY_ID/comments?fields=%3Adefault%2Cfile_attachment_ids"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 67
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"created_at":"2024-08-20T12:00:00Z","file_attachment_ids":[24],"id":300,"kind":"comment","person_id":101,"story_id":555,"text":"What if this were our new sigil?","updated_at":"2024-08-20T12:00:00Z"}

Successful responses to this request return the comment resource.

PARAMETERS

project_id

int in the request path.
required — The ID of the project.

story_id

int in the request path.
required — The ID of the story.

text

extended string[20000] in the request body.
— Content of the comment.

person_id

int in the request body.
— The id of the comment creator.

file_attachments

List[file_attachment] in the request body.
— This parameter allows file_attachments to be selected by content as part of the basic request. See the 'file_attachment_ids' attribute of the comment resource. The file_attachments' ids must be included.

google_attachments

List[google_attachment] in the request body.
— This parameter allows creation of new google_attachments implicitly as part of the basic request. See the 'google_attachment_ids' attribute of the comment resource. The nested google_attachments must not contain an id.

attachments

List[attachment] in the request body.
— This parameter allows attachments to be selected by content as part of the basic request. See the 'attachment_ids' attribute of the comment resource. The attachments' ids must be included.

commit_identifier

string[255] in the request body.
— Commit Id on the remote source control system for the comment. Present only on comments that were created by a POST to the source commits API endpoint.

commit_type

string[255] in the request body.
— String identifying the type of remote source control system if Pivotal Tracker can determine it. Present only on comments that were created by a POST to the source commits API endpoint.

external_source

string[255] in the request body.
— String identifying, in case these comment has been cloned from another platform(eg. jira).

external_author

string[255] in the request body.
— Original author name at the source platform.

external_link

string[255] in the request body.
— Link of the actual comment at source platform.

ENDPOINT

/projects/{project_id}/stories/{story_id}/comments/{comment_id}

DELETE Deletes a comment.
GET Gets a comment.
PUT Updates a comment.

Operations on an individual comment.


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
export STORY_ID=564
curl -X DELETE -H "X-TrackerToken: $TOKEN" -H "Content-Type: application/json" "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/stories/$STORY_ID/comments/109"



  
    View Response
  

  
    Hide Response

    
      status: 204
    

    
      Headers
        X-Tracker-Project-Version: 67
        Content-Type: application/json; potentially-other-variable-stuff

PARAMETERS

project_id

int in the request path.
required — The ID of the project.

story_id

int in the request path.
required — The ID of the story.

comment_id

int in the request path.
required — The ID of the comment.


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
export STORY_ID=564
curl -X GET -H "X-TrackerToken: $TOKEN" "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/stories/$STORY_ID/comments/109"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 66
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"created_at":"2024-08-20T12:00:00Z","id":109,"kind":"comment","person_id":102,"story_id":564,"text":"I think you overestimate their chances!","updated_at":"2024-08-20T12:00:00Z"}

Successful responses to this request return the comment resource.

PARAMETERS

project_id

int in the request path.
required — The ID of the project.

story_id

int in the request path.
required — The ID of the story.

comment_id

int in the request path.
required — The ID of the comment.


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
export STORY_ID=564
curl -X PUT -H "X-TrackerToken: $TOKEN" -H "Content-Type: application/json" -d '{"text":"updated comment text"}' "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/stories/$STORY_ID/comments/109"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 67
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"created_at":"2024-08-20T12:00:00Z","id":109,"kind":"comment","person_id":102,"story_id":564,"text":"updated comment text","updated_at":"2024-08-20T12:00:05Z"}


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
export STORY_ID=564
curl -X PUT -H "X-TrackerToken: $TOKEN" -H "Content-Type: application/json" -d '{"file_attachment_ids_to_add":[21]}' "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/stories/$STORY_ID/comments/109?fields=%3Adefault%2Cfile_attachments"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 67
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"created_at":"2024-08-20T12:00:05Z","file_attachments":[{"kind":"file_attachment","id":21,"filename":"Corellian corvette deck plan.tiff","created_at":"2024-08-20T12:00:05Z","uploader_id":101,"thumbnailable":false,"height":216,"width":650,"size":561878,"download_url":"/attachments/0000/0021/Corellian corvette deck plan_big.tiff","thumbnail_url":"/attachments/0000/0021/Corellian corvette deck plan_thumb.tiff"}],"id":109,"kind":"comment","person_id":102,"story_id":564,"text":"I think you overestimate their chances!","updated_at":"2024-08-20T12:00:10Z"}


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
export STORY_ID=555
curl -X PUT -H "X-TrackerToken: $TOKEN" -H "Content-Type: application/json" -d '{"file_attachment_ids_to_remove":[21]}' "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/stories/$STORY_ID/comments/112?fields=%3Adefault%2Cfile_attachments"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 67
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"created_at":"2024-08-20T12:00:05Z","file_attachments":[{"kind":"file_attachment","id":20,"filename":"empire.png","created_at":"2024-08-20T12:00:05Z","uploader_id":100,"thumbnailable":true,"height":804,"width":1000,"size":82382,"download_url":"/attachments/0000/0020/empire_big.png","thumbnail_url":"/attachments/0000/0020/empire_thumb.png"}],"id":112,"kind":"comment","person_id":101,"story_id":555,"text":"I want them alive!","updated_at":"2024-08-20T12:00:10Z"}


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
export STORY_ID=555
curl -X PUT -H "X-TrackerToken: $TOKEN" -H "Content-Type: application/json" -d '{"google_attachment_ids_to_remove":[50]}' "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/stories/$STORY_ID/comments/112?fields=%3Adefault%2Cgoogle_attachments"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 67
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"created_at":"2024-08-20T12:00:00Z","google_attachments":[],"id":112,"kind":"comment","person_id":101,"story_id":555,"text":"I want them alive!","updated_at":"2024-08-20T12:00:05Z"}

Successful responses to this request return the comment resource.

PARAMETERS

project_id

int in the request path.
required — The ID of the project.

story_id

int in the request path.
required — The ID of the story.

comment_id

int in the request path.
required — The ID of the comment.

text

extended string in the request body.
— The updated text for the comment

file_attachment_ids_to_add

List[int] in the request body.
— list of ids for existing file attachments to attach to the comment

file_attachment_ids_to_remove

List[int] in the request body.
— list of ids for file attachments to detach from the comment

google_attachment_ids_to_remove

List[int] in the request body.
— list of ids for google attachments to remove from the comment

attachments_to_add

List[attachment] in the request body.
— list of objects for existing attachments to attach to the comment

attachment_ids_to_remove

List[identity_object] in the request body.
— list of identity objects for attachments to detach from the comment

ENDPOINT

/projects/{project_id}/epics/{epic_id}/comments

GET Returns the specified epic's comments.
POST Add a new comment.

Index of comments on an individual epic.


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
export EPIC_ID=5
curl -X GET -H "X-TrackerToken: $TOKEN" "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/epics/$EPIC_ID/comments"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 66
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           [{"kind":"comment","id":110,"epic_id":5,"text":"Should we send a probe to Dantooine?","person_id":103,"created_at":"2024-08-20T12:00:00Z","updated_at":"2024-08-20T12:00:00Z"}]


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
export EPIC_ID=5
curl -X GET -H "X-TrackerToken: $TOKEN" "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/epics/$EPIC_ID/comments/110?fields=file_attachments%2Cgoogle_attachments"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 66
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"file_attachments":[],"google_attachments":[],"id":110}

Successful responses to this request return the comment resource.

PARAMETERS

project_id

int in the request path.
required — The ID of the project.

epic_id

int in the request path.
required — The ID of the epic.


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
export EPIC_ID=5
curl -X POST -H "X-TrackerToken: $TOKEN" -H "Content-Type: application/json" -d '{"text":"This is my comment"}' "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/epics/$EPIC_ID/comments"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 67
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"created_at":"2024-08-20T12:00:00Z","epic_id":5,"id":300,"kind":"comment","person_id":103,"text":"This is my comment","updated_at":"2024-08-20T12:00:00Z"}

Successful responses to this request return the comment resource.

PARAMETERS

project_id

int in the request path.
required — The ID of the project.

epic_id

int in the request path.
required — The ID of the epic.

text

extended string[20000] in the request body.
— Content of the comment.

person_id

int in the request body.
— The id of the comment creator.

file_attachments

google_attachments

attachments

commit_identifier

string[255] in the request body.
— Commit Id on the remote source control system for the comment. Present only on comments that were created by a POST to the source commits API endpoint.

commit_type

external_source

string[255] in the request body.
— String identifying, in case these comment has been cloned from another platform(eg. jira).

external_author

string[255] in the request body.
— Original author name at the source platform.

external_link

string[255] in the request body.
— Link of the actual comment at source platform.

ENDPOINT

/projects/{project_id}/epics/{epic_id}/comments/{comment_id}

DELETE Deletes a comment.
GET Gets a comment.
PUT Updates a comment.

Operations on an individual comment.


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
export EPIC_ID=5
curl -X DELETE -H "X-TrackerToken: $TOKEN" -H "Content-Type: application/json" "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/epics/$EPIC_ID/comments/110"



  
    View Response
  

  
    Hide Response

    
      status: 204
    

    
      Headers
        X-Tracker-Project-Version: 67
        Content-Type: application/json; potentially-other-variable-stuff

PARAMETERS

project_id

int in the request path.
required — The ID of the project.

epic_id

int in the request path.
required — The ID of the epic.

comment_id

int in the request path.
required — The ID of the comment.


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
export EPIC_ID=5
curl -X GET -H "X-TrackerToken: $TOKEN" "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/epics/$EPIC_ID/comments/110"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 66
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"created_at":"2024-08-20T12:00:00Z","epic_id":5,"id":110,"kind":"comment","person_id":103,"text":"Should we send a probe to Dantooine?","updated_at":"2024-08-20T12:00:00Z"}

Successful responses to this request return the comment resource.

PARAMETERS

project_id

int in the request path.
required — The ID of the project.

epic_id

int in the request path.
required — The ID of the epic.

comment_id

int in the request path.
required — The ID of the comment.


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
export EPIC_ID=5
curl -X PUT -H "X-TrackerToken: $TOKEN" -H "Content-Type: application/json" -d '{"text":"updated comment text"}' "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/epics/$EPIC_ID/comments/110"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 67
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"created_at":"2024-08-20T12:00:00Z","epic_id":5,"id":110,"kind":"comment","person_id":103,"text":"updated comment text","updated_at":"2024-08-20T12:00:05Z"}


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
export EPIC_ID=5
curl -X PUT -H "X-TrackerToken: $TOKEN" -H "Content-Type: application/json" -d '{"file_attachment_ids_to_add":[26]}' "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/epics/$EPIC_ID/comments/110?fields=%3Adefault%2Cfile_attachments"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 67
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"created_at":"2024-08-20T12:00:00Z","epic_id":5,"file_attachments":[{"kind":"file_attachment","id":26,"filename":"empire_thumb.png","created_at":"2024-08-20T12:00:00Z","thumbnailable":false,"height":58,"width":72,"size":82382,"download_url":"/attachments/0000/0020/empire_thumb_big.png","thumbnail_url":"/attachments/0000/0020/empire_thumb_thumb.png"}],"id":110,"kind":"comment","person_id":103,"text":"Should we send a probe to Dantooine?","updated_at":"2024-08-20T12:00:05Z"}


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
export EPIC_ID=6
curl -X PUT -H "X-TrackerToken: $TOKEN" -H "Content-Type: application/json" -d '{"file_attachment_ids_to_remove":[22]}' "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/epics/$EPIC_ID/comments/111?fields=%3Adefault%2Cfile_attachments"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 67
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"created_at":"2024-08-20T12:00:00Z","epic_id":6,"file_attachments":[],"id":111,"kind":"comment","person_id":103,"text":"Check out these Uffel mouse droids","updated_at":"2024-08-20T12:00:05Z"}

Successful responses to this request return the comment resource.

PARAMETERS

project_id

int in the request path.
required — The ID of the project.

epic_id

int in the request path.
required — The ID of the epic.

comment_id

int in the request path.
required — The ID of the comment.

text

extended string in the request body.
— The updated text for the comment

file_attachment_ids_to_add

List[int] in the request body.
— list of ids for existing file attachments to attach to the comment

file_attachment_ids_to_remove

List[int] in the request body.
— list of ids for file attachments to detach from the comment

attachments_to_add

List[attachment] in the request body.
— list of objects for existing attachments to attach to the comment

attachment_ids_to_remove

List[identity_object] in the request body.
— list of identity objects for attachments to detach from the comment

Attachments

ENDPOINT

/projects/{project_id}/stories/{story_id}/comments/{comment_id}/file_attachments/{file_attachment_id}

DELETE Deletes a file attachment.

Operations on an individual file attachment.


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
export STORY_ID=555
export COMMENT_ID=112
curl -X DELETE -H "X-TrackerToken: $TOKEN" -H "Content-Type: application/json" "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/stories/$STORY_ID/comments/$COMMENT_ID/file_attachments/21"



  
    View Response
  

  
    Hide Response

    
      status: 204
    

    
      Headers
        X-Tracker-Project-Version: 67
        Content-Type: application/json; potentially-other-variable-stuff

PARAMETERS

project_id

int in the request path.
required — The ID of the project.

story_id

int in the request path.
required — The ID of the story.

comment_id

int in the request path.
required — The ID of the comment.

file_attachment_id

int in the request path.
required — The ID of the file_attachment.

ENDPOINT

/projects/{project_id}/stories/{story_id}/comments/{comment_id}/google_attachments/{google_attachment_id}

DELETE Deletes a google attachment.

Operations on an individual google attachment.


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
export STORY_ID=555
export COMMENT_ID=112
curl -X DELETE -H "X-TrackerToken: $TOKEN" -H "Content-Type: application/json" "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/stories/$STORY_ID/comments/$COMMENT_ID/google_attachments/50"



  
    View Response
  

  
    Hide Response

    
      status: 204
    

    
      Headers
        X-Tracker-Project-Version: 67
        Content-Type: application/json; potentially-other-variable-stuff

PARAMETERS

project_id

int in the request path.
required — The ID of the project.

story_id

int in the request path.
required — The ID of the story.

comment_id

int in the request path.
required — The ID of the comment.

google_attachment_id

int in the request path.
required — The ID of the google_attachment.

ENDPOINT

/projects/{project_id}/epics/{epic_id}/comments/{comment_id}/file_attachments/{file_attachment_id}

DELETE Deletes a file attachment.

Operations on an individual file attachment.


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
export EPIC_ID=6
export COMMENT_ID=111
curl -X DELETE -H "X-TrackerToken: $TOKEN" -H "Content-Type: application/json" "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/epics/$EPIC_ID/comments/$COMMENT_ID/file_attachments/22"



  
    View Response
  

  
    Hide Response

    
      status: 204
    

    
      Headers
        X-Tracker-Project-Version: 67
        Content-Type: application/json; potentially-other-variable-stuff

PARAMETERS

project_id

int in the request path.
required — The ID of the project.

epic_id

int in the request path.
required — The ID of the epic.

comment_id

int in the request path.
required — The ID of the comment.

file_attachment_id

int in the request path.
required — The ID of the file_attachment.

ENDPOINT

/projects/{project_id}/epics/{epic_id}/comments/{comment_id}/google_attachments/{google_attachment_id}

DELETE Deletes a google attachment.

Operations on an individual google attachment.


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
export EPIC_ID=6
export COMMENT_ID=111
curl -X DELETE -H "X-TrackerToken: $TOKEN" -H "Content-Type: application/json" "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/epics/$EPIC_ID/comments/$COMMENT_ID/google_attachments/51"



  
    View Response
  

  
    Hide Response

    
      status: 204
    

    
      Headers
        X-Tracker-Project-Version: 67
        Content-Type: application/json; potentially-other-variable-stuff

PARAMETERS

project_id

int in the request path.
required — The ID of the project.

epic_id

int in the request path.
required — The ID of the epic.

comment_id

int in the request path.
required — The ID of the comment.

google_attachment_id

int in the request path.
required — The ID of the google_attachment.

ENDPOINT

/projects/{project_id}/uploads

POST Upload a file to the Tracker server. Tracker will create a matching file_attachment object which can be attached to a future comment on a story.

Upload content for a new file_attachment object.


export TOKEN='your Pivotal Tracker API token'
export FILE_PATH='/home/vader/art-projects/new-imperial-logo-6.jpg'
export PROJECT_ID=99
curl -X POST -H "X-TrackerToken: $TOKEN" -F file=@"$FILE_PATH" "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/uploads"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 66
        Content-Type: text/html
    

       Response Body
         
           "{\"kind\":\"file_attachment\",\"id\":300,\"filename\":\"new-imperial-logo.jpg\",\"created_at\":\"2024-08-21T12:00:00Z\",\"uploader_id\":101,\"thumbnailable\":true,\"height\":1995,\"width\":2000,\"size\":96228,\"download_url\":\"/file_attachments/300/download\",\"content_type\":\"image/jpeg\",\"uploaded\":false,\"big_url\":\"#\",\"thumbnail_url\":\"#\"}"

Successful responses to this request return the file_attachment resource.

PARAMETERS

project_id

int in the request path.
required — The ID of the project.

comment

object in the request body.
— The comment with which the file attachment will be associated.

file

binary form data in the request body.
required — The content of the file being uploaded. It is expected to be incorporated in the multipart data with a 'Content-Disposition' of 'form-data; name="file"; filename="imperial_banner.png"'. The file extension is used to determine the file's content type. A Content-Type header may be supplied, but it is not used to determine the file type.

The HTTP body for this request should not be JSON-encoded. Instead, the request's Content-type should be multipart/form-data.

ENDPOINT

https://www.pivotaltracker.com/file_attachments/{file_attachment_id}/download

GET Response to this get will either be the content of the file or a redirect to a non-Tracker storage server that will provide the attachment (i.e., S3).

Download the original file content of an attachment.

PARAMETERS

file_attachment_id

int in the request path.
required — The ID of the file_attachment.

inline

boolean in the request query.
— Determines if server should include response headers that would cause a browser to show the attachment in a new tab or window (inline=true) or show a Save dialog box (inline=false). Default is false.

Search

ENDPOINT

/projects/{project_id}/search

GET Search for stories and epics.

GET only; searches the project data and returns the stories and/or epics matching the query_string.

Searches can be refined with all of the modifications listed here: How can a search be refined?

On endpoints that support filters, 'filter' can only be combined with project_id, date_format, limit and offset. All other parameters will result in an error.

label:"jedi stuff" keyword

keyword created_since:11/16/2009 has_attachment:


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
curl -X GET -H "X-TrackerToken: $TOKEN" "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/search?query=label%3Amnt+AND+includedone%3Atrue"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 66
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"epics":{"epics":[],"total_hits":0},"query":"label:mnt AND includedone:true","stories":{"stories":[{"kind":"story","id":566,"created_at":"2024-08-20T12:00:00Z","updated_at":"2024-08-20T12:00:05Z","story_type":"feature","name":"Clean Cell Block 1138","description":"The large, hairy _Thing_ is being transferred away","current_state":"unstarted","requested_by_id":104,"project_id":99,"url":"http://localhost:3000/story/show/566","owner_ids":[],"labels":[{"id":2010,"project_id":99,"kind":"label","name":"mnt","created_at":"2024-08-20T12:00:00Z","updated_at":"2024-08-20T12:00:00Z"}]},{"kind":"story","id":564,"created_at":"2024-08-20T12:00:00Z","updated_at":"2024-08-20T12:00:10Z","story_type":"feature","name":"Reactor leak reported in Detention Block AA-23","description":"large leak, very dangerous","current_state":"unstarted","requested_by_id":103,"project_id":99,"url":"http://localhost:3000/story/show/564","owner_ids":[],"labels":[{"id":2010,"project_id":99,"kind":"label","name":"mnt","created_at":"2024-08-20T12:00:00Z","updated_at":"2024-08-20T12:00:00Z"}]}],"total_points":0,"total_points_completed":0,"total_hits":2,"total_hits_with_done":2}}

Successful responses to this request return the search_result_container resource.

PARAMETERS

project_id

int in the request path.
required — The ID of the project.

query

extended string in the request query.
required — String containing the search terms and options. How can a search be refined?

Saved Search

ENDPOINT

/projects/{project_id}/my/searches

GET Provides a list of the searches which have been saved by the current person.
POST Saves a new search.

Access the saved searches for the currently logged-in person.


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
curl -X GET -H "X-TrackerToken: $TOKEN" "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/my/searches"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 66
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           [{"kind":"saved_search","id":4,"project_id":99,"name":"New Maintenance Issues","query":"label:\"mnt\" state:unscheduled"},{"kind":"saved_search","id":5,"project_id":99,"name":"Family","query":"luke, leia"}]

Successful responses to this request return an array containing zero or more instances of the saved_search resource.

PARAMETERS

project_id

int in the request path.
required — The ID of the project.

Searches can be refined with all of the modifications listed here: How can a search be refined?

On endpoints that support filters, 'filter' can only be combined with project_id, date_format, limit and offset. All other parameters will result in an error.

label:"jedi stuff" keyword

keyword created_since:11/16/2009 has_attachment:


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
curl -X POST -H "X-TrackerToken: $TOKEN" -H "Content-Type: application/json" -d '{"name":"my saved search","query":"label:\"rebel bases\""}' "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/my/searches"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 66
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"id":300,"kind":"saved_search","name":"my saved search","project_id":99,"query":"label:\"rebel bases\""}

Successful responses to this request return the saved_search resource.

PARAMETERS

project_id

int in the request path.
required — The ID of the project.

name

string[255] in the request body.
required — Name of the saved search.

query

string[1000] in the request body.
required — The search criteria string containing search terms and options which were specified for this saved search. How can a search be refined?

ENDPOINT

/projects/{project_id}/my/searches/{search_id}

DELETE Deletes a saved search.

Deleted a saved search for the currently logged-in person.


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
curl -X DELETE -H "X-TrackerToken: $TOKEN" -H "Content-Type: application/json" "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/my/searches/5"



  
    View Response
  

  
    Hide Response

    
      status: 204
    

    
      Headers
        X-Tracker-Project-Version: 66
        Content-Type: application/json; potentially-other-variable-stuff

PARAMETERS

project_id

int in the request path.
required — The ID of the project.

search_id

int in the request path.
required — The ID of the search.

Activity

ENDPOINT

/my/activity

GET Return list of the selected activity for the authenticated person. (Paginated)

Provides a list of all the activity performed by you. (Limited to the most recent six months of activity performed in projects that are in accounts on any non-Enterprise subscription plan, and to at least the last 25 months of activity for projects in an account on an Enterprise subscription plan.)


export TOKEN='your Pivotal Tracker API token'
curl -X GET -H "X-TrackerToken: $TOKEN" "https://www.pivotaltracker.com/services/v5/my/activity"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Pagination-Limit: 100
        X-Tracker-Pagination-Offset: 0
        X-Tracker-Pagination-Total: 15
        X-Tracker-Pagination-Returned: 15
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           [{"kind":"story_move_activity","guid":"99_65","project_version":65,"message":"Darth Vader moved 2 stories","highlight":"moved","changes":[{"kind":"story","change_type":"update","id":562,"original_values":{"before_id":551},"new_values":{"before_id":557},"name":"Garbage smashers on the detention level have malfunctioned","story_type":"bug","story_priority":"p3"},{"kind":"story","change_type":"update","id":564,"original_values":{"after_id":557},"new_values":{"after_id":565},"name":"Evacuate, in our moment of triumph","story_type":"feature","story_priority":"p3"}],"primary_resources":[{"kind":"story","id":564,"name":"Evacuate, in our moment of triumph","story_type":"feature","url":"http://localhost/story/show/564","story_priority":"p3"},{"kind":"story","id":562,"name":"Garbage smashers on the detention level have malfunctioned","story_type":"bug","url":"http://localhost/story/show/562","story_priority":"p3"}],"secondary_resources":[],"project":{"kind":"project","id":99,"name":"Death Star"},"performed_by":{"kind":"person","id":101,"name":"Darth Vader","initials":"DV"},"occurred_at":"2024-08-20T12:00:05Z"},{"kind":"story_move_activity","guid":"99_64","project_version":64,"message":"Darth Vader moved 2 stories","highlight":"moved","changes":[{"kind":"story","change_type":"update","id":562,"original_values":{"before_id":557},"new_values":{"before_id":551},"name":"Garbage smashers on the detention level have malfunctioned","story_type":"bug","story_priority":"p3"},{"kind":"story","change_type":"update","id":564,"original_values":{"after_id":565},"new_values":{"after_id":557},"name":"Evacuate, in our moment of triumph","story_type":"feature","story_priority":"p3"}],"primary_resources":[{"kind":"story","id":564,"name":"Evacuate, in our moment of triumph","story_type":"feature","url":"http://localhost/story/show/564","story_priority":"p3"},{"kind":"story","id":562,"name":"Garbage smashers on the detention level have malfunctioned","story_type":"bug","url":"http://localhost/story/show/562","story_priority":"p3"}],"secondary_resources":[],"project":{"kind":"project","id":99,"name":"Death Star"},"performed_by":{"kind":"person","id":101,"name":"Darth Vader","initials":"DV"},"occurred_at":"2024-08-20T12:00:05Z"},{"kind":"comment_create_activity","guid":"99_62","project_version":62,"message":"Darth Vader added comment: \"I want them alive!\"","highlight":"added comment:","changes":[{"kind":"comment","change_type":"create","id":112,"new_values":{"id":112,"story_id":555,"text":"I want them alive!","person_id":101,"created_at":"2024-08-20T12:00:05Z","updated_at":"2024-08-20T12:00:05Z","file_attachment_ids":[],"google_attachment_ids":[],"attachment_ids":[],"file_attachments":[],"google_attachments":[]}},{"kind":"story","change_type":"update","id":555,"original_values":{"follower_ids":[]},"new_values":{"follower_ids":[101]},"name":"Bring me the passengers","story_type":"feature","story_priority":"p3"}],"primary_resources":[{"kind":"story","id":555,"name":"Bring me the passengers","story_type":"feature","url":"http://localhost/story/show/555","story_priority":"p3"}],"secondary_resources":[],"project":{"kind":"project","id":99,"name":"Death Star"},"performed_by":{"kind":"person","id":101,"name":"Darth Vader","initials":"DV"},"occurred_at":"2024-08-20T12:00:05Z"},{"kind":"story_update_activity","guid":"99_56","project_version":56,"message":"Darth Vader unstarted this feature","highlight":"unstarted","changes":[{"kind":"story","change_type":"update","id":555,"original_values":{"current_state":"unscheduled","before_id":551,"after_id":557},"new_values":{"current_state":"unstarted","before_id":567,"after_id":552},"name":"Bring me the passengers","story_type":"feature","story_priority":"p3"}],"primary_resources":[{"kind":"story","id":555,"name":"Bring me the passengers","story_type":"feature","url":"http://localhost/story/show/555","story_priority":"p3"}],"secondary_resources":[],"project":{"kind":"project","id":99,"name":"Death Star"},"performed_by":{"kind":"person","id":101,"name":"Darth Vader","initials":"DV"},"occurred_at":"2024-08-20T12:00:05Z"},{"kind":"story_update_activity","guid":"99_54","project_version":54,"message":"Darth Vader rejected this feature","highlight":"rejected","changes":[{"kind":"label","change_type":"update","id":2009,"original_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":3,"started":2,"finished":0,"unstarted":0,"planned":0,"delivered":3,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":1,"started":1,"finished":0,"unstarted":0,"planned":0,"delivered":1,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"new_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":3,"started":2,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":3,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":1,"started":1,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":1,"kind":"counts_by_story_state"},"kind":"story_counts"}},"name":"plans"},{"kind":"story","change_type":"update","id":559,"original_values":{"current_state":"delivered"},"new_values":{"current_state":"rejected"},"name":"All exhaust ports should be shielded","story_type":"feature","story_priority":"p3"}],"primary_resources":[{"kind":"story","id":559,"name":"All exhaust ports should be shielded","story_type":"feature","url":"http://localhost/story/show/559","story_priority":"p3"}],"secondary_resources":[],"project":{"kind":"project","id":99,"name":"Death Star"},"performed_by":{"kind":"person","id":101,"name":"Darth Vader","initials":"DV"},"occurred_at":"2024-08-20T12:00:05Z"},{"kind":"story_update_activity","guid":"99_48","project_version":48,"message":"Darth Vader started this feature","highlight":"started","changes":[{"kind":"label","change_type":"update","id":2008,"original_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":4,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":2,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":2,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":1,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"new_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":4,"started":2,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":2,"started":1,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"name":"rebel bases"},{"kind":"label","change_type":"update","id":2009,"original_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":3,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":5,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":1,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":2,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"new_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":3,"started":2,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":3,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":1,"started":1,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":1,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"name":"plans"},{"kind":"story","change_type":"update","id":556,"original_values":{"current_state":"unscheduled","before_id":555,"after_id":557},"new_values":{"current_state":"started","before_id":567,"after_id":560},"name":"Interrogate Leia Organa","story_type":"feature","story_priority":"p3"}],"primary_resources":[{"kind":"story","id":556,"name":"Interrogate Leia Organa","story_type":"feature","url":"http://localhost/story/show/556","story_priority":"p3"}],"secondary_resources":[],"project":{"kind":"project","id":99,"name":"Death Star"},"performed_by":{"kind":"person","id":101,"name":"Darth Vader","initials":"DV"},"occurred_at":"2024-08-20T12:00:05Z"},{"kind":"story_update_activity","guid":"99_47","project_version":47,"message":"Darth Vader accepted this feature","highlight":"accepted","changes":[{"kind":"label","change_type":"update","id":2008,"original_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":3,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":1,"unscheduled":2,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":1,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":1,"unscheduled":1,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"new_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":4,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":2,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":2,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":1,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"name":"rebel bases"},{"kind":"story","change_type":"update","id":560,"original_values":{"current_state":"delivered","accepted_at":null},"new_values":{"current_state":"accepted","accepted_at":"2024-08-20T12:00:05Z"},"name":"Destroy Alderaan","story_type":"feature","story_priority":"p3"}],"primary_resources":[{"kind":"story","id":560,"name":"Destroy Alderaan","story_type":"feature","url":"http://localhost/story/show/560","story_priority":"p3"}],"secondary_resources":[],"project":{"kind":"project","id":99,"name":"Death Star"},"performed_by":{"kind":"person","id":101,"name":"Darth Vader","initials":"DV"},"occurred_at":"2024-08-20T12:00:05Z"},{"kind":"story_update_activity","guid":"99_43","project_version":43,"message":"Darth Vader edited this feature","highlight":"edited","changes":[{"kind":"label","change_type":"update","id":2008,"original_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":3,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":1,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":1,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":1,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"new_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":3,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":3,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":1,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":2,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"name":"rebel bases"},{"kind":"label","change_type":"update","id":2009,"original_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":3,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":3,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":1,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":1,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"new_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":3,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":5,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":1,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":2,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"name":"plans"},{"kind":"label","change_type":"update","id":2015,"original_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":3,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":2,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"new_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":1,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":1,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"name":"diplomatic relations"},{"kind":"story","change_type":"update","id":556,"original_values":{"label_ids":[2015],"labels":["diplomatic relations"]},"new_values":{"label_ids":[2009,2008],"labels":["plans","rebel bases"]},"name":"Interrogate Leia Organa","story_type":"feature","story_priority":"p3"}],"primary_resources":[{"kind":"story","id":556,"name":"Interrogate Leia Organa","story_type":"feature","url":"http://localhost/story/show/556","story_priority":"p3"}],"secondary_resources":[],"project":{"kind":"project","id":99,"name":"Death Star"},"performed_by":{"kind":"person","id":101,"name":"Darth Vader","initials":"DV"},"occurred_at":"2024-08-20T12:00:05Z"},{"kind":"story_create_activity","guid":"98_2","project_version":2,"message":"Darth Vader added this feature","highlight":"added","changes":[{"kind":"story","change_type":"create","id":568,"new_values":{"id":568,"project_id":98,"name":"Midi-chlorians","description":"Without the midi-chlorians, life could not exist, and we would have no knowledge of the Force. They continually speak to us, telling us the will of the Force. When you learn to quiet your mind, you'll hear them speaking to you","story_type":"feature","current_state":"unstarted","estimate":3,"requested_by_id":101,"owned_by_id":101,"owner_ids":[101],"label_ids":[],"follower_ids":[],"created_at":"2024-08-20T12:00:05Z","updated_at":"2024-08-20T12:00:05Z","blocked_story_ids":[],"story_priority":"p3","labels":[]},"name":"Midi-chlorians","story_type":"feature","story_priority":"p3"}],"primary_resources":[{"kind":"story","id":568,"name":"Midi-chlorians","story_type":"feature","url":"http://localhost/story/show/568","story_priority":"p3"}],"secondary_resources":[],"project":{"kind":"project","id":98,"name":"Learn About the Force"},"performed_by":{"kind":"person","id":101,"name":"Darth Vader","initials":"DV"},"occurred_at":"2024-08-20T12:00:05Z"},{"kind":"story_create_activity","guid":"99_11","project_version":11,"message":"Darth Vader added this feature","highlight":"added","changes":[{"kind":"story","change_type":"create","id":558,"new_values":{"id":558,"project_id":99,"name":"Contact Lando","story_type":"feature","current_state":"accepted","estimate":1,"accepted_at":"2024-08-20T12:00:05Z","requested_by_id":101,"owner_ids":[],"label_ids":[],"follower_ids":[],"created_at":"2024-08-20T12:00:05Z","updated_at":"2024-08-20T12:00:05Z","before_id":557,"after_id":553,"blocked_story_ids":[],"story_priority":"p3","labels":[]},"name":"Contact Lando","story_type":"feature","story_priority":"p3"}],"primary_resources":[{"kind":"story","id":558,"name":"Contact Lando","story_type":"feature","url":"http://localhost/story/show/558","story_priority":"p3"}],"secondary_resources":[],"project":{"kind":"project","id":99,"name":"Death Star"},"performed_by":{"kind":"person","id":101,"name":"Darth Vader","initials":"DV"},"occurred_at":"2024-08-20T12:00:05Z"},{"kind":"story_create_activity","guid":"99_10","project_version":10,"message":"Darth Vader added this feature","highlight":"added","changes":[{"kind":"story","change_type":"create","id":557,"new_values":{"id":557,"project_id":99,"name":"Prepare carbonite freezing chamber","description":"Test first on Solo, we don't want the Emperor's prize damaged.","story_type":"feature","current_state":"unscheduled","requested_by_id":101,"owner_ids":[],"label_ids":[2014],"follower_ids":[],"created_at":"2024-08-20T12:00:05Z","updated_at":"2024-08-20T12:00:05Z","before_id":556,"after_id":553,"blocked_story_ids":[],"story_priority":"p3","labels":["r&d"]},"name":"Prepare carbonite freezing chamber","story_type":"feature","story_priority":"p3"},{"kind":"label","change_type":"update","id":2014,"original_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":3,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":1,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"new_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":1,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":3,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":1,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":1,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"name":"r&d"}],"primary_resources":[{"kind":"story","id":557,"name":"Prepare carbonite freezing chamber","story_type":"feature","url":"http://localhost/story/show/557","story_priority":"p3"}],"secondary_resources":[],"project":{"kind":"project","id":99,"name":"Death Star"},"performed_by":{"kind":"person","id":101,"name":"Darth Vader","initials":"DV"},"occurred_at":"2024-08-20T12:00:05Z"},{"kind":"story_create_activity","guid":"99_9","project_version":9,"message":"Darth Vader added this feature","highlight":"added","changes":[{"kind":"story","change_type":"create","id":556,"new_values":{"id":556,"project_id":99,"name":"Interrogate Leia Organa","description":"She is proving to be resistant to our mind probes","story_type":"feature","current_state":"unscheduled","requested_by_id":101,"owned_by_id":101,"owner_ids":[101,105],"label_ids":[2015],"follower_ids":[],"created_at":"2024-08-20T12:00:05Z","updated_at":"2024-08-20T12:00:05Z","before_id":555,"after_id":553,"blocked_story_ids":[],"story_priority":"p3","labels":["diplomatic relations"]},"name":"Interrogate Leia Organa","story_type":"feature","story_priority":"p3"},{"kind":"label","change_type":"update","id":2015,"original_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":1,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":1,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"new_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":2,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":2,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"name":"diplomatic relations"}],"primary_resources":[{"kind":"story","id":556,"name":"Interrogate Leia Organa","story_type":"feature","url":"http://localhost/story/show/556","story_priority":"p3"}],"secondary_resources":[],"project":{"kind":"project","id":99,"name":"Death Star"},"performed_by":{"kind":"person","id":101,"name":"Darth Vader","initials":"DV"},"occurred_at":"2024-08-20T12:00:05Z"},{"kind":"story_create_activity","guid":"99_8","project_version":8,"message":"Darth Vader added this feature","highlight":"added","changes":[{"kind":"story","change_type":"create","id":555,"new_values":{"id":555,"project_id":99,"name":"Bring me the passengers","description":"ignore the droids","story_type":"feature","current_state":"unscheduled","requested_by_id":101,"owner_ids":[],"label_ids":[],"follower_ids":[],"created_at":"2024-08-20T12:00:05Z","updated_at":"2024-08-20T12:00:05Z","before_id":554,"after_id":553,"blocked_story_ids":[],"story_priority":"p3","labels":[]},"name":"Bring me the passengers","story_type":"feature","story_priority":"p3"}],"primary_resources":[{"kind":"story","id":555,"name":"Bring me the passengers","story_type":"feature","url":"http://localhost/story/show/555","story_priority":"p3"}],"secondary_resources":[],"project":{"kind":"project","id":99,"name":"Death Star"},"performed_by":{"kind":"person","id":101,"name":"Darth Vader","initials":"DV"},"occurred_at":"2024-08-20T12:00:05Z"},{"kind":"story_create_activity","guid":"99_7","project_version":7,"message":"Darth Vader added this feature","highlight":"added","changes":[{"kind":"story","change_type":"create","id":554,"new_values":{"id":554,"project_id":99,"name":"Identify Bothan spies","description":"Infiltrate their spy network.","story_type":"feature","current_state":"unscheduled","requested_by_id":101,"owned_by_id":106,"owner_ids":[106],"label_ids":[],"follower_ids":[],"created_at":"2024-08-20T12:00:05Z","updated_at":"2024-08-20T12:00:05Z","before_id":552,"after_id":553,"blocked_story_ids":[],"story_priority":"p3","labels":[]},"name":"Identify Bothan spies","story_type":"feature","story_priority":"p3"}],"primary_resources":[{"kind":"story","id":554,"name":"Identify Bothan spies","story_type":"feature","url":"http://localhost/story/show/554","story_priority":"p3"}],"secondary_resources":[],"project":{"kind":"project","id":99,"name":"Death Star"},"performed_by":{"kind":"person","id":101,"name":"Darth Vader","initials":"DV"},"occurred_at":"2024-08-20T12:00:05Z"},{"kind":"story_create_activity","guid":"99_6","project_version":6,"message":"Darth Vader added this feature","highlight":"added","changes":[{"kind":"story","change_type":"create","id":553,"new_values":{"id":553,"project_id":99,"name":"Build protocol droid","description":"I want a friend","story_type":"feature","current_state":"accepted","estimate":3,"accepted_at":"2024-08-20T12:00:05Z","requested_by_id":101,"owned_by_id":101,"owner_ids":[101],"label_ids":[2014,2008],"follower_ids":[],"created_at":"2024-08-20T12:00:05Z","updated_at":"2024-08-20T12:00:05Z","before_id":552,"blocked_story_ids":[],"story_priority":"p3","labels":["r&d","rebel bases"]},"name":"Build protocol droid","story_type":"feature","story_priority":"p3"},{"kind":"label","change_type":"update","id":2008,"original_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"new_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":3,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":1,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"name":"rebel bases"},{"kind":"label","change_type":"update","id":2014,"original_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"new_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":3,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":1,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"name":"r&d"}],"primary_resources":[{"kind":"story","id":553,"name":"Build protocol droid","story_type":"feature","url":"http://localhost/story/show/553","story_priority":"p3"}],"secondary_resources":[],"project":{"kind":"project","id":99,"name":"Death Star"},"performed_by":{"kind":"person","id":101,"name":"Darth Vader","initials":"DV"},"occurred_at":"2024-08-20T12:00:05Z"}]

Successful responses to this request return an array containing zero or more instances of an activity-type resource. In particular, any mix of any of the following: blocker_create_activity, blocker_delete_activity, blocker_update_activity, blocking_create_activity, blocking_delete_activity, branch_create_activity, branch_delete_activity, cicd_event_create_activity, comment_create_activity, comment_delete_activity, comment_update_activity, epic_create_activity, epic_delete_activity, epic_move_activity, epic_update_activity, follower_create_activity, follower_delete_activity, iteration_update_activity, label_create_activity, label_delete_activity, label_merge_activity, label_update_activity, model_import_activity, project_membership_create_activity, project_membership_delete_activity, project_membership_update_activity, project_update_activity, pull_request_create_activity, pull_request_delete_activity, pull_request_update_activity, reaction_create_activity, reaction_delete_activity, reaction_update_activity, review_create_activity, review_delete_activity, review_type_create_activity, review_type_update_activity, review_update_activity, story_create_activity, story_delete_activity, story_move_activity, story_move_from_project_activity, story_move_into_project_activity, story_move_into_project_and_prioritize_activity, story_update_activity, task_create_activity, task_delete_activity, task_update_activity. The response from this request is paginated, see Paginating List Responses.

PARAMETERS

limit

int[pos] in the request query.
— The number of activity items you want returned.

offset

int[pos] in the request query.
— Index of the first activity item you want, starting from zero.

occurred_before

datetime in the request query.
— Activity will be returned only for operations that occurred before the time specified by this parameter.

occurred_after

datetime in the request query.
— Activity will be returned only for operations that occurred after the time specified by this parameter.

sort_order

enumerated string in the request query.
— The order to return the activity. Defaults to descending (most recent first).

Valid enumeration values: asc, desc

ENDPOINT

/projects/{project_id}/activity

GET Return list of the selected project activity. (Paginated)

Provides a list of all the activity performed on a project. (Limited to the most recent six months of activity performed in projects that are in accounts on any non-Enterprise subscription plan, and to at least the last 25 months of activity for projects in an account on an Enterprise subscription plan.)


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
curl -X GET -H "X-TrackerToken: $TOKEN" "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/activity?limit=1"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Pagination-Limit: 1
        X-Tracker-Pagination-Offset: 0
        X-Tracker-Pagination-Total: 65
        X-Tracker-Pagination-Returned: 1
        X-Tracker-Project-Version: 66
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           [{"kind":"iteration_update_activity","guid":"99_66","project_version":66,"message":"Wilhuff Tarkin changed iteration 1's length from default to 2 weeks","highlight":"changed","changes":[{"kind":"iteration_override","change_type":"update","number":1,"original_values":{"number":1,"finish":1724155200000,"team_strength":1.0,"length":"default"},"new_values":{"number":1,"team_strength":0.9,"length":2,"finish":1724155205000}}],"primary_resources":[{"kind":"iteration_override","number":1}],"secondary_resources":[],"project":{"kind":"project","id":99,"name":"Death Star"},"performed_by":{"kind":"person","id":102,"name":"Wilhuff Tarkin","initials":"WT"},"occurred_at":"2024-08-20T12:00:10Z"}]

PARAMETERS

project_id

int in the request path.
required — The ID of the project.

sort_order

enumerated string in the request query.
— The order to return the activity. Defaults to descending.

Valid enumeration values: asc, desc

limit

int[pos] in the request query.
— The number of activity items you want returned.

offset

int[pos] in the request query.
— Index of the first activity item you want, starting from zero.

occurred_before

datetime in the request query.
— Activity will be returned only for operations that occurred before the time specified by this parameter.

occurred_after

datetime in the request query.
— Activity will be returned only for operations that occurred after the time specified by this parameter.

since_version

int in the request query.
— Activity will be returned only for operations that occurred after the specified version.

ENDPOINT

/projects/{project_id}/stories/{story_id}/activity

GET Return list of the selected story's activity. (Paginated)

Provides a list of all the activity performed on the story. (Limited to the most recent six months of activity performed in projects that are in accounts on any non-Enterprise subscription plan, and to at least the last 25 months of activity for projects in an account on an Enterprise subscription plan.)


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
export STORY_ID=556
curl -X GET -H "X-TrackerToken: $TOKEN" "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/stories/$STORY_ID/activity"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Pagination-Limit: 100
        X-Tracker-Pagination-Offset: 0
        X-Tracker-Pagination-Total: 4
        X-Tracker-Pagination-Returned: 4
        X-Tracker-Project-Version: 66
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           [{"kind":"story_update_activity","guid":"99_48","project_version":48,"message":"Darth Vader started this feature","highlight":"started","changes":[{"kind":"label","change_type":"update","id":2008,"original_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":4,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":2,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":2,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":1,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"new_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":4,"started":2,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":2,"started":1,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"name":"rebel bases"},{"kind":"label","change_type":"update","id":2009,"original_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":3,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":5,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":1,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":2,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"new_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":3,"started":2,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":3,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":1,"started":1,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":1,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"name":"plans"},{"kind":"story","change_type":"update","id":556,"original_values":{"current_state":"unscheduled","before_id":555,"after_id":557},"new_values":{"current_state":"started","before_id":567,"after_id":560},"name":"Interrogate Leia Organa","story_type":"feature","story_priority":"p3"}],"primary_resources":[{"kind":"story","id":556,"name":"Interrogate Leia Organa","story_type":"feature","url":"http://localhost/story/show/556","story_priority":"p3"}],"secondary_resources":[],"project":{"kind":"project","id":99,"name":"Death Star"},"performed_by":{"kind":"person","id":101,"name":"Darth Vader","initials":"DV"},"occurred_at":"2024-08-20T12:00:00Z"},{"kind":"story_update_activity","guid":"99_43","project_version":43,"message":"Darth Vader edited this feature","highlight":"edited","changes":[{"kind":"label","change_type":"update","id":2008,"original_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":3,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":1,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":1,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":1,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"new_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":3,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":3,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":1,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":2,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"name":"rebel bases"},{"kind":"label","change_type":"update","id":2009,"original_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":3,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":3,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":1,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":1,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"new_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":3,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":5,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":1,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":2,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"name":"plans"},{"kind":"label","change_type":"update","id":2015,"original_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":3,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":2,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"new_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":1,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":1,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"name":"diplomatic relations"},{"kind":"story","change_type":"update","id":556,"original_values":{"label_ids":[2015],"labels":["diplomatic relations"]},"new_values":{"label_ids":[2009,2008],"labels":["plans","rebel bases"]},"name":"Interrogate Leia Organa","story_type":"feature","story_priority":"p3"}],"primary_resources":[{"kind":"story","id":556,"name":"Interrogate Leia Organa","story_type":"feature","url":"http://localhost/story/show/556","story_priority":"p3"}],"secondary_resources":[],"project":{"kind":"project","id":99,"name":"Death Star"},"performed_by":{"kind":"person","id":101,"name":"Darth Vader","initials":"DV"},"occurred_at":"2024-08-20T12:00:00Z"},{"kind":"story_update_activity","guid":"99_26","project_version":26,"message":"Emperor Palpatine estimated this feature as 2 points","highlight":"estimated","changes":[{"kind":"label","change_type":"update","id":2015,"original_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":2,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":2,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"new_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":1,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":2,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":2,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"name":"diplomatic relations"},{"kind":"story","change_type":"update","id":556,"original_values":{"estimate":null},"new_values":{"estimate":2},"name":"Interrogate Leia Organa","story_type":"feature","story_priority":"p3"}],"primary_resources":[{"kind":"story","id":556,"name":"Interrogate Leia Organa","story_type":"feature","url":"http://localhost/story/show/556","story_priority":"p3"}],"secondary_resources":[],"project":{"kind":"project","id":99,"name":"Death Star"},"performed_by":{"kind":"person","id":100,"name":"Emperor Palpatine","initials":"EP"},"occurred_at":"2024-08-20T12:00:00Z"},{"kind":"story_create_activity","guid":"99_9","project_version":9,"message":"Darth Vader added this feature","highlight":"added","changes":[{"kind":"story","change_type":"create","id":556,"new_values":{"id":556,"project_id":99,"name":"Interrogate Leia Organa","description":"She is proving to be resistant to our mind probes","story_type":"feature","current_state":"unscheduled","requested_by_id":101,"owned_by_id":101,"owner_ids":[101,105],"label_ids":[2015],"follower_ids":[],"created_at":"2024-08-20T12:00:00Z","updated_at":"2024-08-20T12:00:00Z","before_id":555,"after_id":553,"blocked_story_ids":[],"story_priority":"p3","labels":["diplomatic relations"]},"name":"Interrogate Leia Organa","story_type":"feature","story_priority":"p3"},{"kind":"label","change_type":"update","id":2015,"original_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":1,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":1,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"new_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":2,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":2,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"name":"diplomatic relations"}],"primary_resources":[{"kind":"story","id":556,"name":"Interrogate Leia Organa","story_type":"feature","url":"http://localhost/story/show/556","story_priority":"p3"}],"secondary_resources":[],"project":{"kind":"project","id":99,"name":"Death Star"},"performed_by":{"kind":"person","id":101,"name":"Darth Vader","initials":"DV"},"occurred_at":"2024-08-20T12:00:00Z"}]


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
export STORY_ID=556
curl -X GET -H "X-TrackerToken: $TOKEN" "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/stories/$STORY_ID/activity?limit=2&offset=1"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Pagination-Limit: 2
        X-Tracker-Pagination-Offset: 1
        X-Tracker-Pagination-Total: 4
        X-Tracker-Pagination-Returned: 2
        X-Tracker-Project-Version: 66
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           [{"kind":"story_update_activity","guid":"99_43","project_version":43,"message":"Darth Vader edited this feature","highlight":"edited","changes":[{"kind":"label","change_type":"update","id":2008,"original_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":3,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":1,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":1,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":1,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"new_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":3,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":3,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":1,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":2,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"name":"rebel bases"},{"kind":"label","change_type":"update","id":2009,"original_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":3,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":3,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":1,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":1,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"new_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":3,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":5,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":1,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":2,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"name":"plans"},{"kind":"label","change_type":"update","id":2015,"original_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":3,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":2,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"new_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":1,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":1,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"name":"diplomatic relations"},{"kind":"story","change_type":"update","id":556,"original_values":{"label_ids":[2015],"labels":["diplomatic relations"]},"new_values":{"label_ids":[2009,2008],"labels":["plans","rebel bases"]},"name":"Interrogate Leia Organa","story_type":"feature","story_priority":"p3"}],"primary_resources":[{"kind":"story","id":556,"name":"Interrogate Leia Organa","story_type":"feature","url":"http://localhost/story/show/556","story_priority":"p3"}],"secondary_resources":[],"project":{"kind":"project","id":99,"name":"Death Star"},"performed_by":{"kind":"person","id":101,"name":"Darth Vader","initials":"DV"},"occurred_at":"2024-08-20T12:00:00Z"},{"kind":"story_update_activity","guid":"99_26","project_version":26,"message":"Emperor Palpatine estimated this feature as 2 points","highlight":"estimated","changes":[{"kind":"label","change_type":"update","id":2015,"original_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":2,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":2,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"new_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":1,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":2,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":2,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"name":"diplomatic relations"},{"kind":"story","change_type":"update","id":556,"original_values":{"estimate":null},"new_values":{"estimate":2},"name":"Interrogate Leia Organa","story_type":"feature","story_priority":"p3"}],"primary_resources":[{"kind":"story","id":556,"name":"Interrogate Leia Organa","story_type":"feature","url":"http://localhost/story/show/556","story_priority":"p3"}],"secondary_resources":[],"project":{"kind":"project","id":99,"name":"Death Star"},"performed_by":{"kind":"person","id":100,"name":"Emperor Palpatine","initials":"EP"},"occurred_at":"2024-08-20T12:00:00Z"}]

PARAMETERS

project_id

int in the request path.
required — The ID of the project.

story_id

int in the request path.
required — The ID of the story.

sort_order

enumerated string in the request query.
— The order to return the activity. Defaults to descending.

Valid enumeration values: asc, desc

limit

int[pos] in the request query.
— The number of activity items you want returned.

offset

int[pos] in the request query.
— Index of the first activity item you want, starting from zero.

occurred_before

datetime in the request query.
— Activity will be returned only for operations that occurred before the time specified by this parameter.

occurred_after

datetime in the request query.
— Activity will be returned only for operations that occurred after the time specified by this parameter.

since_version

int in the request query.
— Activity will be returned only for operations that occurred after the specified version.

ENDPOINT

/projects/{project_id}/epics/{epic_id}/activity

GET Return list of the selected epic's activity. (Paginated)

Provides a list of all the activity performed on the epic. (Limited to the most recent six months of activity performed in projects that are in accounts on any non-Enterprise subscription plan, and to at least the last 25 months of activity for projects in an account on an Enterprise subscription plan.)


export PROJECT_ID=99
export EPIC_ID=5
curl -X GET "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/epics/$EPIC_ID/activity"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Pagination-Limit: 100
        X-Tracker-Pagination-Offset: 0
        X-Tracker-Pagination-Total: 2
        X-Tracker-Pagination-Returned: 2
        X-Tracker-Project-Version: 66
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           [{"kind":"comment_create_activity","guid":"99_60","project_version":60,"message":"Moradmin Bast added comment: \"Should we send a probe to Dantooine?\"","highlight":"added comment:","changes":[{"kind":"comment","change_type":"create","id":110,"new_values":{"id":110,"epic_id":5,"text":"Should we send a probe to Dantooine?","person_id":103,"created_at":"2024-08-20T12:00:00Z","updated_at":"2024-08-20T12:00:00Z","file_attachment_ids":[],"google_attachment_ids":[],"attachment_ids":[],"file_attachments":[],"google_attachments":[]}},{"kind":"epic","change_type":"update","id":5,"original_values":{"follower_ids":[]},"new_values":{"follower_ids":[103]},"name":"Rebel Home Worlds"}],"primary_resources":[{"kind":"epic","id":5,"name":"Rebel Home Worlds","url":"http://localhost/epic/show/5"}],"secondary_resources":[],"project":{"kind":"project","id":99,"name":"Death Star"},"performed_by":{"kind":"person","id":103,"name":"Moradmin Bast","initials":"MB"},"occurred_at":"2024-08-20T12:00:00Z"},{"kind":"epic_create_activity","guid":"99_21","project_version":21,"message":"Wilhuff Tarkin added this epic","highlight":"added","changes":[{"kind":"epic","change_type":"create","id":5,"new_values":{"id":5,"project_id":99,"name":"Rebel Home Worlds","label_id":2008,"description":"Identify the systems and eliminate the rebel scum.","follower_ids":[],"created_at":"2024-08-20T12:00:00Z","updated_at":"2024-08-20T12:00:00Z","past_done_story_estimates":3,"past_done_stories_count":1,"past_done_stories_no_point_count":0,"label":"rebel bases"},"name":"Rebel Home Worlds"}],"primary_resources":[{"kind":"epic","id":5,"name":"Rebel Home Worlds","url":"http://localhost/epic/show/5"}],"secondary_resources":[],"project":{"kind":"project","id":99,"name":"Death Star"},"performed_by":{"kind":"person","id":102,"name":"Wilhuff Tarkin","initials":"WT"},"occurred_at":"2024-08-20T12:00:00Z"}]


export PROJECT_ID=99
export EPIC_ID=5
curl -X GET "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/epics/$EPIC_ID/activity?limit=42&offset=1"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Pagination-Limit: 42
        X-Tracker-Pagination-Offset: 1
        X-Tracker-Pagination-Total: 2
        X-Tracker-Pagination-Returned: 1
        X-Tracker-Project-Version: 66
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           [{"kind":"epic_create_activity","guid":"99_21","project_version":21,"message":"Wilhuff Tarkin added this epic","highlight":"added","changes":[{"kind":"epic","change_type":"create","id":5,"new_values":{"id":5,"project_id":99,"name":"Rebel Home Worlds","label_id":2008,"description":"Identify the systems and eliminate the rebel scum.","follower_ids":[],"created_at":"2024-08-20T12:00:00Z","updated_at":"2024-08-20T12:00:00Z","past_done_story_estimates":3,"past_done_stories_count":1,"past_done_stories_no_point_count":0,"label":"rebel bases"},"name":"Rebel Home Worlds"}],"primary_resources":[{"kind":"epic","id":5,"name":"Rebel Home Worlds","url":"http://localhost/epic/show/5"}],"secondary_resources":[],"project":{"kind":"project","id":99,"name":"Death Star"},"performed_by":{"kind":"person","id":102,"name":"Wilhuff Tarkin","initials":"WT"},"occurred_at":"2024-08-20T12:00:00Z"}]


export PROJECT_ID=99
export EPIC_ID=5
curl -X GET "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/epics/$EPIC_ID/activity?since_version=55"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Pagination-Limit: 100
        X-Tracker-Pagination-Offset: 0
        X-Tracker-Pagination-Total: 1
        X-Tracker-Pagination-Returned: 1
        X-Tracker-Project-Version: 66
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           [{"kind":"comment_create_activity","guid":"99_60","project_version":60,"message":"Moradmin Bast added comment: \"Should we send a probe to Dantooine?\"","highlight":"added comment:","changes":[{"kind":"comment","change_type":"create","id":110,"new_values":{"id":110,"epic_id":5,"text":"Should we send a probe to Dantooine?","person_id":103,"created_at":"2024-08-20T12:00:00Z","updated_at":"2024-08-20T12:00:00Z","file_attachment_ids":[],"google_attachment_ids":[],"attachment_ids":[],"file_attachments":[],"google_attachments":[]}},{"kind":"epic","change_type":"update","id":5,"original_values":{"follower_ids":[]},"new_values":{"follower_ids":[103]},"name":"Rebel Home Worlds"}],"primary_resources":[{"kind":"epic","id":5,"name":"Rebel Home Worlds","url":"http://localhost/epic/show/5"}],"secondary_resources":[],"project":{"kind":"project","id":99,"name":"Death Star"},"performed_by":{"kind":"person","id":103,"name":"Moradmin Bast","initials":"MB"},"occurred_at":"2024-08-20T12:00:00Z"}]

PARAMETERS

project_id

int in the request path.
required — The ID of the project.

epic_id

int in the request path.
required — The ID of the epic.

sort_order

enumerated string in the request query.
— The order to return the activity. Defaults to descending.

Valid enumeration values: asc, desc

limit

int[pos] in the request query.
— The number of activity items you want returned.

offset

int[pos] in the request query.
— Index of the first activity item you want, starting from zero.

occurred_before

datetime in the request query.
— Activity will be returned only for operations that occurred before the time specified by this parameter.

occurred_after

datetime in the request query.
— Activity will be returned only for operations that occurred after the time specified by this parameter.

since_version

int in the request query.
— Activity will be returned only for operations that occurred after the specified version.

Source Commits

ENDPOINT

/source_commits

POST Creates a comment associated with a commit in a Source Control system.

Provides integration with commits in a Source Control system.

The Tracker API supports integration with post-commit hooks of Source Control Management (SCM) systems such as Subversion, Git, etc. When a commit is made to the SCM, a trigger can call the Tracker API to add a story comment with the commit ID, author and message. It can also optionally change story state.

To associate an SCM commit with a specific Tracker story, you must include a special syntax in the commit message to indicate one or more story IDs and (optionally) a state change for the story. Your commit message should have square brackets containing a hash mark followed by the story ID. If a story was not already started (it was in the "not started" state), a commit message will automatically start it.

To automatically finish a story by using a commit message, include "fixed", "completed" or "finished" in the square brackets in addition to the story ID. You may also use different cases or forms of these verbs, such as "Fix" or "FIXES", and they may appear before or after the story ID. Note: For features, this will put the story in the 'finished' state. For chores, it will put the story in the 'accepted' state.

In some environments, code that is committed is automatically deployed. For this situation, include "delivers" and feature stories will be put in the 'delivered' state.


export TOKEN='your Pivotal Tracker API token'
curl -X POST -H "X-TrackerToken: $TOKEN" -H "Content-Type: application/json" -d '{"source_commit":{"commit_id":"abc123","message":"[#555] some commit","url":"http://example.com/abc123","author":"Darth Vader","repo":"reponame"}}' "https://www.pivotaltracker.com/services/v5/source_commits"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           [{"kind":"story","id":555,"project_id":99,"name":"Bring me the passengers","description":"ignore the droids","story_type":"feature","current_state":"started","estimate":2,"requested_by_id":101,"owner_ids":[],"labels":[],"created_at":"2024-08-20T12:00:00Z","updated_at":"2024-08-20T12:00:05Z","url":"http://localhost/story/show/555","story_priority":"p3"}]

Successful responses to this request return an array containing zero or more instances of the story resource.

PARAMETERS

source_commit

source_commit in the request body.
— The source commit object

Exports

ENDPOINT

/projects/{project_id}/export

POST POSTing to an individual project resource's URL is used to send story-selection parameters. The server responds with a CSV export file containing data from the selected stories.

Export the specified project to CSV


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
curl -X POST -H "X-TrackerToken: $TOKEN" -H "Content-Type: application/json" -d '{"story_ids":[551]}' "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/export"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        Cache-Control: private
        Content-Disposition: attachment; filename="death_star_20240821_120000.csv"
        Content-Type: text/csv
    

       Response Body
         
           Id,Title,Labels,Iteration,Iteration Start,Iteration End,Type,Estimate,Priority,Current State,Created at,Accepted at,Deadline,Requested By,Description,URL,Sounder Flats Computer Complex ID,Integration,Owned By,Owned By
551,Hire bounty hunters to bring in Solo,"diplomatic relations, personnel",,,,feature,1,p3 - Low,unscheduled,"Aug 20, 2024",,,Emperor Palpatine,No disintegrations,http://localhost/story/show/551,,,Darth Vader,Clone TK421

PARAMETERS

project_id

int in the request path.
required — The ID of the project.

story_ids

List[int] in the request body.
required — A list of stories to fetch

Note that the response content type for this request is CSV and not JSON.

ENDPOINT

/stories/export

POST POSTing is used to send story-selection parameters. The server responds with a CSV export file containing data from the selected stories.

Export the specified stories (from any number of projects) to CSV

PARAMETERS

ids

List[int] in the request body.
required — A list of stories to fetch

Note that the response content type for this request is CSV and not JSON.

Project Integrations

ENDPOINT

/projects/{project_id}/integrations

GET Returns a project's integrations.
POST Create a new integration for a project.

Operations on a project's integrations.

NOTE: Few account level & project level integrations such as GitHub, GitHub Enterprise, Gitlab, Gitlab Self-Managed and Concourse Pipeline currently can only be managed via the Generic_Integrations endpoint. Please refer the above endpoint for more details.


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
curl -X GET -H "X-TrackerToken: $TOKEN" "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/integrations"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 66
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           [{"id":30,"kind":"other_integration","project_id":99,"can_import":true,"base_url":"http://localhost:3000","is_other":true,"story_name":"item","name":"Sounder Flats Computer Complex","active":true,"import_api_url":"http://localhost:3000/starwars.xml","created_at":"2024-08-20T12:00:00Z","updated_at":"2024-08-20T12:00:00Z"}]

Successful responses to this request return an array containing zero or more instances of an integration-type resource. In particular, any mix of any of the following: bugzilla_integration, get_satisfaction_integration, jira_integration, lighthouse_integration, other_integration, zendesk_integration.

PARAMETERS

project_id

int in the request path.
required — The ID of the project.


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
curl -X POST -H "X-TrackerToken: $TOKEN" -H "Content-Type: application/json" -d '{"active":false,"base_url":"http://some.th/ing","name":"something","type":"other"}' "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/integrations"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 66
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"active":false,"base_url":"http://some.th/ing","can_import":false,"created_at":"2024-08-20T12:00:00Z","id":200,"is_other":true,"kind":"other_integration","name":"something","project_id":99,"story_name":"item","updated_at":"2024-08-20T12:00:00Z"}

Successful responses to this request return an integration-type resource. In particular, any one of the following: bugzilla_integration, get_satisfaction_integration, jira_integration, lighthouse_integration, other_integration, zendesk_integration.

PARAMETERS

project_id

int in the request path.
required — The ID of the project.

type

enumerated string in the request body.
required — The name of the type of external integration that this resource represents. NOTE - Few account level & project level integrations such as GitHub, GitHub Enterprise, Gitlab, Gitlab Self-Managed and Concourse Pipeline currently can only be managed via the can be managed via Generic Integrations endpoint.

Valid enumeration values: bugzilla, get_satisfaction, jira, lighthouse, other, zendesk

api_username

string in the request body.
— The username to use to access the external API.

api_password

string in the request body.
— The password to use to access the external API.

zendesk_user_email

string in the request body.
— The email of the Zendesk user which you want to use for integration purposes.

zendesk_user_password

string in the request body.
— The password of the Zendesk user which you want to use for integration purposes.

view_id

string in the request body.
— Only show tickets from the specified Zendesk view.

company

string in the request body.
— Can be found in the URL in your company's community on Satisfaction. For example - http://www.getsatisfaction.com/yourcompany.

product

string in the request body.
— The name of your Bugzilla Product. Use this in conjunction with the component to narrow the bugs to be imported.

component

string in the request body.
— The name of your Bugzilla Component. Use this in conjunction with product to narrow the bugs to be imported.

statuses_to_exclude

string in the request body.
— A comma separated list of status names that should be excluded from the imported bugs. If left blank, all bugs will be imported.

filter_id

string in the request body.
— The ID of the saved JIRA filter to use to load stories.

account

string in the request body.
— Your Lighthouse account name, and can be found in the first part of your Lighthouse URL, for example http://yourcompany.lighthouseapp.com.

external_api_token

string in the request body.
— Your Lighthouse API token.

bin_id

int in the request body.
— Only import tickets from the specified ticket bin.

external_project_id

int in the request body.
— The unique ID of your Lighthouse project, which can be found in a project URL, for example http://yourcompany.lighthouseapp.com/projects/1234-project-name/overview.

import_api_url

string in the request body.
— The URL to import stories from.

basic_auth_username

string in the request body.
— The username to use when importing stories.

basic_auth_password

string in the request body.
— The password to use when importing stories.

comments_private

boolean in the request body.
— If enabled, comments made by Tracker on the external bug will be marked as private.

update_comments

boolean in the request body.
— If enabled, comments created in Tracker will be added to the linked ticket or bug.

update_state

boolean in the request body.
— Adds a state change comment to the linked ticket or bug.

base_url

string in the request body.
— url used for outgoing web links in stories imported via this integration.

name

string[40] in the request body.
— The name given to the particular external integration in the Project Settings pages.

active

boolean in the request body.
— True if the integration is currently enabled for use.

ENDPOINT

/projects/{project_id}/integrations/{integration_id}

GET Returns a project integration.
PUT Updates a project integration.
DELETE Deletes a project integration.

Operations on a single project integration.


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
curl -X GET -H "X-TrackerToken: $TOKEN" "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/integrations/30"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 66
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"active":true,"base_url":"http://localhost:3000","can_import":true,"created_at":"2024-08-20T12:00:00Z","id":30,"import_api_url":"http://localhost:3000/starwars.xml","is_other":true,"kind":"other_integration","name":"Sounder Flats Computer Complex","project_id":99,"story_name":"item","updated_at":"2024-08-20T12:00:00Z"}

PARAMETERS

project_id

int in the request path.
required — The ID of the project.

integration_id

int in the request path.
required — The ID of the integration.


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
curl -X PUT -H "X-TrackerToken: $TOKEN" -H "Content-Type: application/json" -d '{"base_url":"http://some.th/ing","name":"something"}' "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/integrations/30"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 66
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"active":true,"base_url":"http://some.th/ing","can_import":true,"created_at":"2024-08-20T12:00:00Z","id":30,"import_api_url":"http://localhost:3000/starwars.xml","is_other":true,"kind":"other_integration","name":"something","project_id":99,"story_name":"item","updated_at":"2024-08-20T12:00:05Z"}

PARAMETERS

project_id

int in the request path.
required — The ID of the project.

integration_id

int in the request path.
required — The ID of the integration.

api_username

string in the request body.
— The username to use to access the external API.

api_password

string in the request body.
— The password to use to access the external API.

zendesk_user_email

string in the request body.
— The email of the Zendesk user which you want to use for integration purposes.

zendesk_user_password

string in the request body.
— The password of the Zendesk user which you want to use for integration purposes.

view_id

string in the request body.
— Only show tickets from the specified Zendesk view.

company

string in the request body.
— Can be found in the URL in your company's community on Satisfaction. For example - http://www.getsatisfaction.com/yourcompany.

product

string in the request body.
— The name of your Bugzilla Product. Use this in conjunction with the component to narrow the bugs to be imported.

component

string in the request body.
— The name of your Bugzilla Component. Use this in conjunction with product to narrow the bugs to be imported.

statuses_to_exclude

string in the request body.
— A comma separated list of status names that should be excluded from the imported bugs. If left blank, all bugs will be imported.

filter_id

string in the request body.
— The ID of the saved JIRA filter to use to load stories.

account

string in the request body.
— Your Lighthouse account name, and can be found in the first part of your Lighthouse URL, for example http://yourcompany.lighthouseapp.com.

external_api_token

string in the request body.
— Your Lighthouse API token.

bin_id

int in the request body.
— Only import tickets from the specified ticket bin.

external_project_id

int in the request body.
— The unique ID of your Lighthouse project, which can be found in a project URL, for example http://yourcompany.lighthouseapp.com/projects/1234-project-name/overview.

import_api_url

string in the request body.
— The URL to import stories from.

basic_auth_username

string in the request body.
— The username to use when importing stories.

basic_auth_password

string in the request body.
— The password to use when importing stories.

comments_private

boolean in the request body.
— If enabled, comments made by Tracker on the external bug will be marked as private.

update_comments

boolean in the request body.
— If enabled, comments created in Tracker will be added to the linked ticket or bug.

update_state

boolean in the request body.
— Adds a state change comment to the linked ticket or bug.

base_url

string in the request body.
— url used for outgoing web links in stories imported via this integration.

name

string[40] in the request body.
— The name given to the particular external integration in the Project Settings pages.

active

boolean in the request body.
— True if the integration is currently enabled for use.


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
curl -X DELETE -H "X-TrackerToken: $TOKEN" -H "Content-Type: application/json" "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/integrations/200"



  
    View Response
  

  
    Hide Response

    
      status: 204
    

    
      Headers
        X-Tracker-Project-Version: 67
        Content-Type: application/json; potentially-other-variable-stuff

PARAMETERS

project_id

int in the request path.
required — The ID of the project.

integration_id

int in the request path.
required — The ID of the integration.

ENDPOINT

/projects/{project_id}/integrations/{integration_id}/stories

GET Provides external_story records for all of the potential stories available through the selected integration (already configured on the selected project). The content of the objects returned is suitable for use as parameters to create stories 'imported from' the selected integration.

Fetch story information from the selected integration.


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
export INTEGRATION_ID=30
curl -X GET -H "X-TrackerToken: $TOKEN" "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/integrations/$INTEGRATION_ID/stories"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 66
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           [{"kind":"external_story","name":"Please let us go","integration_id":30,"external_id":"Bespin","estimate":0,"created_at":"2024-08-20T12:00:00Z","external_requester":"Lando Calrissian","external_owner":"Darth Vader","owned_by_id":101,"owner_ids":[101],"story_type":"feature"}]


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
export INTEGRATION_ID=30
curl -X GET -H "X-TrackerToken: $TOKEN" "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/integrations/$INTEGRATION_ID/stories?exclude_linked=true"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 66
        Content-Type: application/json; potentially-other-variable-stuff

Successful responses to this request return an array containing zero or more instances of the external_story resource.

PARAMETERS

project_id

int in the request path.
required — The ID of the project.

integration_id

int in the request path.
required — The ID of the integration.

exclude_linked

boolean in the request query.
— When this parameter is present and true, response will not include external stories which already have matching Pivotal Tracker stories.

Automatically filters out all information from the selected integration that corresponds to an existing story in the project.

Generic Integrations

ENDPOINT

/projects/{project_id}/generic_integrations

GET Returns a project's generic integrations like Github/Github Enterprise/Gitlab/Gitlab Self-Managed/Concourse
POST Create the generic integrations like Github/Github Enterprise/Gitlab/Gitlab Self-Managed/Concourse

Create and list generic integrations.


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
curl -X GET -H "X-TrackerToken: $TOKEN" "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/generic_integrations?integration_type=concourse_pipeline"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 66
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           [{"id":2,"name":"Production Integration: Death Star","project_id":99,"uuid":"concourse_uuid","environment":"production","git_resource_name":"deathstar_repo","created_at":"2024-08-20T12:00:00Z","updated_at":"2024-08-20T12:00:00Z","kind":"concourse_pipeline_generic_integration_object","job_url":"http://example.com/teams/1/pipelines/1/jobs/1","integration_type":"concourse_pipeline"}]

Successful responses to this request return a generic_integration_object-type resource. In particular, any one of the following: concourse_pipeline_generic_integration_object, github_enterprise_generic_integration_object, github_generic_integration_object, gitlab_generic_integration_object, gitlab_self_managed_generic_integration_object.

PARAMETERS

project_id

int in the request path.
required — The ID of the project.

integration_type

enumerated string in the request query.
required — The type of generic integration

Valid enumeration values: github, github_enterprise, gitlab, gitlab_self_managed, concourse_pipeline


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
curl -X POST -H "X-TrackerToken: $TOKEN" -H "Content-Type: application/json" -d '{"integration_type":"github","integration_values":{"title":"vader"}}' "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/generic_integrations"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 66
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"account_id":100,"created_at":"2024-08-20T12:00:00Z","id":101,"integration_type":"github","kind":"github_generic_integration_object","project_id":99,"secret_token":"39d75ba3eecc9d6f593c5d6624e2679b314cb252","title":"vader","updated_at":"2024-08-20T12:00:00Z","webhook_url":"https://www.pivotaltracker.com/services/v5/github_hooks/ab3256f1467024746b5bbc7b2e4da83e","webhook_uuid":"ab3256f1467024746b5bbc7b2e4da83e"}

PARAMETERS

project_id

int in the request path.
required — The ID of the project.

integration_type

enumerated string in the request body.
required — The type of generic integration

Valid enumeration values: github, github_enterprise, gitlab, gitlab_self_managed, concourse_pipeline

integration_values

object in the request body.
required — For Github: {'title': 'Github Integration'} For GithubEnterprise: {'host_url': 'enterprise.github.com', 'title': 'My Github enterprise Integration'} For Gitlab: {'title': 'Gitlab Integration'} For Gitlab Self-Managed: {'host_url': 'enterprise.gitlab.com', 'title': 'My Gitlab self managed Integration'} For Concourse: {'name': 'concourse integration', 'git_resource_name' : 'production', 'url': 'https://concourse-k8s.prod.com/teams/vader/pipelines/jobs'}

ENDPOINT

/projects/{project_id}/generic_integrations/{integration_id}

PUT Updates a generic integration.
DELETE Deletes a generic integration.

Operations on a single generic integration.


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
curl -X PUT -H "X-TrackerToken: $TOKEN" -H "Content-Type: application/json" -d '{"integration_type":"github_enterprise","integration_values":{"title":"updated integration name","host_url":"https://enterprise_host_url.com/pivotaltracker/tracker"}}' "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/generic_integrations/1"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 66
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"account_id":100,"created_at":"2024-08-20T12:00:00Z","host_url":"https://enterprise_host_url.com/pivotaltracker/tracker","id":1,"integration_type":"github_enterprise","kind":"github_enterprise_generic_integration_object","project_id":99,"secret_token":"7f951be08c787b558479335a7d6db4fff95fd982","title":"updated integration name","updated_at":"2024-08-20T12:00:05Z","webhook_url":"https://www.pivotaltracker.com/services/v5/github_hooks/8b83aa66d1e1cab8b38f031db400b8a6","webhook_uuid":"8b83aa66d1e1cab8b38f031db400b8a6"}

PARAMETERS

project_id

int in the request path.
required — The ID of the project.

integration_id

int in the request path.
required — The ID of the integration.

integration_type

enumerated string in the request body.
required — The type of generic integration

Valid enumeration values: github, github_enterprise, gitlab, gitlab_self_managed, concourse_pipeline

integration_values


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
curl -X DELETE -H "X-TrackerToken: $TOKEN" -H "Content-Type: application/json" "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/generic_integrations/2?integration_type=concourse_pipeline"



  
    View Response
  

  
    Hide Response

    
      status: 204
    

    
      Headers
        X-Tracker-Project-Version: 66
        Content-Type: application/json; potentially-other-variable-stuff

PARAMETERS

project_id

int in the request path.
required — The ID of the project.

integration_id

int in the request path.
required — The ID of the integration.

integration_type

enumerated string in the request query.
required — The type of generic integration

Valid enumeration values: github, github_enterprise, gitlab, gitlab_self_managed, concourse_pipeline

Project Webhooks

ENDPOINT

/projects/{project_id}/webhooks

GET Return the project's webhooks.
POST Creates a webhook on the project.

Lets the user access the project's list of webhooks.


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
curl -X GET -H "X-TrackerToken: $TOKEN" "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/webhooks"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 66
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           [{"kind":"webhook","id":27,"project_id":99,"webhook_url":"http://example.com:3000/test_postbin","created_at":"2024-08-20T12:00:00Z","updated_at":"2024-08-20T12:00:00Z","enabled":true,"last_error_code":400,"last_response_body":"Bad request"}]

Successful responses to this request return an array containing zero or more instances of the webhook resource.

PARAMETERS

project_id

int in the request path.
required — The ID of the project.


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
curl -X POST -H "X-TrackerToken: $TOKEN" -H "Content-Type: application/json" -d '{"enabled":true,"webhook_url":"http://pastebin.com/fred"}' "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/webhooks"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 66
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"created_at":"2024-08-20T12:00:00Z","enabled":true,"id":100,"kind":"webhook","project_id":99,"updated_at":"2024-08-20T12:00:00Z","webhook_url":"http://pastebin.com/fred"}

Successful responses to this request return the webhook resource.

PARAMETERS

project_id

int in the request path.
required — The ID of the project.

webhook_url

string in the request body.
required — The location of the application listening for Tracker events.

enabled

boolean in the request body.
— Allows user to enable/disable webhook.

last_error_code

int in the request body.
— Most recent error code received.

last_response_body

extended string[10000] in the request body.
— Most recent response body received.

ENDPOINT

/projects/{project_id}/webhooks/{webhook_id}

GET Return the specified project webhook.
PUT Update the specified project webhook.
DELETE Delete the specified project webhook.

Lets the user access a single project webhook


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
curl -X GET -H "X-TrackerToken: $TOKEN" "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/webhooks/27"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 66
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"created_at":"2024-08-20T12:00:00Z","enabled":true,"id":27,"kind":"webhook","last_error_code":400,"last_response_body":"Bad request","project_id":99,"updated_at":"2024-08-20T12:00:00Z","webhook_url":"http://example.com:3000/test_postbin"}

Successful responses to this request return the webhook resource.

PARAMETERS

project_id

int in the request path.
required — The ID of the project.

webhook_id

int in the request path.
required — The ID of the webhook.


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
curl -X PUT -H "X-TrackerToken: $TOKEN" -H "Content-Type: application/json" -d '{"webhook_url":"http://pastebin.com/wilma"}' "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/webhooks/27"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 66
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"created_at":"2024-08-20T12:00:00Z","enabled":true,"id":27,"kind":"webhook","last_error_code":400,"last_response_body":"Bad request","project_id":99,"updated_at":"2024-08-20T12:00:05Z","webhook_url":"http://pastebin.com/wilma"}

Successful responses to this request return the webhook resource.

PARAMETERS

project_id

int in the request path.
required — The ID of the project.

webhook_id

int in the request path.
required — The ID of the webhook.

webhook_url

string in the request body.
— The location of the application listening for Tracker events.

enabled

boolean in the request body.
— Allows user to enable/disable webhook.

last_error_code

int in the request body.
— Most recent error code received.

last_response_body

extended string[10000] in the request body.
— Most recent response body received.


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
curl -X DELETE -H "X-TrackerToken: $TOKEN" -H "Content-Type: application/json" "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/webhooks/27"



  
    View Response
  

  
    Hide Response

    
      status: 204
    

    
      Headers
        X-Tracker-Project-Version: 66
        Content-Type: application/json; potentially-other-variable-stuff

PARAMETERS

project_id

int in the request path.
required — The ID of the project.

webhook_id

int in the request path.
required — The ID of the webhook.

Workspaces

ENDPOINT

/my/workspaces

GET Return list of workspaces for the authenticated person.
POST Create a new workspace for the authenticated person.

Provides a list of all of the workspaces owned by you.


export TOKEN='your Pivotal Tracker API token'
curl -X GET -H "X-TrackerToken: $TOKEN" "https://www.pivotaltracker.com/services/v5/my/workspaces"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           [{"kind":"workspace","id":46,"name":"executor","person_id":101,"project_ids":[99]}]

Successful responses to this request return an array containing zero or more instances of the workspace resource.


export TOKEN='your Pivotal Tracker API token'
curl -X POST -H "X-TrackerToken: $TOKEN" -H "Content-Type: application/json" -d '{"name":"A new workspace","project_ids":[99,98]}' "https://www.pivotaltracker.com/services/v5/my/workspaces"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"id":100,"kind":"workspace","name":"A new workspace","person_id":101,"project_ids":[99,98]}

Successful responses to this request return the workspace resource.

PARAMETERS

name

extended string[25] in the request body.
— The name of the workspace.

project_ids

List[int] in the request body.
— Array of projects contained in the workspace.

ENDPOINT

/my/workspaces/{workspace_id}

GET Return a workspace for the authenticated person.
PUT Return the specified workspace.
DELETE permanently delete the workspace

Updates the specified workspace owned by you.


export TOKEN='your Pivotal Tracker API token'
curl -X GET -H "X-TrackerToken: $TOKEN" "https://www.pivotaltracker.com/services/v5/my/workspaces/46"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"id":46,"kind":"workspace","name":"executor","person_id":101,"project_ids":[99]}

Successful responses to this request return the workspace resource.

PARAMETERS

workspace_id

int in the request path.
required — The ID of the workspace.


export TOKEN='your Pivotal Tracker API token'
curl -X PUT -H "X-TrackerToken: $TOKEN" -H "Content-Type: application/json" -d '{"project_ids":[99,98]}' "https://www.pivotaltracker.com/services/v5/my/workspaces/46"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"id":46,"kind":"workspace","name":"executor","person_id":101,"project_ids":[99,98]}

Successful responses to this request return the workspace resource.

PARAMETERS

workspace_id

int in the request path.
required — The ID of the workspace.

project_ids

List[int] in the request query.
— The list of projects to associate with this workspace.


export TOKEN='your Pivotal Tracker API token'
curl -X DELETE -H "X-TrackerToken: $TOKEN" -H "Content-Type: application/json" "https://www.pivotaltracker.com/services/v5/my/workspaces/46"



  
    View Response
  

  
    Hide Response

    
      status: 204
    

    
      Headers
        Content-Type: application/json; potentially-other-variable-stuff

PARAMETERS

workspace_id

int in the request path.
required — The ID of the workspace.

ENDPOINT

/workspaces/{workspace_id}/activity

GET Return list of the selected activity for the workspace. (Paginated)

Provides a list of all the activity in a workspace. Limited to the most recent six months of activity performed in the project(s) within the workspace.


export TOKEN='your Pivotal Tracker API token'
export WORKSPACE_ID=46
curl -X GET -H "X-TrackerToken: $TOKEN" "https://www.pivotaltracker.com/services/v5/workspaces/$WORKSPACE_ID/activity"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Pagination-Limit: 100
        X-Tracker-Pagination-Offset: 0
        X-Tracker-Pagination-Total: 65
        X-Tracker-Pagination-Returned: 65
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           [{"kind":"iteration_update_activity","guid":"99_66","project_version":66,"message":"Wilhuff Tarkin changed iteration 1's length from default to 2 weeks","highlight":"changed","changes":[{"kind":"iteration_override","change_type":"update","number":1,"original_values":{"number":1,"finish":1724155200000,"team_strength":1.0,"length":"default"},"new_values":{"number":1,"team_strength":0.9,"length":2,"finish":1724155210000}}],"primary_resources":[{"kind":"iteration_override","number":1}],"secondary_resources":[],"project":{"kind":"project","id":99,"name":"Death Star"},"performed_by":{"kind":"person","id":102,"name":"Wilhuff Tarkin","initials":"WT"},"occurred_at":"2024-08-20T12:00:25Z"},{"kind":"story_move_activity","guid":"99_65","project_version":65,"message":"Darth Vader moved 2 stories","highlight":"moved","changes":[{"kind":"story","change_type":"update","id":562,"original_values":{"before_id":551},"new_values":{"before_id":557},"name":"Garbage smashers on the detention level have malfunctioned","story_type":"bug","story_priority":"p3"},{"kind":"story","change_type":"update","id":564,"original_values":{"after_id":557},"new_values":{"after_id":565},"name":"Evacuate, in our moment of triumph","story_type":"feature","story_priority":"p3"}],"primary_resources":[{"kind":"story","id":564,"name":"Evacuate, in our moment of triumph","story_type":"feature","url":"http://localhost/story/show/564","story_priority":"p3"},{"kind":"story","id":562,"name":"Garbage smashers on the detention level have malfunctioned","story_type":"bug","url":"http://localhost/story/show/562","story_priority":"p3"}],"secondary_resources":[],"project":{"kind":"project","id":99,"name":"Death Star"},"performed_by":{"kind":"person","id":101,"name":"Darth Vader","initials":"DV"},"occurred_at":"2024-08-20T12:00:25Z"},{"kind":"story_move_activity","guid":"99_64","project_version":64,"message":"Darth Vader moved 2 stories","highlight":"moved","changes":[{"kind":"story","change_type":"update","id":562,"original_values":{"before_id":557},"new_values":{"before_id":551},"name":"Garbage smashers on the detention level have malfunctioned","story_type":"bug","story_priority":"p3"},{"kind":"story","change_type":"update","id":564,"original_values":{"after_id":565},"new_values":{"after_id":557},"name":"Evacuate, in our moment of triumph","story_type":"feature","story_priority":"p3"}],"primary_resources":[{"kind":"story","id":564,"name":"Evacuate, in our moment of triumph","story_type":"feature","url":"http://localhost/story/show/564","story_priority":"p3"},{"kind":"story","id":562,"name":"Garbage smashers on the detention level have malfunctioned","story_type":"bug","url":"http://localhost/story/show/562","story_priority":"p3"}],"secondary_resources":[],"project":{"kind":"project","id":99,"name":"Death Star"},"performed_by":{"kind":"person","id":101,"name":"Darth Vader","initials":"DV"},"occurred_at":"2024-08-20T12:00:25Z"},{"kind":"comment_create_activity","guid":"99_63","project_version":63,"message":"Wilhuff Tarkin added comment: \"Audit security of oscillator sanitation components\"","highlight":"added comment:","changes":[{"kind":"comment","change_type":"create","id":113,"new_values":{"id":113,"epic_id":555,"text":"Audit security of oscillator sanitation components","person_id":102,"created_at":"2024-08-20T12:00:25Z","updated_at":"2024-08-20T12:00:25Z","file_attachment_ids":[],"google_attachment_ids":[],"attachment_ids":[],"file_attachments":[],"google_attachments":[]}},{"kind":"epic","change_type":"update","id":555,"original_values":{"follower_ids":[]},"new_values":{"follower_ids":[102]},"name":"Sanitation"}],"primary_resources":[{"kind":"epic","id":555,"name":"Sanitation","url":"http://localhost/epic/show/555"}],"secondary_resources":[],"project":{"kind":"project","id":99,"name":"Death Star"},"performed_by":{"kind":"person","id":102,"name":"Wilhuff Tarkin","initials":"WT"},"occurred_at":"2024-08-20T12:00:25Z"},{"kind":"comment_create_activity","guid":"99_62","project_version":62,"message":"Darth Vader added comment: \"I want them alive!\"","highlight":"added comment:","changes":[{"kind":"comment","change_type":"create","id":112,"new_values":{"id":112,"story_id":555,"text":"I want them alive!","person_id":101,"created_at":"2024-08-20T12:00:25Z","updated_at":"2024-08-20T12:00:25Z","file_attachment_ids":[],"google_attachment_ids":[],"attachment_ids":[],"file_attachments":[],"google_attachments":[]}},{"kind":"story","change_type":"update","id":555,"original_values":{"follower_ids":[]},"new_values":{"follower_ids":[101]},"name":"Bring me the passengers","story_type":"feature","story_priority":"p3"}],"primary_resources":[{"kind":"story","id":555,"name":"Bring me the passengers","story_type":"feature","url":"http://localhost/story/show/555","story_priority":"p3"}],"secondary_resources":[],"project":{"kind":"project","id":99,"name":"Death Star"},"performed_by":{"kind":"person","id":101,"name":"Darth Vader","initials":"DV"},"occurred_at":"2024-08-20T12:00:25Z"},{"kind":"comment_create_activity","guid":"99_61","project_version":61,"message":"Moradmin Bast added comment: \"Check out these Uffel mouse droids\"","highlight":"added comment:","changes":[{"kind":"comment","change_type":"create","id":111,"new_values":{"id":111,"epic_id":6,"text":"Check out these Uffel mouse droids","person_id":103,"created_at":"2024-08-20T12:00:25Z","updated_at":"2024-08-20T12:00:25Z","file_attachment_ids":[],"google_attachment_ids":[],"attachment_ids":[],"file_attachments":[],"google_attachments":[]}},{"kind":"epic","change_type":"update","id":6,"original_values":{"follower_ids":[]},"new_values":{"follower_ids":[103]},"name":"Death Star Plans"}],"primary_resources":[{"kind":"epic","id":6,"name":"Death Star Plans","url":"http://localhost/epic/show/6"}],"secondary_resources":[],"project":{"kind":"project","id":99,"name":"Death Star"},"performed_by":{"kind":"person","id":103,"name":"Moradmin Bast","initials":"MB"},"occurred_at":"2024-08-20T12:00:25Z"},{"kind":"comment_create_activity","guid":"99_60","project_version":60,"message":"Moradmin Bast added comment: \"Should we send a probe to Dantooine?\"","highlight":"added comment:","changes":[{"kind":"comment","change_type":"create","id":110,"new_values":{"id":110,"epic_id":5,"text":"Should we send a probe to Dantooine?","person_id":103,"created_at":"2024-08-20T12:00:25Z","updated_at":"2024-08-20T12:00:25Z","file_attachment_ids":[],"google_attachment_ids":[],"attachment_ids":[],"file_attachments":[],"google_attachments":[]}},{"kind":"epic","change_type":"update","id":5,"original_values":{"follower_ids":[]},"new_values":{"follower_ids":[103]},"name":"Rebel Home Worlds"}],"primary_resources":[{"kind":"epic","id":5,"name":"Rebel Home Worlds","url":"http://localhost/epic/show/5"}],"secondary_resources":[],"project":{"kind":"project","id":99,"name":"Death Star"},"performed_by":{"kind":"person","id":103,"name":"Moradmin Bast","initials":"MB"},"occurred_at":"2024-08-20T12:00:25Z"},{"kind":"comment_create_activity","guid":"99_59","project_version":59,"message":"Wilhuff Tarkin added comment: \"I think you overestimate their chances!\"","highlight":"added comment:","changes":[{"kind":"comment","change_type":"create","id":109,"new_values":{"id":109,"story_id":564,"text":"I think you overestimate their chances!","person_id":102,"created_at":"2024-08-20T12:00:25Z","updated_at":"2024-08-20T12:00:25Z","file_attachment_ids":[],"google_attachment_ids":[],"attachment_ids":[],"file_attachments":[],"google_attachments":[]}},{"kind":"story","change_type":"update","id":564,"original_values":{"follower_ids":[]},"new_values":{"follower_ids":[102]},"name":"Evacuate, in our moment of triumph","story_type":"feature","story_priority":"p3"}],"primary_resources":[{"kind":"story","id":564,"name":"Evacuate, in our moment of triumph","story_type":"feature","url":"http://localhost/story/show/564","story_priority":"p3"}],"secondary_resources":[],"project":{"kind":"project","id":99,"name":"Death Star"},"performed_by":{"kind":"person","id":102,"name":"Wilhuff Tarkin","initials":"WT"},"occurred_at":"2024-08-20T12:00:25Z"},{"kind":"task_create_activity","guid":"99_58","project_version":58,"message":"Wilhuff Tarkin added task: \"Port 90\"","highlight":"added task:","changes":[{"kind":"task","change_type":"create","id":6,"new_values":{"id":6,"story_id":559,"description":"Port 90","complete":false,"position":2,"created_at":"2024-08-20T12:00:25Z","updated_at":"2024-08-20T12:00:25Z"}}],"primary_resources":[{"kind":"story","id":559,"name":"All exhaust ports should be shielded","story_type":"feature","url":"http://localhost/story/show/559","story_priority":"p3"}],"secondary_resources":[],"project":{"kind":"project","id":99,"name":"Death Star"},"performed_by":{"kind":"person","id":102,"name":"Wilhuff Tarkin","initials":"WT"},"occurred_at":"2024-08-20T12:00:25Z"},{"kind":"task_create_activity","guid":"99_57","project_version":57,"message":"Wilhuff Tarkin added task: \"Port 0\"","highlight":"added task:","changes":[{"kind":"task","change_type":"create","id":5,"new_values":{"id":5,"story_id":559,"description":"Port 0","complete":false,"position":1,"created_at":"2024-08-20T12:00:25Z","updated_at":"2024-08-20T12:00:25Z"}},{"kind":"story","change_type":"update","id":559,"original_values":{"follower_ids":[]},"new_values":{"follower_ids":[102]},"name":"All exhaust ports should be shielded","story_type":"feature","story_priority":"p3"}],"primary_resources":[{"kind":"story","id":559,"name":"All exhaust ports should be shielded","story_type":"feature","url":"http://localhost/story/show/559","story_priority":"p3"}],"secondary_resources":[],"project":{"kind":"project","id":99,"name":"Death Star"},"performed_by":{"kind":"person","id":102,"name":"Wilhuff Tarkin","initials":"WT"},"occurred_at":"2024-08-20T12:00:25Z"},{"kind":"story_update_activity","guid":"99_56","project_version":56,"message":"Darth Vader unstarted this feature","highlight":"unstarted","changes":[{"kind":"story","change_type":"update","id":555,"original_values":{"current_state":"unscheduled","before_id":551,"after_id":557},"new_values":{"current_state":"unstarted","before_id":567,"after_id":552},"name":"Bring me the passengers","story_type":"feature","story_priority":"p3"}],"primary_resources":[{"kind":"story","id":555,"name":"Bring me the passengers","story_type":"feature","url":"http://localhost/story/show/555","story_priority":"p3"}],"secondary_resources":[],"project":{"kind":"project","id":99,"name":"Death Star"},"performed_by":{"kind":"person","id":101,"name":"Darth Vader","initials":"DV"},"occurred_at":"2024-08-20T12:00:25Z"},{"kind":"story_update_activity","guid":"99_55","project_version":55,"message":"Emperor Palpatine unstarted this release","highlight":"unstarted","changes":[{"kind":"story","change_type":"update","id":552,"original_values":{"current_state":"unscheduled","before_id":551,"after_id":555},"new_values":{"current_state":"unstarted","before_id":567,"after_id":566},"name":"Battlestation fully operational","story_type":"release","story_priority":"p3"}],"primary_resources":[{"kind":"story","id":552,"name":"Battlestation fully operational","story_type":"release","url":"http://localhost/story/show/552","story_priority":"p3"}],"secondary_resources":[],"project":{"kind":"project","id":99,"name":"Death Star"},"performed_by":{"kind":"person","id":100,"name":"Emperor Palpatine","initials":"EP"},"occurred_at":"2024-08-20T12:00:25Z"},{"kind":"story_update_activity","guid":"99_54","project_version":54,"message":"Darth Vader rejected this feature","highlight":"rejected","changes":[{"kind":"label","change_type":"update","id":2009,"original_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":3,"started":2,"finished":0,"unstarted":0,"planned":0,"delivered":3,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":1,"started":1,"finished":0,"unstarted":0,"planned":0,"delivered":1,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"new_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":3,"started":2,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":3,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":1,"started":1,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":1,"kind":"counts_by_story_state"},"kind":"story_counts"}},"name":"plans"},{"kind":"story","change_type":"update","id":559,"original_values":{"current_state":"delivered"},"new_values":{"current_state":"rejected"},"name":"All exhaust ports should be shielded","story_type":"feature","story_priority":"p3"}],"primary_resources":[{"kind":"story","id":559,"name":"All exhaust ports should be shielded","story_type":"feature","url":"http://localhost/story/show/559","story_priority":"p3"}],"secondary_resources":[],"project":{"kind":"project","id":99,"name":"Death Star"},"performed_by":{"kind":"person","id":101,"name":"Darth Vader","initials":"DV"},"occurred_at":"2024-08-20T12:00:25Z"},{"kind":"story_update_activity","guid":"99_53","project_version":53,"message":"Wilhuff Tarkin delivered this feature","highlight":"delivered","changes":[{"kind":"label","change_type":"update","id":2009,"original_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":3,"started":2,"finished":3,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":1,"started":1,"finished":1,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"new_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":3,"started":2,"finished":0,"unstarted":0,"planned":0,"delivered":3,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":1,"started":1,"finished":0,"unstarted":0,"planned":0,"delivered":1,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"name":"plans"},{"kind":"story","change_type":"update","id":559,"original_values":{"current_state":"finished"},"new_values":{"current_state":"delivered"},"name":"All exhaust ports should be shielded","story_type":"feature","story_priority":"p3"}],"primary_resources":[{"kind":"story","id":559,"name":"All exhaust ports should be shielded","story_type":"feature","url":"http://localhost/story/show/559","story_priority":"p3"}],"secondary_resources":[],"project":{"kind":"project","id":99,"name":"Death Star"},"performed_by":{"kind":"person","id":102,"name":"Wilhuff Tarkin","initials":"WT"},"occurred_at":"2024-08-20T12:00:25Z"},{"kind":"story_update_activity","guid":"99_52","project_version":52,"message":"Wilhuff Tarkin finished this feature","highlight":"finished","changes":[{"kind":"label","change_type":"update","id":2009,"original_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":3,"started":5,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":1,"started":2,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"new_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":3,"started":2,"finished":3,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":1,"started":1,"finished":1,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"name":"plans"},{"kind":"story","change_type":"update","id":559,"original_values":{"current_state":"started"},"new_values":{"current_state":"finished"},"name":"All exhaust ports should be shielded","story_type":"feature","story_priority":"p3"}],"primary_resources":[{"kind":"story","id":559,"name":"All exhaust ports should be shielded","story_type":"feature","url":"http://localhost/story/show/559","story_priority":"p3"}],"secondary_resources":[],"project":{"kind":"project","id":99,"name":"Death Star"},"performed_by":{"kind":"person","id":102,"name":"Wilhuff Tarkin","initials":"WT"},"occurred_at":"2024-08-20T12:00:25Z"},{"kind":"story_update_activity","guid":"99_51","project_version":51,"message":"Wilhuff Tarkin unstarted this chore","highlight":"unstarted","changes":[{"kind":"label","change_type":"update","id":2011,"original_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":4,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":4,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"new_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":1,"planned":0,"delivered":0,"unscheduled":3,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":1,"planned":0,"delivered":0,"unscheduled":3,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"name":"mnt"},{"kind":"story","change_type":"update","id":566,"original_values":{"current_state":"unscheduled","before_id":565,"after_id":567},"new_values":{"current_state":"unstarted","before_id":567,"after_id":561},"name":"Repair CommLink","story_type":"chore","story_priority":"p3"}],"primary_resources":[{"kind":"story","id":566,"name":"Repair CommLink","story_type":"chore","url":"http://localhost/story/show/566","story_priority":"p3"}],"secondary_resources":[],"project":{"kind":"project","id":99,"name":"Death Star"},"performed_by":{"kind":"person","id":102,"name":"Wilhuff Tarkin","initials":"WT"},"occurred_at":"2024-08-20T12:00:25Z"},{"kind":"story_update_activity","guid":"99_50","project_version":50,"message":"Wilhuff Tarkin unstarted this bug","highlight":"unstarted","changes":[{"kind":"story","change_type":"update","id":561,"original_values":{"current_state":"unscheduled","before_id":557,"after_id":562},"new_values":{"current_state":"unstarted","before_id":567,"after_id":559},"name":"Tractor beam loses power intermittently","story_type":"bug","story_priority":"p3"}],"primary_resources":[{"kind":"story","id":561,"name":"Tractor beam loses power intermittently","story_type":"bug","url":"http://localhost/story/show/561","story_priority":"p3"}],"secondary_resources":[],"project":{"kind":"project","id":99,"name":"Death Star"},"performed_by":{"kind":"person","id":102,"name":"Wilhuff Tarkin","initials":"WT"},"occurred_at":"2024-08-20T12:00:25Z"},{"kind":"story_update_activity","guid":"99_49","project_version":49,"message":"Wilhuff Tarkin started this feature","highlight":"started","changes":[{"kind":"label","change_type":"update","id":2009,"original_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":3,"started":2,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":3,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":1,"started":1,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":1,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"new_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":3,"started":5,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":1,"started":2,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"name":"plans"},{"kind":"story","change_type":"update","id":559,"original_values":{"current_state":"unscheduled","before_id":557,"after_id":561},"new_values":{"current_state":"started","before_id":567,"after_id":556},"name":"All exhaust ports should be shielded","story_type":"feature","story_priority":"p3"}],"primary_resources":[{"kind":"story","id":559,"name":"All exhaust ports should be shielded","story_type":"feature","url":"http://localhost/story/show/559","story_priority":"p3"}],"secondary_resources":[],"project":{"kind":"project","id":99,"name":"Death Star"},"performed_by":{"kind":"person","id":102,"name":"Wilhuff Tarkin","initials":"WT"},"occurred_at":"2024-08-20T12:00:25Z"},{"kind":"story_update_activity","guid":"99_48","project_version":48,"message":"Darth Vader started this feature","highlight":"started","changes":[{"kind":"label","change_type":"update","id":2008,"original_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":4,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":2,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":2,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":1,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"new_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":4,"started":2,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":2,"started":1,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"name":"rebel bases"},{"kind":"label","change_type":"update","id":2009,"original_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":3,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":5,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":1,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":2,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"new_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":3,"started":2,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":3,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":1,"started":1,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":1,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"name":"plans"},{"kind":"story","change_type":"update","id":556,"original_values":{"current_state":"unscheduled","before_id":555,"after_id":557},"new_values":{"current_state":"started","before_id":567,"after_id":560},"name":"Interrogate Leia Organa","story_type":"feature","story_priority":"p3"}],"primary_resources":[{"kind":"story","id":556,"name":"Interrogate Leia Organa","story_type":"feature","url":"http://localhost/story/show/556","story_priority":"p3"}],"secondary_resources":[],"project":{"kind":"project","id":99,"name":"Death Star"},"performed_by":{"kind":"person","id":101,"name":"Darth Vader","initials":"DV"},"occurred_at":"2024-08-20T12:00:25Z"},{"kind":"story_update_activity","guid":"99_47","project_version":47,"message":"Darth Vader accepted this feature","highlight":"accepted","changes":[{"kind":"label","change_type":"update","id":2008,"original_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":3,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":1,"unscheduled":2,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":1,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":1,"unscheduled":1,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"new_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":4,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":2,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":2,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":1,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"name":"rebel bases"},{"kind":"story","change_type":"update","id":560,"original_values":{"current_state":"delivered","accepted_at":null},"new_values":{"current_state":"accepted","accepted_at":"2024-08-20T12:00:25Z"},"name":"Destroy Alderaan","story_type":"feature","story_priority":"p3"}],"primary_resources":[{"kind":"story","id":560,"name":"Destroy Alderaan","story_type":"feature","url":"http://localhost/story/show/560","story_priority":"p3"}],"secondary_resources":[],"project":{"kind":"project","id":99,"name":"Death Star"},"performed_by":{"kind":"person","id":101,"name":"Darth Vader","initials":"DV"},"occurred_at":"2024-08-20T12:00:25Z"},{"kind":"story_update_activity","guid":"99_46","project_version":46,"message":"Wilhuff Tarkin delivered this feature","highlight":"delivered","changes":[{"kind":"label","change_type":"update","id":2008,"original_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":3,"started":0,"finished":1,"unstarted":0,"planned":0,"delivered":0,"unscheduled":2,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":1,"started":0,"finished":1,"unstarted":0,"planned":0,"delivered":0,"unscheduled":1,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"new_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":3,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":1,"unscheduled":2,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":1,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":1,"unscheduled":1,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"name":"rebel bases"},{"kind":"story","change_type":"update","id":560,"original_values":{"current_state":"finished"},"new_values":{"current_state":"delivered"},"name":"Destroy Alderaan","story_type":"feature","story_priority":"p3"}],"primary_resources":[{"kind":"story","id":560,"name":"Destroy Alderaan","story_type":"feature","url":"http://localhost/story/show/560","story_priority":"p3"}],"secondary_resources":[],"project":{"kind":"project","id":99,"name":"Death Star"},"performed_by":{"kind":"person","id":102,"name":"Wilhuff Tarkin","initials":"WT"},"occurred_at":"2024-08-20T12:00:25Z"},{"kind":"story_update_activity","guid":"99_45","project_version":45,"message":"Wilhuff Tarkin finished this feature","highlight":"finished","changes":[{"kind":"label","change_type":"update","id":2008,"original_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":3,"started":1,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":2,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":1,"started":1,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":1,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"new_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":3,"started":0,"finished":1,"unstarted":0,"planned":0,"delivered":0,"unscheduled":2,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":1,"started":0,"finished":1,"unstarted":0,"planned":0,"delivered":0,"unscheduled":1,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"name":"rebel bases"},{"kind":"story","change_type":"update","id":560,"original_values":{"current_state":"started"},"new_values":{"current_state":"finished"},"name":"Destroy Alderaan","story_type":"feature","story_priority":"p3"}],"primary_resources":[{"kind":"story","id":560,"name":"Destroy Alderaan","story_type":"feature","url":"http://localhost/story/show/560","story_priority":"p3"}],"secondary_resources":[],"project":{"kind":"project","id":99,"name":"Death Star"},"performed_by":{"kind":"person","id":102,"name":"Wilhuff Tarkin","initials":"WT"},"occurred_at":"2024-08-20T12:00:25Z"},{"kind":"story_update_activity","guid":"99_44","project_version":44,"message":"Wilhuff Tarkin started this feature","highlight":"started","changes":[{"kind":"label","change_type":"update","id":2008,"original_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":3,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":3,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":1,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":2,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"new_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":3,"started":1,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":2,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":1,"started":1,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":1,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"name":"rebel bases"},{"kind":"story","change_type":"update","id":560,"original_values":{"current_state":"unscheduled","before_id":559,"after_id":561},"new_values":{"current_state":"started","before_id":567,"after_id":558},"name":"Destroy Alderaan","story_type":"feature","story_priority":"p3"}],"primary_resources":[{"kind":"story","id":560,"name":"Destroy Alderaan","story_type":"feature","url":"http://localhost/story/show/560","story_priority":"p3"}],"secondary_resources":[],"project":{"kind":"project","id":99,"name":"Death Star"},"performed_by":{"kind":"person","id":102,"name":"Wilhuff Tarkin","initials":"WT"},"occurred_at":"2024-08-20T12:00:25Z"},{"kind":"story_update_activity","guid":"99_43","project_version":43,"message":"Darth Vader edited this feature","highlight":"edited","changes":[{"kind":"label","change_type":"update","id":2008,"original_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":3,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":1,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":1,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":1,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"new_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":3,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":3,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":1,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":2,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"name":"rebel bases"},{"kind":"label","change_type":"update","id":2009,"original_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":3,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":3,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":1,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":1,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"new_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":3,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":5,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":1,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":2,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"name":"plans"},{"kind":"label","change_type":"update","id":2015,"original_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":3,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":2,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"new_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":1,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":1,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"name":"diplomatic relations"},{"kind":"story","change_type":"update","id":556,"original_values":{"label_ids":[2015],"labels":["diplomatic relations"]},"new_values":{"label_ids":[2009,2008],"labels":["plans","rebel bases"]},"name":"Interrogate Leia Organa","story_type":"feature","story_priority":"p3"}],"primary_resources":[{"kind":"story","id":556,"name":"Interrogate Leia Organa","story_type":"feature","url":"http://localhost/story/show/556","story_priority":"p3"}],"secondary_resources":[],"project":{"kind":"project","id":99,"name":"Death Star"},"performed_by":{"kind":"person","id":101,"name":"Darth Vader","initials":"DV"},"occurred_at":"2024-08-20T12:00:25Z"},{"kind":"story_update_activity","guid":"99_42","project_version":42,"message":"Emperor Palpatine edited this feature","highlight":"edited","changes":[{"kind":"epic","change_type":"update","id":6,"original_values":{"completed_at":1724155215000},"new_values":{"completed_at":null},"name":"Death Star Plans"},{"kind":"label","change_type":"update","id":2009,"original_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":3,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":1,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"new_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":3,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":3,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":1,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":1,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"name":"plans"},{"kind":"story","change_type":"update","id":559,"original_values":{"label_ids":[],"labels":[]},"new_values":{"label_ids":[2009],"labels":["plans"]},"name":"All exhaust ports should be shielded","story_type":"feature","story_priority":"p3"}],"primary_resources":[{"kind":"story","id":559,"name":"All exhaust ports should be shielded","story_type":"feature","url":"http://localhost/story/show/559","story_priority":"p3"}],"secondary_resources":[],"project":{"kind":"project","id":99,"name":"Death Star"},"performed_by":{"kind":"person","id":100,"name":"Emperor Palpatine","initials":"EP"},"occurred_at":"2024-08-20T12:00:25Z"},{"kind":"story_update_activity","guid":"99_41","project_version":41,"message":"Emperor Palpatine estimated this feature as 2 points","highlight":"estimated","changes":[{"kind":"label","change_type":"update","id":2014,"original_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":1,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":3,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":1,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":1,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"new_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":3,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":2,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":1,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":1,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"name":"r&d"},{"kind":"story","change_type":"update","id":557,"original_values":{"estimate":null},"new_values":{"estimate":2},"name":"Prepare carbonite freezing chamber","story_type":"feature","story_priority":"p3"}],"primary_resources":[{"kind":"story","id":557,"name":"Prepare carbonite freezing chamber","story_type":"feature","url":"http://localhost/story/show/557","story_priority":"p3"}],"secondary_resources":[],"project":{"kind":"project","id":99,"name":"Death Star"},"performed_by":{"kind":"person","id":100,"name":"Emperor Palpatine","initials":"EP"},"occurred_at":"2024-08-20T12:00:25Z"},{"kind":"story_update_activity","guid":"99_40","project_version":40,"message":"Emperor Palpatine estimated this feature as 1 point","highlight":"estimated","changes":[{"kind":"label","change_type":"update","id":2012,"original_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":1,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":1,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"new_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":1,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":1,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"name":"personnel"},{"kind":"label","change_type":"update","id":2015,"original_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":1,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":2,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":2,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"new_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":3,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":2,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"name":"diplomatic relations"},{"kind":"story","change_type":"update","id":551,"original_values":{"estimate":null},"new_values":{"estimate":1},"name":"Hire bounty hunters to bring in Solo","story_type":"feature","story_priority":"p3"}],"primary_resources":[{"kind":"story","id":551,"name":"Hire bounty hunters to bring in Solo","story_type":"feature","url":"http://localhost/story/show/551","story_priority":"p3"}],"secondary_resources":[],"project":{"kind":"project","id":99,"name":"Death Star"},"performed_by":{"kind":"person","id":100,"name":"Emperor Palpatine","initials":"EP"},"occurred_at":"2024-08-20T12:00:25Z"},{"kind":"story_update_activity","guid":"99_39","project_version":39,"message":"Emperor Palpatine estimated this feature as 2 points","highlight":"estimated","changes":[{"kind":"story","change_type":"update","id":555,"original_values":{"estimate":null},"new_values":{"estimate":2},"name":"Bring me the passengers","story_type":"feature","story_priority":"p3"}],"primary_resources":[{"kind":"story","id":555,"name":"Bring me the passengers","story_type":"feature","url":"http://localhost/story/show/555","story_priority":"p3"}],"secondary_resources":[],"project":{"kind":"project","id":99,"name":"Death Star"},"performed_by":{"kind":"person","id":100,"name":"Emperor Palpatine","initials":"EP"},"occurred_at":"2024-08-20T12:00:25Z"},{"kind":"story_update_activity","guid":"99_38","project_version":38,"message":"Emperor Palpatine estimated this feature as 1 point","highlight":"estimated","changes":[{"kind":"label","change_type":"update","id":2008,"original_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":1,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":3,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":1,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":1,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"new_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":3,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":1,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":1,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":1,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"name":"rebel bases"},{"kind":"story","change_type":"update","id":560,"original_values":{"estimate":null},"new_values":{"estimate":1},"name":"Destroy Alderaan","story_type":"feature","story_priority":"p3"}],"primary_resources":[{"kind":"story","id":560,"name":"Destroy Alderaan","story_type":"feature","url":"http://localhost/story/show/560","story_priority":"p3"}],"secondary_resources":[],"project":{"kind":"project","id":99,"name":"Death Star"},"performed_by":{"kind":"person","id":100,"name":"Emperor Palpatine","initials":"EP"},"occurred_at":"2024-08-20T12:00:25Z"},{"kind":"story_update_activity","guid":"99_37","project_version":37,"message":"Emperor Palpatine estimated this feature as 3 points","highlight":"estimated","changes":[{"kind":"story","change_type":"update","id":559,"original_values":{"estimate":null},"new_values":{"estimate":3},"name":"All exhaust ports should be shielded","story_type":"feature","story_priority":"p3"}],"primary_resources":[{"kind":"story","id":559,"name":"All exhaust ports should be shielded","story_type":"feature","url":"http://localhost/story/show/559","story_priority":"p3"}],"secondary_resources":[],"project":{"kind":"project","id":99,"name":"Death Star"},"performed_by":{"kind":"person","id":100,"name":"Emperor Palpatine","initials":"EP"},"occurred_at":"2024-08-20T12:00:25Z"},{"kind":"story_update_activity","guid":"99_36","project_version":36,"message":"Emperor Palpatine accepted this feature","highlight":"accepted","changes":[{"kind":"epic","change_type":"update","id":6,"original_values":{"past_done_story_estimates":0,"past_done_stories_count":0,"completed_at":null},"new_values":{"past_done_story_estimates":3,"past_done_stories_count":1,"completed_at":1724155215000},"name":"Death Star Plans"},{"kind":"label","change_type":"update","id":2009,"original_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":3,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":1,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"new_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":3,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":1,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"name":"plans"},{"kind":"story","change_type":"update","id":563,"original_values":{"current_state":"delivered","accepted_at":null,"before_id":567,"after_id":558},"new_values":{"current_state":"accepted","accepted_at":"2024-08-20T12:00:15Z","before_id":554,"after_id":553},"name":"Complete construction of the Expeditionary Battle Planetoid","story_type":"feature","story_priority":"p3"}],"primary_resources":[{"kind":"story","id":563,"name":"Complete construction of the Expeditionary Battle Planetoid","story_type":"feature","url":"http://localhost/story/show/563","story_priority":"p3"}],"secondary_resources":[],"project":{"kind":"project","id":99,"name":"Death Star"},"performed_by":{"kind":"person","id":100,"name":"Emperor Palpatine","initials":"EP"},"occurred_at":"2024-08-20T12:00:25Z"},{"kind":"story_update_activity","guid":"99_35","project_version":35,"message":"Emperor Palpatine accepted this feature","highlight":"accepted","changes":[{"kind":"story","change_type":"update","id":554,"original_values":{"current_state":"delivered","accepted_at":null,"before_id":563,"after_id":558},"new_values":{"current_state":"accepted","accepted_at":"2024-08-20T12:00:20Z","before_id":558,"after_id":553},"name":"Identify Bothan spies","story_type":"feature","story_priority":"p3"}],"primary_resources":[{"kind":"story","id":554,"name":"Identify Bothan spies","story_type":"feature","url":"http://localhost/story/show/554","story_priority":"p3"}],"secondary_resources":[],"project":{"kind":"project","id":99,"name":"Death Star"},"performed_by":{"kind":"person","id":100,"name":"Emperor Palpatine","initials":"EP"},"occurred_at":"2024-08-20T12:00:25Z"},{"kind":"story_update_activity","guid":"99_34","project_version":34,"message":"Wilhuff Tarkin delivered this feature","highlight":"delivered","changes":[{"kind":"label","change_type":"update","id":2009,"original_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":0,"started":0,"finished":3,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":0,"started":0,"finished":1,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"new_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":3,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":1,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"name":"plans"},{"kind":"story","change_type":"update","id":563,"original_values":{"current_state":"finished"},"new_values":{"current_state":"delivered"},"name":"Complete construction of the Expeditionary Battle Planetoid","story_type":"feature","story_priority":"p3"}],"primary_resources":[{"kind":"story","id":563,"name":"Complete construction of the Expeditionary Battle Planetoid","story_type":"feature","url":"http://localhost/story/show/563","story_priority":"p3"}],"secondary_resources":[],"project":{"kind":"project","id":99,"name":"Death Star"},"performed_by":{"kind":"person","id":102,"name":"Wilhuff Tarkin","initials":"WT"},"occurred_at":"2024-08-20T12:00:25Z"},{"kind":"story_update_activity","guid":"99_33","project_version":33,"message":"Wilhuff Tarkin finished this feature","highlight":"finished","changes":[{"kind":"label","change_type":"update","id":2009,"original_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":0,"started":3,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":0,"started":1,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"new_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":0,"started":0,"finished":3,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":0,"started":0,"finished":1,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"name":"plans"},{"kind":"story","change_type":"update","id":563,"original_values":{"current_state":"started"},"new_values":{"current_state":"finished"},"name":"Complete construction of the Expeditionary Battle Planetoid","story_type":"feature","story_priority":"p3"}],"primary_resources":[{"kind":"story","id":563,"name":"Complete construction of the Expeditionary Battle Planetoid","story_type":"feature","url":"http://localhost/story/show/563","story_priority":"p3"}],"secondary_resources":[],"project":{"kind":"project","id":99,"name":"Death Star"},"performed_by":{"kind":"person","id":102,"name":"Wilhuff Tarkin","initials":"WT"},"occurred_at":"2024-08-20T12:00:25Z"},{"kind":"story_update_activity","guid":"99_32","project_version":32,"message":"Wilhuff Tarkin started this feature","highlight":"started","changes":[{"kind":"label","change_type":"update","id":2009,"original_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":3,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":1,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"new_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":0,"started":3,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":0,"started":1,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"name":"plans"},{"kind":"story","change_type":"update","id":563,"original_values":{"current_state":"unscheduled","before_id":562,"after_id":564},"new_values":{"current_state":"started","before_id":567,"after_id":554},"name":"Complete construction of the Expeditionary Battle Planetoid","story_type":"feature","story_priority":"p3"}],"primary_resources":[{"kind":"story","id":563,"name":"Complete construction of the Expeditionary Battle Planetoid","story_type":"feature","url":"http://localhost/story/show/563","story_priority":"p3"}],"secondary_resources":[],"project":{"kind":"project","id":99,"name":"Death Star"},"performed_by":{"kind":"person","id":102,"name":"Wilhuff Tarkin","initials":"WT"},"occurred_at":"2024-08-20T12:00:25Z"},{"kind":"story_update_activity","guid":"99_31","project_version":31,"message":"Emperor Palpatine delivered this feature","highlight":"delivered","changes":[{"kind":"story","change_type":"update","id":554,"original_values":{"current_state":"finished"},"new_values":{"current_state":"delivered"},"name":"Identify Bothan spies","story_type":"feature","story_priority":"p3"}],"primary_resources":[{"kind":"story","id":554,"name":"Identify Bothan spies","story_type":"feature","url":"http://localhost/story/show/554","story_priority":"p3"}],"secondary_resources":[],"project":{"kind":"project","id":99,"name":"Death Star"},"performed_by":{"kind":"person","id":100,"name":"Emperor Palpatine","initials":"EP"},"occurred_at":"2024-08-20T12:00:25Z"},{"kind":"story_update_activity","guid":"99_30","project_version":30,"message":"Emperor Palpatine finished this feature","highlight":"finished","changes":[{"kind":"story","change_type":"update","id":554,"original_values":{"current_state":"started"},"new_values":{"current_state":"finished"},"name":"Identify Bothan spies","story_type":"feature","story_priority":"p3"}],"primary_resources":[{"kind":"story","id":554,"name":"Identify Bothan spies","story_type":"feature","url":"http://localhost/story/show/554","story_priority":"p3"}],"secondary_resources":[],"project":{"kind":"project","id":99,"name":"Death Star"},"performed_by":{"kind":"person","id":100,"name":"Emperor Palpatine","initials":"EP"},"occurred_at":"2024-08-20T12:00:25Z"},{"kind":"story_update_activity","guid":"99_29","project_version":29,"message":"Emperor Palpatine started this feature","highlight":"started","changes":[{"kind":"story","change_type":"update","id":554,"original_values":{"current_state":"unscheduled","before_id":552,"after_id":555},"new_values":{"current_state":"started","before_id":567,"after_id":558},"name":"Identify Bothan spies","story_type":"feature","story_priority":"p3"}],"primary_resources":[{"kind":"story","id":554,"name":"Identify Bothan spies","story_type":"feature","url":"http://localhost/story/show/554","story_priority":"p3"}],"secondary_resources":[],"project":{"kind":"project","id":99,"name":"Death Star"},"performed_by":{"kind":"person","id":100,"name":"Emperor Palpatine","initials":"EP"},"occurred_at":"2024-08-20T12:00:25Z"},{"kind":"story_update_activity","guid":"99_28","project_version":28,"message":"Emperor Palpatine estimated this feature as 3 points","highlight":"estimated","changes":[{"kind":"label","change_type":"update","id":2009,"original_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":1,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":1,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"new_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":3,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":1,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"name":"plans"},{"kind":"story","change_type":"update","id":563,"original_values":{"estimate":null},"new_values":{"estimate":3},"name":"Complete construction of the Expeditionary Battle Planetoid","story_type":"feature","story_priority":"p3"}],"primary_resources":[{"kind":"story","id":563,"name":"Complete construction of the Expeditionary Battle Planetoid","story_type":"feature","url":"http://localhost/story/show/563","story_priority":"p3"}],"secondary_resources":[],"project":{"kind":"project","id":99,"name":"Death Star"},"performed_by":{"kind":"person","id":100,"name":"Emperor Palpatine","initials":"EP"},"occurred_at":"2024-08-20T12:00:25Z"},{"kind":"story_update_activity","guid":"99_27","project_version":27,"message":"Emperor Palpatine estimated this feature as 3 points","highlight":"estimated","changes":[{"kind":"story","change_type":"update","id":554,"original_values":{"estimate":null},"new_values":{"estimate":3},"name":"Identify Bothan spies","story_type":"feature","story_priority":"p3"}],"primary_resources":[{"kind":"story","id":554,"name":"Identify Bothan spies","story_type":"feature","url":"http://localhost/story/show/554","story_priority":"p3"}],"secondary_resources":[],"project":{"kind":"project","id":99,"name":"Death Star"},"performed_by":{"kind":"person","id":100,"name":"Emperor Palpatine","initials":"EP"},"occurred_at":"2024-08-20T12:00:25Z"},{"kind":"story_update_activity","guid":"99_26","project_version":26,"message":"Emperor Palpatine estimated this feature as 2 points","highlight":"estimated","changes":[{"kind":"label","change_type":"update","id":2015,"original_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":2,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":2,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"new_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":1,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":2,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":2,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"name":"diplomatic relations"},{"kind":"story","change_type":"update","id":556,"original_values":{"estimate":null},"new_values":{"estimate":2},"name":"Interrogate Leia Organa","story_type":"feature","story_priority":"p3"}],"primary_resources":[{"kind":"story","id":556,"name":"Interrogate Leia Organa","story_type":"feature","url":"http://localhost/story/show/556","story_priority":"p3"}],"secondary_resources":[],"project":{"kind":"project","id":99,"name":"Death Star"},"performed_by":{"kind":"person","id":100,"name":"Emperor Palpatine","initials":"EP"},"occurred_at":"2024-08-20T12:00:25Z"},{"kind":"epic_create_activity","guid":"99_25","project_version":25,"message":"Wilhuff Tarkin added this epic","highlight":"added","changes":[{"kind":"epic","change_type":"create","id":555,"new_values":{"id":555,"project_id":99,"name":"Sanitation","label_id":2017,"follower_ids":[],"created_at":"2024-08-20T12:00:25Z","updated_at":"2024-08-20T12:00:25Z","before_id":8,"past_done_story_estimates":0,"past_done_stories_count":0,"past_done_stories_no_point_count":0,"label":"sanitation"},"name":"Sanitation"}],"primary_resources":[{"kind":"epic","id":555,"name":"Sanitation","url":"http://localhost/epic/show/555"}],"secondary_resources":[],"project":{"kind":"project","id":99,"name":"Death Star"},"performed_by":{"kind":"person","id":102,"name":"Wilhuff Tarkin","initials":"WT"},"occurred_at":"2024-08-20T12:00:25Z"},{"kind":"epic_create_activity","guid":"99_24","project_version":24,"message":"Wilhuff Tarkin added this epic","highlight":"added","changes":[{"kind":"epic","change_type":"create","id":8,"new_values":{"id":8,"project_id":99,"name":"Maintenance","label_id":2011,"follower_ids":[],"created_at":"2024-08-20T12:00:25Z","updated_at":"2024-08-20T12:00:25Z","before_id":7,"past_done_story_estimates":0,"past_done_stories_count":0,"past_done_stories_no_point_count":0,"label":"mnt"},"name":"Maintenance"}],"primary_resources":[{"kind":"epic","id":8,"name":"Maintenance","url":"http://localhost/epic/show/8"}],"secondary_resources":[],"project":{"kind":"project","id":99,"name":"Death Star"},"performed_by":{"kind":"person","id":102,"name":"Wilhuff Tarkin","initials":"WT"},"occurred_at":"2024-08-20T12:00:25Z"},{"kind":"epic_create_activity","guid":"99_23","project_version":23,"message":"Wilhuff Tarkin added this epic","highlight":"added","changes":[{"kind":"epic","change_type":"create","id":7,"new_values":{"id":7,"project_id":99,"name":"Turn Luke Skywalker","label_id":2010,"follower_ids":[],"created_at":"2024-08-20T12:00:25Z","updated_at":"2024-08-20T12:00:25Z","before_id":6,"past_done_story_estimates":0,"past_done_stories_count":0,"past_done_stories_no_point_count":0,"label":"turning luke"},"name":"Turn Luke Skywalker"}],"primary_resources":[{"kind":"epic","id":7,"name":"Turn Luke Skywalker","url":"http://localhost/epic/show/7"}],"secondary_resources":[],"project":{"kind":"project","id":99,"name":"Death Star"},"performed_by":{"kind":"person","id":102,"name":"Wilhuff Tarkin","initials":"WT"},"occurred_at":"2024-08-20T12:00:25Z"},{"kind":"epic_create_activity","guid":"99_22","project_version":22,"message":"Wilhuff Tarkin added this epic","highlight":"added","changes":[{"kind":"epic","change_type":"create","id":6,"new_values":{"id":6,"project_id":99,"name":"Death Star Plans","label_id":2009,"follower_ids":[],"created_at":"2024-08-20T12:00:25Z","updated_at":"2024-08-20T12:00:25Z","before_id":5,"past_done_story_estimates":0,"past_done_stories_count":0,"past_done_stories_no_point_count":0,"label":"plans"},"name":"Death Star Plans"}],"primary_resources":[{"kind":"epic","id":6,"name":"Death Star Plans","url":"http://localhost/epic/show/6"}],"secondary_resources":[],"project":{"kind":"project","id":99,"name":"Death Star"},"performed_by":{"kind":"person","id":102,"name":"Wilhuff Tarkin","initials":"WT"},"occurred_at":"2024-08-20T12:00:25Z"},{"kind":"epic_create_activity","guid":"99_21","project_version":21,"message":"Wilhuff Tarkin added this epic","highlight":"added","changes":[{"kind":"epic","change_type":"create","id":5,"new_values":{"id":5,"project_id":99,"name":"Rebel Home Worlds","label_id":2008,"description":"Identify the systems and eliminate the rebel scum.","follower_ids":[],"created_at":"2024-08-20T12:00:25Z","updated_at":"2024-08-20T12:00:25Z","past_done_story_estimates":3,"past_done_stories_count":1,"past_done_stories_no_point_count":0,"label":"rebel bases"},"name":"Rebel Home Worlds"}],"primary_resources":[{"kind":"epic","id":5,"name":"Rebel Home Worlds","url":"http://localhost/epic/show/5"}],"secondary_resources":[],"project":{"kind":"project","id":99,"name":"Death Star"},"performed_by":{"kind":"person","id":102,"name":"Wilhuff Tarkin","initials":"WT"},"occurred_at":"2024-08-20T12:00:25Z"},{"kind":"story_create_activity","guid":"99_20","project_version":20,"message":"Clone TK421 added this feature","highlight":"added","changes":[{"kind":"story","change_type":"create","id":567,"new_values":{"id":567,"project_id":99,"name":"Clean Cell Block 1138","description":"The large, hairy _Thing_ is being transferred away","story_type":"feature","current_state":"unscheduled","requested_by_id":104,"owner_ids":[],"label_ids":[2011],"follower_ids":[],"created_at":"2024-08-20T12:00:25Z","updated_at":"2024-08-20T12:00:25Z","before_id":566,"after_id":558,"blocked_story_ids":[],"story_priority":"p3","labels":["mnt"]},"name":"Clean Cell Block 1138","story_type":"feature","story_priority":"p3"},{"kind":"label","change_type":"update","id":2011,"original_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":3,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":3,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"new_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":4,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":4,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"name":"mnt"}],"primary_resources":[{"kind":"story","id":567,"name":"Clean Cell Block 1138","story_type":"feature","url":"http://localhost/story/show/567","story_priority":"p3"}],"secondary_resources":[],"project":{"kind":"project","id":99,"name":"Death Star"},"performed_by":{"kind":"person","id":104,"name":"Clone TK421","initials":"TK421"},"occurred_at":"2024-08-20T12:00:25Z"},{"kind":"story_create_activity","guid":"99_19","project_version":19,"message":"Clone TK421 added this chore","highlight":"added","changes":[{"kind":"story","change_type":"create","id":566,"new_values":{"id":566,"project_id":99,"name":"Repair CommLink","description":"It's malfunctioning.","story_type":"chore","current_state":"unscheduled","requested_by_id":104,"owner_ids":[],"label_ids":[2011],"follower_ids":[],"created_at":"2024-08-20T12:00:25Z","updated_at":"2024-08-20T12:00:25Z","before_id":565,"after_id":558,"blocked_story_ids":[],"story_priority":"p3","labels":["mnt"]},"name":"Repair CommLink","story_type":"chore","story_priority":"p3"},{"kind":"label","change_type":"update","id":2011,"original_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":2,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":2,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"new_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":3,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":3,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"name":"mnt"}],"primary_resources":[{"kind":"story","id":566,"name":"Repair CommLink","story_type":"chore","url":"http://localhost/story/show/566","story_priority":"p3"}],"secondary_resources":[],"project":{"kind":"project","id":99,"name":"Death Star"},"performed_by":{"kind":"person","id":104,"name":"Clone TK421","initials":"TK421"},"occurred_at":"2024-08-20T12:00:25Z"},{"kind":"story_create_activity","guid":"99_18","project_version":18,"message":"Moradmin Bast added this feature","highlight":"added","changes":[{"kind":"story","change_type":"create","id":565,"new_values":{"id":565,"project_id":99,"name":"Reactor leak reported in Detention Block AA-23","description":"large leak, very dangerous","story_type":"feature","current_state":"unscheduled","requested_by_id":103,"owner_ids":[],"label_ids":[2011],"follower_ids":[],"created_at":"2024-08-20T12:00:25Z","updated_at":"2024-08-20T12:00:25Z","before_id":564,"after_id":558,"blocked_story_ids":[],"story_priority":"p3","labels":["mnt"]},"name":"Reactor leak reported in Detention Block AA-23","story_type":"feature","story_priority":"p3"},{"kind":"label","change_type":"update","id":2011,"original_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":1,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":1,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"new_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":2,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":2,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"name":"mnt"}],"primary_resources":[{"kind":"story","id":565,"name":"Reactor leak reported in Detention Block AA-23","story_type":"feature","url":"http://localhost/story/show/565","story_priority":"p3"}],"secondary_resources":[],"project":{"kind":"project","id":99,"name":"Death Star"},"performed_by":{"kind":"person","id":103,"name":"Moradmin Bast","initials":"MB"},"occurred_at":"2024-08-20T12:00:25Z"},{"kind":"story_create_activity","guid":"99_17","project_version":17,"message":"Moradmin Bast added this feature","highlight":"added","changes":[{"kind":"story","change_type":"create","id":564,"new_values":{"id":564,"project_id":99,"name":"Evacuate, in our moment of triumph","description":"Sir, I've prepared your shuttle.","story_type":"feature","current_state":"unscheduled","requested_by_id":103,"owned_by_id":102,"owner_ids":[102],"label_ids":[],"follower_ids":[],"created_at":"2024-08-20T12:00:25Z","updated_at":"2024-08-20T12:00:25Z","before_id":563,"after_id":558,"blocked_story_ids":[],"story_priority":"p3","labels":[]},"name":"Evacuate, in our moment of triumph","story_type":"feature","story_priority":"p3"}],"primary_resources":[{"kind":"story","id":564,"name":"Evacuate, in our moment of triumph","story_type":"feature","url":"http://localhost/story/show/564","story_priority":"p3"}],"secondary_resources":[],"project":{"kind":"project","id":99,"name":"Death Star"},"performed_by":{"kind":"person","id":103,"name":"Moradmin Bast","initials":"MB"},"occurred_at":"2024-08-20T12:00:25Z"},{"kind":"story_create_activity","guid":"99_16","project_version":16,"message":"Wilhuff Tarkin added this feature","highlight":"added","changes":[{"kind":"story","change_type":"create","id":563,"new_values":{"id":563,"project_id":99,"name":"Complete construction of the Expeditionary Battle Planetoid","description":"Palpatine was impressed with the PoC, make this one bigger","story_type":"feature","current_state":"unscheduled","requested_by_id":102,"owned_by_id":102,"owner_ids":[102,101],"label_ids":[2009],"follower_ids":[],"created_at":"2024-08-20T12:00:25Z","updated_at":"2024-08-20T12:00:25Z","before_id":562,"after_id":558,"integration_id":30,"external_id":"abc123","blocked_story_ids":[],"story_priority":"p3","labels":["plans"]},"name":"Complete construction of the Expeditionary Battle Planetoid","story_type":"feature","story_priority":"p3"},{"kind":"label","change_type":"update","id":2009,"original_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"new_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":1,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":1,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"name":"plans"}],"primary_resources":[{"kind":"story","id":563,"name":"Complete construction of the Expeditionary Battle Planetoid","story_type":"feature","url":"http://localhost/story/show/563","story_priority":"p3"}],"secondary_resources":[],"project":{"kind":"project","id":99,"name":"Death Star"},"performed_by":{"kind":"person","id":102,"name":"Wilhuff Tarkin","initials":"WT"},"occurred_at":"2024-08-20T12:00:25Z"},{"kind":"story_create_activity","guid":"99_15","project_version":15,"message":"Wilhuff Tarkin added this bug","highlight":"added","changes":[{"kind":"story","change_type":"create","id":562,"new_values":{"id":562,"project_id":99,"name":"Garbage smashers on the detention level have malfunctioned","story_type":"bug","current_state":"unscheduled","requested_by_id":102,"owner_ids":[],"label_ids":[2011],"follower_ids":[],"created_at":"2024-08-20T12:00:25Z","updated_at":"2024-08-20T12:00:25Z","before_id":561,"after_id":558,"blocked_story_ids":[],"story_priority":"p3","labels":["mnt"]},"name":"Garbage smashers on the detention level have malfunctioned","story_type":"bug","story_priority":"p3"},{"kind":"label","change_type":"update","id":2011,"original_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"new_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":1,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":1,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"name":"mnt"}],"primary_resources":[{"kind":"story","id":562,"name":"Garbage smashers on the detention level have malfunctioned","story_type":"bug","url":"http://localhost/story/show/562","story_priority":"p3"}],"secondary_resources":[],"project":{"kind":"project","id":99,"name":"Death Star"},"performed_by":{"kind":"person","id":102,"name":"Wilhuff Tarkin","initials":"WT"},"occurred_at":"2024-08-20T12:00:25Z"},{"kind":"story_create_activity","guid":"99_14","project_version":14,"message":"Wilhuff Tarkin added this bug","highlight":"added","changes":[{"kind":"story","change_type":"create","id":561,"new_values":{"id":561,"project_id":99,"name":"Tractor beam loses power intermittently","story_type":"bug","current_state":"unscheduled","requested_by_id":102,"owner_ids":[],"label_ids":[],"follower_ids":[],"created_at":"2024-08-20T12:00:25Z","updated_at":"2024-08-20T12:00:25Z","before_id":560,"after_id":558,"blocked_story_ids":[],"story_priority":"p3","labels":[]},"name":"Tractor beam loses power intermittently","story_type":"bug","story_priority":"p3"}],"primary_resources":[{"kind":"story","id":561,"name":"Tractor beam loses power intermittently","story_type":"bug","url":"http://localhost/story/show/561","story_priority":"p3"}],"secondary_resources":[],"project":{"kind":"project","id":99,"name":"Death Star"},"performed_by":{"kind":"person","id":102,"name":"Wilhuff Tarkin","initials":"WT"},"occurred_at":"2024-08-20T12:00:25Z"},{"kind":"story_create_activity","guid":"99_13","project_version":13,"message":"Wilhuff Tarkin added this feature","highlight":"added","changes":[{"kind":"story","change_type":"create","id":560,"new_values":{"id":560,"project_id":99,"name":"Destroy Alderaan","description":"Dantooine is too remote to make an effective demonstration.","story_type":"feature","current_state":"unscheduled","requested_by_id":102,"owned_by_id":101,"owner_ids":[101,105],"label_ids":[2008],"follower_ids":[],"created_at":"2024-08-20T12:00:25Z","updated_at":"2024-08-20T12:00:25Z","before_id":559,"after_id":558,"blocked_story_ids":[],"story_priority":"p3","labels":["rebel bases"]},"name":"Destroy Alderaan","story_type":"feature","story_priority":"p3"},{"kind":"label","change_type":"update","id":2008,"original_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":3,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":1,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"new_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":1,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":3,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":1,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":1,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"name":"rebel bases"}],"primary_resources":[{"kind":"story","id":560,"name":"Destroy Alderaan","story_type":"feature","url":"http://localhost/story/show/560","story_priority":"p3"}],"secondary_resources":[],"project":{"kind":"project","id":99,"name":"Death Star"},"performed_by":{"kind":"person","id":102,"name":"Wilhuff Tarkin","initials":"WT"},"occurred_at":"2024-08-20T12:00:25Z"},{"kind":"story_create_activity","guid":"99_12","project_version":12,"message":"Wilhuff Tarkin added this feature","highlight":"added","changes":[{"kind":"story","change_type":"create","id":559,"new_values":{"id":559,"project_id":99,"name":"All exhaust ports should be shielded","description":"ray shielded, that is.","story_type":"feature","current_state":"unscheduled","requested_by_id":102,"owned_by_id":104,"owner_ids":[104],"label_ids":[],"follower_ids":[],"created_at":"2024-08-20T12:00:25Z","updated_at":"2024-08-20T12:00:25Z","before_id":557,"after_id":558,"blocked_story_ids":[],"story_priority":"p3","labels":[]},"name":"All exhaust ports should be shielded","story_type":"feature","story_priority":"p3"}],"primary_resources":[{"kind":"story","id":559,"name":"All exhaust ports should be shielded","story_type":"feature","url":"http://localhost/story/show/559","story_priority":"p3"}],"secondary_resources":[],"project":{"kind":"project","id":99,"name":"Death Star"},"performed_by":{"kind":"person","id":102,"name":"Wilhuff Tarkin","initials":"WT"},"occurred_at":"2024-08-20T12:00:25Z"},{"kind":"story_create_activity","guid":"99_11","project_version":11,"message":"Darth Vader added this feature","highlight":"added","changes":[{"kind":"story","change_type":"create","id":558,"new_values":{"id":558,"project_id":99,"name":"Contact Lando","story_type":"feature","current_state":"accepted","estimate":1,"accepted_at":"2024-08-20T12:00:25Z","requested_by_id":101,"owner_ids":[],"label_ids":[],"follower_ids":[],"created_at":"2024-08-20T12:00:25Z","updated_at":"2024-08-20T12:00:25Z","before_id":557,"after_id":553,"blocked_story_ids":[],"story_priority":"p3","labels":[]},"name":"Contact Lando","story_type":"feature","story_priority":"p3"}],"primary_resources":[{"kind":"story","id":558,"name":"Contact Lando","story_type":"feature","url":"http://localhost/story/show/558","story_priority":"p3"}],"secondary_resources":[],"project":{"kind":"project","id":99,"name":"Death Star"},"performed_by":{"kind":"person","id":101,"name":"Darth Vader","initials":"DV"},"occurred_at":"2024-08-20T12:00:25Z"},{"kind":"story_create_activity","guid":"99_10","project_version":10,"message":"Darth Vader added this feature","highlight":"added","changes":[{"kind":"story","change_type":"create","id":557,"new_values":{"id":557,"project_id":99,"name":"Prepare carbonite freezing chamber","description":"Test first on Solo, we don't want the Emperor's prize damaged.","story_type":"feature","current_state":"unscheduled","requested_by_id":101,"owner_ids":[],"label_ids":[2014],"follower_ids":[],"created_at":"2024-08-20T12:00:25Z","updated_at":"2024-08-20T12:00:25Z","before_id":556,"after_id":553,"blocked_story_ids":[],"story_priority":"p3","labels":["r&d"]},"name":"Prepare carbonite freezing chamber","story_type":"feature","story_priority":"p3"},{"kind":"label","change_type":"update","id":2014,"original_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":3,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":1,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"new_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":1,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":3,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":1,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":1,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"name":"r&d"}],"primary_resources":[{"kind":"story","id":557,"name":"Prepare carbonite freezing chamber","story_type":"feature","url":"http://localhost/story/show/557","story_priority":"p3"}],"secondary_resources":[],"project":{"kind":"project","id":99,"name":"Death Star"},"performed_by":{"kind":"person","id":101,"name":"Darth Vader","initials":"DV"},"occurred_at":"2024-08-20T12:00:25Z"},{"kind":"story_create_activity","guid":"99_9","project_version":9,"message":"Darth Vader added this feature","highlight":"added","changes":[{"kind":"story","change_type":"create","id":556,"new_values":{"id":556,"project_id":99,"name":"Interrogate Leia Organa","description":"She is proving to be resistant to our mind probes","story_type":"feature","current_state":"unscheduled","requested_by_id":101,"owned_by_id":101,"owner_ids":[101,105],"label_ids":[2015],"follower_ids":[],"created_at":"2024-08-20T12:00:25Z","updated_at":"2024-08-20T12:00:25Z","before_id":555,"after_id":553,"blocked_story_ids":[],"story_priority":"p3","labels":["diplomatic relations"]},"name":"Interrogate Leia Organa","story_type":"feature","story_priority":"p3"},{"kind":"label","change_type":"update","id":2015,"original_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":1,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":1,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"new_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":2,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":2,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"name":"diplomatic relations"}],"primary_resources":[{"kind":"story","id":556,"name":"Interrogate Leia Organa","story_type":"feature","url":"http://localhost/story/show/556","story_priority":"p3"}],"secondary_resources":[],"project":{"kind":"project","id":99,"name":"Death Star"},"performed_by":{"kind":"person","id":101,"name":"Darth Vader","initials":"DV"},"occurred_at":"2024-08-20T12:00:25Z"},{"kind":"story_create_activity","guid":"99_8","project_version":8,"message":"Darth Vader added this feature","highlight":"added","changes":[{"kind":"story","change_type":"create","id":555,"new_values":{"id":555,"project_id":99,"name":"Bring me the passengers","description":"ignore the droids","story_type":"feature","current_state":"unscheduled","requested_by_id":101,"owner_ids":[],"label_ids":[],"follower_ids":[],"created_at":"2024-08-20T12:00:25Z","updated_at":"2024-08-20T12:00:25Z","before_id":554,"after_id":553,"blocked_story_ids":[],"story_priority":"p3","labels":[]},"name":"Bring me the passengers","story_type":"feature","story_priority":"p3"}],"primary_resources":[{"kind":"story","id":555,"name":"Bring me the passengers","story_type":"feature","url":"http://localhost/story/show/555","story_priority":"p3"}],"secondary_resources":[],"project":{"kind":"project","id":99,"name":"Death Star"},"performed_by":{"kind":"person","id":101,"name":"Darth Vader","initials":"DV"},"occurred_at":"2024-08-20T12:00:25Z"},{"kind":"story_create_activity","guid":"99_7","project_version":7,"message":"Darth Vader added this feature","highlight":"added","changes":[{"kind":"story","change_type":"create","id":554,"new_values":{"id":554,"project_id":99,"name":"Identify Bothan spies","description":"Infiltrate their spy network.","story_type":"feature","current_state":"unscheduled","requested_by_id":101,"owned_by_id":106,"owner_ids":[106],"label_ids":[],"follower_ids":[],"created_at":"2024-08-20T12:00:25Z","updated_at":"2024-08-20T12:00:25Z","before_id":552,"after_id":553,"blocked_story_ids":[],"story_priority":"p3","labels":[]},"name":"Identify Bothan spies","story_type":"feature","story_priority":"p3"}],"primary_resources":[{"kind":"story","id":554,"name":"Identify Bothan spies","story_type":"feature","url":"http://localhost/story/show/554","story_priority":"p3"}],"secondary_resources":[],"project":{"kind":"project","id":99,"name":"Death Star"},"performed_by":{"kind":"person","id":101,"name":"Darth Vader","initials":"DV"},"occurred_at":"2024-08-20T12:00:25Z"},{"kind":"story_create_activity","guid":"99_6","project_version":6,"message":"Darth Vader added this feature","highlight":"added","changes":[{"kind":"story","change_type":"create","id":553,"new_values":{"id":553,"project_id":99,"name":"Build protocol droid","description":"I want a friend","story_type":"feature","current_state":"accepted","estimate":3,"accepted_at":"2024-08-20T12:00:05Z","requested_by_id":101,"owned_by_id":101,"owner_ids":[101],"label_ids":[2014,2008],"follower_ids":[],"created_at":"2024-08-20T12:00:25Z","updated_at":"2024-08-20T12:00:25Z","before_id":552,"blocked_story_ids":[],"story_priority":"p3","labels":["r&d","rebel bases"]},"name":"Build protocol droid","story_type":"feature","story_priority":"p3"},{"kind":"label","change_type":"update","id":2008,"original_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"new_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":3,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":1,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"name":"rebel bases"},{"kind":"label","change_type":"update","id":2014,"original_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"new_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":3,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":1,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"name":"r&d"}],"primary_resources":[{"kind":"story","id":553,"name":"Build protocol droid","story_type":"feature","url":"http://localhost/story/show/553","story_priority":"p3"}],"secondary_resources":[],"project":{"kind":"project","id":99,"name":"Death Star"},"performed_by":{"kind":"person","id":101,"name":"Darth Vader","initials":"DV"},"occurred_at":"2024-08-20T12:00:25Z"},{"kind":"story_create_activity","guid":"99_5","project_version":5,"message":"Emperor Palpatine added this release","highlight":"added","changes":[{"kind":"story","change_type":"create","id":552,"new_values":{"id":552,"project_id":99,"name":"Battlestation fully operational","description":"Everything is proceeding as I have foreseen.","story_type":"release","current_state":"unscheduled","deadline":"2024-08-20T12:00:30Z","requested_by_id":100,"owner_ids":[],"label_ids":[],"follower_ids":[],"created_at":"2024-08-20T12:00:25Z","updated_at":"2024-08-20T12:00:25Z","before_id":551,"blocked_story_ids":[],"story_priority":"p3","labels":[]},"name":"Battlestation fully operational","story_type":"release","story_priority":"p3"}],"primary_resources":[{"kind":"story","id":552,"name":"Battlestation fully operational","story_type":"release","url":"http://localhost/story/show/552","story_priority":"p3"}],"secondary_resources":[],"project":{"kind":"project","id":99,"name":"Death Star"},"performed_by":{"kind":"person","id":100,"name":"Emperor Palpatine","initials":"EP"},"occurred_at":"2024-08-20T12:00:25Z"},{"kind":"story_create_activity","guid":"99_4","project_version":4,"message":"Emperor Palpatine added this feature","highlight":"added","changes":[{"kind":"story","change_type":"create","id":551,"new_values":{"id":551,"project_id":99,"name":"Hire bounty hunters to bring in Solo","description":"No disintegrations","story_type":"feature","current_state":"unscheduled","requested_by_id":100,"owned_by_id":101,"owner_ids":[101,104],"label_ids":[2015,2012],"follower_ids":[],"created_at":"2024-08-20T12:00:25Z","updated_at":"2024-08-20T12:00:25Z","blocked_story_ids":[],"story_priority":"p3","labels":["diplomatic relations","personnel"]},"name":"Hire bounty hunters to bring in Solo","story_type":"feature","story_priority":"p3"},{"kind":"label","change_type":"update","id":2012,"original_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"new_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":1,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":1,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"name":"personnel"},{"kind":"label","change_type":"update","id":2015,"original_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"new_values":{"counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":1,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":1,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"name":"diplomatic relations"}],"primary_resources":[{"kind":"story","id":551,"name":"Hire bounty hunters to bring in Solo","story_type":"feature","url":"http://localhost/story/show/551","story_priority":"p3"}],"secondary_resources":[],"project":{"kind":"project","id":99,"name":"Death Star"},"performed_by":{"kind":"person","id":100,"name":"Emperor Palpatine","initials":"EP"},"occurred_at":"2024-08-20T12:00:25Z"},{"kind":"label_update_activity","guid":"99_3","project_version":3,"message":"Wilhuff Tarkin renamed label from 'security protocols' to 'security protocol'","highlight":"renamed label","changes":[{"kind":"label","change_type":"update","id":2016,"original_values":{"name":"security protocols"},"new_values":{"name":"security protocol"},"name":"security protocol"}],"primary_resources":[{"kind":"label","id":2016,"name":"security protocol"}],"secondary_resources":[],"project":{"kind":"project","id":99,"name":"Death Star"},"performed_by":{"kind":"person","id":102,"name":"Wilhuff Tarkin","initials":"WT"},"occurred_at":"2024-08-20T12:00:25Z"},{"kind":"label_create_activity","guid":"99_2","project_version":2,"message":"Wilhuff Tarkin created labels: \"rebel bases\", \"plans\", \"turning luke\", \"mnt\", \"personnel\", \"fleet ops\", \"r&d\", \"diplomatic relations\", \"security protocol\"","highlight":"created","changes":[{"kind":"label","change_type":"create","id":2008,"new_values":{"id":2008,"project_id":99,"name":"rebel bases","created_at":"2024-08-20T12:00:25Z","updated_at":"2024-08-20T12:00:25Z","counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"name":"rebel bases"},{"kind":"label","change_type":"create","id":2009,"new_values":{"id":2009,"project_id":99,"name":"plans","created_at":"2024-08-20T12:00:25Z","updated_at":"2024-08-20T12:00:25Z","counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"name":"plans"},{"kind":"label","change_type":"create","id":2010,"new_values":{"id":2010,"project_id":99,"name":"turning luke","created_at":"2024-08-20T12:00:25Z","updated_at":"2024-08-20T12:00:25Z","counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"name":"turning luke"},{"kind":"label","change_type":"create","id":2011,"new_values":{"id":2011,"project_id":99,"name":"mnt","created_at":"2024-08-20T12:00:25Z","updated_at":"2024-08-20T12:00:25Z","counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"name":"mnt"},{"kind":"label","change_type":"create","id":2012,"new_values":{"id":2012,"project_id":99,"name":"personnel","created_at":"2024-08-20T12:00:25Z","updated_at":"2024-08-20T12:00:25Z","counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"name":"personnel"},{"kind":"label","change_type":"create","id":2013,"new_values":{"id":2013,"project_id":99,"name":"fleet ops","created_at":"2024-08-20T12:00:25Z","updated_at":"2024-08-20T12:00:25Z","counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"name":"fleet ops"},{"kind":"label","change_type":"create","id":2014,"new_values":{"id":2014,"project_id":99,"name":"r&d","created_at":"2024-08-20T12:00:25Z","updated_at":"2024-08-20T12:00:25Z","counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"name":"r&d"},{"kind":"label","change_type":"create","id":2015,"new_values":{"id":2015,"project_id":99,"name":"diplomatic relations","created_at":"2024-08-20T12:00:25Z","updated_at":"2024-08-20T12:00:25Z","counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"name":"diplomatic relations"},{"kind":"label","change_type":"create","id":2016,"new_values":{"id":2016,"project_id":99,"name":"security protocols","created_at":"2024-08-20T12:00:25Z","updated_at":"2024-08-20T12:00:25Z","counts":{"number_of_zero_point_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"sum_of_story_estimates_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"number_of_stories_by_state":{"accepted":0,"started":0,"finished":0,"unstarted":0,"planned":0,"delivered":0,"unscheduled":0,"rejected":0,"kind":"counts_by_story_state"},"kind":"story_counts"}},"name":"security protocol"}],"primary_resources":[{"kind":"label","id":2008,"name":"rebel bases"},{"kind":"label","id":2009,"name":"plans"},{"kind":"label","id":2010,"name":"turning luke"},{"kind":"label","id":2011,"name":"mnt"},{"kind":"label","id":2012,"name":"personnel"},{"kind":"label","id":2013,"name":"fleet ops"},{"kind":"label","id":2014,"name":"r&d"},{"kind":"label","id":2015,"name":"diplomatic relations"},{"kind":"label","id":2016,"name":"security protocol"}],"secondary_resources":[],"project":{"kind":"project","id":99,"name":"Death Star"},"performed_by":{"kind":"person","id":102,"name":"Wilhuff Tarkin","initials":"WT"},"occurred_at":"2024-08-20T12:00:25Z"}]

PARAMETERS

workspace_id

int in the request path.
required — The ID of the workspace.

limit

int[pos] in the request query.
— The number of activity items you want returned.

offset

int[pos] in the request query.
— Index of the first activity item you want, starting from zero.

occurred_before

datetime in the request query.
— Activity will be returned only for operations that occurred before the time specified by this parameter.

occurred_after

datetime in the request query.
— Activity will be returned only for operations that occurred after the time specified by this parameter.

Request Aggregator

ENDPOINT

/aggregator

POST The aggregator allows the client to make a single request that returns the same information as several separate GETs to other endpoints.

The POST body included in an aggregator request is a JSON array of strings, each a relative URL (excludes server, includes query parameters) for a GET request. Response body is a JSON hash with keys equal to the relative URLs and values equal to the matching response bodies.

Story Transitions

ENDPOINT

/projects/{project_id}/story_transitions

GET Returns list of story transitions for the project. (Paginated)

Access to all of the recorded stories' transitions. Tracker currently makes the last six months' worth of data changes available through the story transition endpoints. A story transition is a time-based event describing when a story transitions to a new state. Note some stories may contain multiple transitions to a given state, while others may skip specific states.


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
curl -X GET -H "X-TrackerToken: $TOKEN" "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/story_transitions"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Pagination-Limit: 500
        X-Tracker-Pagination-Offset: 0
        X-Tracker-Pagination-Total: 38
        X-Tracker-Pagination-Returned: 38
        X-Tracker-Project-Version: 66
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           [{"kind":"story_transition","state":"unscheduled","story_id":551,"project_id":99,"project_version":4,"occurred_at":"2024-08-20T12:00:00Z","performed_by_id":100},{"kind":"story_transition","state":"unscheduled","story_id":552,"project_id":99,"project_version":5,"occurred_at":"2024-08-20T12:00:00Z","performed_by_id":100},{"kind":"story_transition","state":"accepted","story_id":553,"project_id":99,"project_version":6,"occurred_at":"2024-08-20T12:00:00Z","performed_by_id":101},{"kind":"story_transition","state":"unscheduled","story_id":554,"project_id":99,"project_version":7,"occurred_at":"2024-08-20T12:00:00Z","performed_by_id":101},{"kind":"story_transition","state":"unscheduled","story_id":555,"project_id":99,"project_version":8,"occurred_at":"2024-08-20T12:00:00Z","performed_by_id":101},{"kind":"story_transition","state":"unscheduled","story_id":556,"project_id":99,"project_version":9,"occurred_at":"2024-08-20T12:00:00Z","performed_by_id":101},{"kind":"story_transition","state":"unscheduled","story_id":557,"project_id":99,"project_version":10,"occurred_at":"2024-08-20T12:00:00Z","performed_by_id":101},{"kind":"story_transition","state":"accepted","story_id":558,"project_id":99,"project_version":11,"occurred_at":"2024-08-20T12:00:00Z","performed_by_id":101},{"kind":"story_transition","state":"unscheduled","story_id":559,"project_id":99,"project_version":12,"occurred_at":"2024-08-20T12:00:00Z","performed_by_id":102},{"kind":"story_transition","state":"unscheduled","story_id":560,"project_id":99,"project_version":13,"occurred_at":"2024-08-20T12:00:00Z","performed_by_id":102},{"kind":"story_transition","state":"unscheduled","story_id":561,"project_id":99,"project_version":14,"occurred_at":"2024-08-20T12:00:00Z","performed_by_id":102},{"kind":"story_transition","state":"unscheduled","story_id":562,"project_id":99,"project_version":15,"occurred_at":"2024-08-20T12:00:00Z","performed_by_id":102},{"kind":"story_transition","state":"unscheduled","story_id":563,"project_id":99,"project_version":16,"occurred_at":"2024-08-20T12:00:00Z","performed_by_id":102},{"kind":"story_transition","state":"unscheduled","story_id":564,"project_id":99,"project_version":17,"occurred_at":"2024-08-20T12:00:00Z","performed_by_id":103},{"kind":"story_transition","state":"unscheduled","story_id":565,"project_id":99,"project_version":18,"occurred_at":"2024-08-20T12:00:00Z","performed_by_id":103},{"kind":"story_transition","state":"unscheduled","story_id":566,"project_id":99,"project_version":19,"occurred_at":"2024-08-20T12:00:00Z","performed_by_id":104},{"kind":"story_transition","state":"unscheduled","story_id":567,"project_id":99,"project_version":20,"occurred_at":"2024-08-20T12:00:00Z","performed_by_id":104},{"kind":"story_transition","state":"started","story_id":554,"project_id":99,"project_version":29,"occurred_at":"2024-08-20T12:00:00Z","performed_by_id":100},{"kind":"story_transition","state":"finished","story_id":554,"project_id":99,"project_version":30,"occurred_at":"2024-08-20T12:00:00Z","performed_by_id":100},{"kind":"story_transition","state":"delivered","story_id":554,"project_id":99,"project_version":31,"occurred_at":"2024-08-20T12:00:00Z","performed_by_id":100},{"kind":"story_transition","state":"started","story_id":563,"project_id":99,"project_version":32,"occurred_at":"2024-08-20T12:00:00Z","performed_by_id":102},{"kind":"story_transition","state":"finished","story_id":563,"project_id":99,"project_version":33,"occurred_at":"2024-08-20T12:00:00Z","performed_by_id":102},{"kind":"story_transition","state":"delivered","story_id":563,"project_id":99,"project_version":34,"occurred_at":"2024-08-20T12:00:00Z","performed_by_id":102},{"kind":"story_transition","state":"accepted","story_id":554,"project_id":99,"project_version":35,"occurred_at":"2024-08-20T12:00:00Z","performed_by_id":100},{"kind":"story_transition","state":"accepted","story_id":563,"project_id":99,"project_version":36,"occurred_at":"2024-08-20T12:00:00Z","performed_by_id":100},{"kind":"story_transition","state":"started","story_id":560,"project_id":99,"project_version":44,"occurred_at":"2024-08-20T12:00:00Z","performed_by_id":102},{"kind":"story_transition","state":"finished","story_id":560,"project_id":99,"project_version":45,"occurred_at":"2024-08-20T12:00:00Z","performed_by_id":102},{"kind":"story_transition","state":"delivered","story_id":560,"project_id":99,"project_version":46,"occurred_at":"2024-08-20T12:00:00Z","performed_by_id":102},{"kind":"story_transition","state":"accepted","story_id":560,"project_id":99,"project_version":47,"occurred_at":"2024-08-20T12:00:00Z","performed_by_id":101},{"kind":"story_transition","state":"started","story_id":556,"project_id":99,"project_version":48,"occurred_at":"2024-08-20T12:00:00Z","performed_by_id":101},{"kind":"story_transition","state":"started","story_id":559,"project_id":99,"project_version":49,"occurred_at":"2024-08-20T12:00:00Z","performed_by_id":102},{"kind":"story_transition","state":"unstarted","story_id":561,"project_id":99,"project_version":50,"occurred_at":"2024-08-20T12:00:00Z","performed_by_id":102},{"kind":"story_transition","state":"unstarted","story_id":566,"project_id":99,"project_version":51,"occurred_at":"2024-08-20T12:00:00Z","performed_by_id":102},{"kind":"story_transition","state":"finished","story_id":559,"project_id":99,"project_version":52,"occurred_at":"2024-08-20T12:00:00Z","performed_by_id":102},{"kind":"story_transition","state":"delivered","story_id":559,"project_id":99,"project_version":53,"occurred_at":"2024-08-20T12:00:00Z","performed_by_id":102},{"kind":"story_transition","state":"rejected","story_id":559,"project_id":99,"project_version":54,"occurred_at":"2024-08-20T12:00:00Z","performed_by_id":101},{"kind":"story_transition","state":"unstarted","story_id":552,"project_id":99,"project_version":55,"occurred_at":"2024-08-20T12:00:00Z","performed_by_id":100},{"kind":"story_transition","state":"unstarted","story_id":555,"project_id":99,"project_version":56,"occurred_at":"2024-08-20T12:00:00Z","performed_by_id":101}]


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
curl -X GET -H "X-TrackerToken: $TOKEN" "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/story_transitions.csv"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        Content-Disposition: attachment; filename="story_transitions.csv"
        Content-Type: text/csv
    

       Response Body
         
           Story ID,State,Occurred at (HST),Project ID,Performed By ID,Project Version
551,unscheduled,8/20/2024 02:00:00,99,100,4
552,unscheduled,8/20/2024 02:00:00,99,100,5
553,accepted,8/20/2024 02:00:00,99,101,6
554,unscheduled,8/20/2024 02:00:00,99,101,7
555,unscheduled,8/20/2024 02:00:00,99,101,8
556,unscheduled,8/20/2024 02:00:00,99,101,9
557,unscheduled,8/20/2024 02:00:00,99,101,10
558,accepted,8/20/2024 02:00:00,99,101,11
559,unscheduled,8/20/2024 02:00:00,99,102,12
560,unscheduled,8/20/2024 02:00:00,99,102,13
561,unscheduled,8/20/2024 02:00:00,99,102,14
562,unscheduled,8/20/2024 02:00:00,99,102,15
563,unscheduled,8/20/2024 02:00:00,99,102,16
564,unscheduled,8/20/2024 02:00:00,99,103,17
565,unscheduled,8/20/2024 02:00:00,99,103,18
566,unscheduled,8/20/2024 02:00:00,99,104,19
567,unscheduled,8/20/2024 02:00:00,99,104,20
554,started,8/20/2024 02:00:00,99,100,29
554,finished,8/20/2024 02:00:00,99,100,30
554,delivered,8/20/2024 02:00:00,99,100,31
563,started,8/20/2024 02:00:00,99,102,32
563,finished,8/20/2024 02:00:00,99,102,33
563,delivered,8/20/2024 02:00:00,99,102,34
554,accepted,8/20/2024 02:00:00,99,100,35
563,accepted,8/20/2024 02:00:00,99,100,36
560,started,8/20/2024 02:00:00,99,102,44
560,finished,8/20/2024 02:00:00,99,102,45
560,delivered,8/20/2024 02:00:00,99,102,46
560,accepted,8/20/2024 02:00:00,99,101,47
556,started,8/20/2024 02:00:00,99,101,48
559,started,8/20/2024 02:00:00,99,102,49
561,unstarted,8/20/2024 02:00:00,99,102,50
566,unstarted,8/20/2024 02:00:00,99,102,51
559,finished,8/20/2024 02:00:00,99,102,52
559,delivered,8/20/2024 02:00:00,99,102,53
559,rejected,8/20/2024 02:00:00,99,101,54
552,unstarted,8/20/2024 02:00:00,99,100,55
555,unstarted,8/20/2024 02:00:00,99,101,56

Successful responses to this request return an array containing zero or more instances of the story_transition resource. The response from this request is paginated, see Paginating List Responses. The response from this request can be encoded in CSV, see CSV Response Format.

PARAMETERS

project_id

int in the request path.
required — The ID of the project.

limit

int[pos] in the request query.
— The number of transition items you want returned.

offset

int[pos] in the request query.
— Index of the first transition item you want, starting from zero.

occurred_after

datetime in the request query.
— Filters to transitions that occurred after but not at the supplied datetime

occurred_before

datetime in the request query.
— Filters to transitions that occurred before but not at the supplied datetime

ENDPOINT

/projects/{project_id}/stories/{story_id}/transitions

GET Returns list of story transitions for the story. (Paginated)

Access to a story's transitions. Tracker currently makes the last six months' worth of data changes available through the story transition endpoints. A story transition is a time-based event describing when a story transitions to a new state. Note some stories may contain multiple transitions to a given state, while others may skip specific states.


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
export STORY_ID=559
curl -X GET -H "X-TrackerToken: $TOKEN" "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/stories/$STORY_ID/transitions"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Pagination-Limit: 100
        X-Tracker-Pagination-Offset: 0
        X-Tracker-Pagination-Total: 5
        X-Tracker-Pagination-Returned: 5
        X-Tracker-Project-Version: 66
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           [{"kind":"story_transition","state":"unscheduled","story_id":559,"project_id":99,"project_version":12,"occurred_at":"2024-08-20T12:00:00Z","performed_by_id":102},{"kind":"story_transition","state":"started","story_id":559,"project_id":99,"project_version":49,"occurred_at":"2024-08-20T12:00:00Z","performed_by_id":102},{"kind":"story_transition","state":"finished","story_id":559,"project_id":99,"project_version":52,"occurred_at":"2024-08-20T12:00:00Z","performed_by_id":102},{"kind":"story_transition","state":"delivered","story_id":559,"project_id":99,"project_version":53,"occurred_at":"2024-08-20T12:00:00Z","performed_by_id":102},{"kind":"story_transition","state":"rejected","story_id":559,"project_id":99,"project_version":54,"occurred_at":"2024-08-20T12:00:00Z","performed_by_id":101}]

PARAMETERS

project_id

int in the request path.
required — The ID of the project.

story_id

int in the request path.
required — The ID of the story.

limit

int[pos] in the request query.
— The number of transition items you want returned.

offset

int[pos] in the request query.
— Index of the first transition item you want, starting from zero.

occurred_after

datetime in the request query.
— Filters to transitions that occurred after but not at the supplied datetime

occurred_before

datetime in the request query.
— Filters to transitions that occurred before but not at the supplied datetime

Project History

ENDPOINT

/projects/{project_id}/history/days

GET Get the daily history of story points and counts by state.

Returns per day information of story points and counts by state. If no start date or end date is provided, the project's most recent history is returned. If only an end date is provided, the start date will be automatically calculated. If provided, start date must be within the last six months for projects that are in an account on any non-Enterprise subscription plan, or may produce no response data if older than the last 25 months for projects in an account on an Enterprise subscription plan. The daily history represents the state of the project's stories at midnight in the project's timezone.


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
curl -X GET -H "X-TrackerToken: $TOKEN" "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/history/days"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 66
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"data":[["2024-08-15",10,10,10,10,10,10,10,10,4,4,6,18,10,16,32,28],["2024-08-16",10,10,10,10,10,10,10,10,4,4,6,18,10,16,32,28],["2024-08-17",10,10,10,10,10,10,10,10,4,4,6,18,10,16,32,28]],"header":["date","points_accepted","points_delivered","points_finished","points_started","points_rejected","points_planned","points_unstarted","points_unscheduled","counts_accepted","counts_delivered","counts_finished","counts_started","counts_rejected","counts_planned","counts_unstarted","counts_unscheduled"],"kind":"daily_history_container"}


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
curl -X GET -H "X-TrackerToken: $TOKEN" "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/history/days.csv"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        Content-Disposition: attachment; filename="days.csv"
        Content-Type: text/csv
    

       Response Body
         
           date (HST),points_accepted,points_delivered,points_finished,points_started,points_rejected,points_planned,points_unstarted,points_unscheduled,counts_accepted,counts_delivered,counts_finished,counts_started,counts_rejected,counts_planned,counts_unstarted,counts_unscheduled
2024-08-14,10,10,10,10,10,10,10,10,4,4,6,18,10,16,32,28
2024-08-15,10,10,10,10,10,10,10,10,4,4,6,18,10,16,32,28
2024-08-16,10,10,10,10,10,10,10,10,4,4,6,18,10,16,32,28


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=101
curl -X GET -H "X-TrackerToken: $TOKEN" "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/history/days?end_date=2024-08-15&start_date=2024-08-10"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 303
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"data":[["2024-08-10",59.0,0.0,0.0,8.0,0.0,0.0,8.0,9.0,26,0,0,3,0,0,7,44],["2024-08-11",59.0,0.0,0.0,8.0,0.0,0.0,8.0,9.0,26,0,0,3,0,0,7,44],["2024-08-12",59.0,0.0,0.0,8.0,0.0,0.0,8.0,9.0,26,0,0,3,0,0,7,43],["2024-08-13",59.0,0.0,0.0,8.0,0.0,0.0,25.0,9.0,26,0,0,3,0,0,12,38],["2024-08-14",59.0,0.0,0.0,8.0,0.0,0.0,25.0,9.0,26,0,0,3,0,0,12,38],["2024-08-15",59.0,0.0,0.0,8.0,0.0,0.0,25.0,9.0,26,0,0,3,0,0,12,38]],"header":["date","points_accepted","points_delivered","points_finished","points_started","points_rejected","points_planned","points_unstarted","points_unscheduled","counts_accepted","counts_delivered","counts_finished","counts_started","counts_rejected","counts_planned","counts_unstarted","counts_unscheduled"],"kind":"daily_history_container"}

Successful responses to this request return the daily_history_container resource. The response from this request can be encoded in CSV, see CSV Response Format.

PARAMETERS

project_id

int in the request path.
required — The ID of the project.

label

extended string in the request query.
— The label to filter on

start_date

date in the request query.
— The first day of daily story history to return

end_date

date in the request query.
— The last day of daily story history to return

ENDPOINT

/projects/{project_id}/history/snapshots

GET Returns a list of project snapshots. By default, data for the last 7 days is returned.

Provides per day information about story state, estimate and position in current, backlog, and the icebox. If either the start or end dates are omitted, they will be automatically calculated. If provided, start date must be within the last six months for projects that are in an account on any non-Enterprise subscription plan, or may produce no response data if older than the last 25 months for projects in an account on an Enterprise subscription plan.


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
curl -X GET -H "X-TrackerToken: $TOKEN" "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/history/snapshots"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 66
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           [{"kind":"project_snapshot","date":"2024-08-18","current":[{"kind":"story_snapshot","story_id":555,"state":"unstarted","estimate":1,"story_type":"feature"},{"kind":"story_snapshot","story_id":556,"state":"unstarted","estimate":2,"story_type":"feature"},{"kind":"story_snapshot","story_id":557,"state":"started","estimate":3,"story_type":"feature"},{"kind":"story_snapshot","story_id":558,"state":"started","estimate":5,"story_type":"feature"},{"kind":"story_snapshot","story_id":559,"state":"unstarted","estimate":0,"story_type":"bug"},{"kind":"story_snapshot","story_id":560,"state":"unstarted","estimate":0,"story_type":"bug"},{"kind":"story_snapshot","story_id":561,"state":"started","estimate":0,"story_type":"bug"},{"kind":"story_snapshot","story_id":562,"state":"started","estimate":0,"story_type":"bug"}]},{"kind":"project_snapshot","date":"2024-08-19","current":[{"kind":"story_snapshot","story_id":555,"state":"started","estimate":1,"story_type":"feature"},{"kind":"story_snapshot","story_id":556,"state":"started","estimate":2,"story_type":"feature"},{"kind":"story_snapshot","story_id":557,"state":"rejected","estimate":3,"story_type":"feature"},{"kind":"story_snapshot","story_id":559,"state":"started","estimate":0,"story_type":"bug"},{"kind":"story_snapshot","story_id":560,"state":"started","estimate":0,"story_type":"bug"}]},{"kind":"project_snapshot","date":"2024-08-20","current":[{"kind":"story_snapshot","story_id":558,"state":"accepted","story_accepted_at":"2024-08-20T12:00:00Z","estimate":1,"story_type":"feature"},{"kind":"story_snapshot","story_id":560,"state":"accepted","story_accepted_at":"2024-08-20T12:00:00Z","estimate":1,"story_type":"feature"},{"kind":"story_snapshot","story_id":556,"state":"started","estimate":2,"story_type":"feature"},{"kind":"story_snapshot","story_id":559,"state":"rejected","estimate":3,"story_type":"feature"}]}]


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
curl -X GET -H "X-TrackerToken: $TOKEN" "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/history/snapshots.csv?end_date=2024-08-20&start_date=2024-08-20"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        Content-Disposition: attachment; filename="iteration_stories_report_AUG20_AUG20.csv"
        Content-Type: text/csv
    

       Response Body
         
           Taken On,State,Accepted at (PDT),Type,Estimate,Title,ID,Labels,Owned By,Owned By
8/20/2024,accepted,8/20/2024 05:00:00,feature,1,Contact Lando,558,"mnt,plans",Darth Vader,Moradmin Bast
8/20/2024,accepted,8/20/2024 05:00:00,feature,1,Destroy Alderaan,560,rebel bases,Darth Vader,Robotic Maintenance Team 4
8/20/2024,started,,feature,2,Interrogate Leia Organa,556,"plans,rebel bases",Darth Vader,Robotic Maintenance Team 4
8/20/2024,rejected,,feature,3,All exhaust ports should be shielded,559,plans,Clone TK421,

Successful responses to this request return an array containing zero or more instances of the project_snapshot resource. The response from this request can be encoded in CSV, see CSV Response Format.

PARAMETERS

project_id

int in the request path.
required — The ID of the project.

start_date

date in the request query.
— The first day of daily story history to return

end_date

date in the request query.
— The last day of daily story history to return

done_accepted_before

datetime in the request query.
— A date and time (ISO 8601 format or milliseconds) which all returned stories in the done group are accepted before.

done_accepted_after

datetime in the request query.
— A date and time (ISO 8601 format or milliseconds) which all returned stories in the done group are accepted after.

label

extended string in the request query.
— The label to filter on

ENDPOINT

/projects/{project_id}/history/releases/{id}/days

GET Get the release's daily history of story points and counts by state.

Returns per day information of story points and counts by state for the given release. To find releases in your project, use the stories endpoint. Filter your search for unstarted releases by using the with_story_type=release and with_state=unstarted parameters. If provided, start date must be within the last six months.


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=101
export RELEASE_ID=2128
curl -X GET -H "X-TrackerToken: $TOKEN" "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/history/releases/$RELEASE_ID/days"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 303
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"data":[["2024-06-15",0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,1,0,0,1,0,0,0,0],["2024-06-16",0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,1,0,0,1,0,0,0,0],["2024-06-17",0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,1,0,0,1,0,0,0,0],["2024-06-18",0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,1,0,0,1,0,0,0,0],["2024-06-19",0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,2,0,0,1,0,0,0,0],["2024-06-20",0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,2,0,0,1,0,0,0,0],["2024-06-21",0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,2,0,0,1,0,0,0,0],["2024-06-22",0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,2,0,0,1,0,0,0,0],["2024-06-23",0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,1,0,0,1,0,0,0,0],["2024-06-24",0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,2,0,0,0,0,0,0,0],["2024-06-25",0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,2,0,0,0,0,0,0,0]],"header":["date","points_accepted","points_delivered","points_finished","points_started","points_rejected","points_planned","points_unstarted","points_unscheduled","counts_accepted","counts_delivered","counts_finished","counts_started","counts_rejected","counts_planned","counts_unstarted","counts_unscheduled"],"kind":"daily_history_container"}

Successful responses to this request return the daily_history_container resource. The response from this request can be encoded in CSV, see CSV Response Format.

PARAMETERS

project_id

int in the request path.
required — The ID of the project.

int in the request path.
required — The ID of the release.

label

extended string in the request query.
— The label to filter on

ENDPOINT

/projects/{project_id}/history/iterations/{iteration_number}/days

GET Get the iteration's daily history of story points and counts by state.

Returns per day information of story points and counts by state for the given iteration. If provided, start date must be within the last six months for projects that are in an account on any non-Enterprise subscription plan, or may produce no response data if older than the last 25 months for projects in an account on an Enterprise subscription plan.


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=101
export ITERATION_ID=2
curl -X GET -H "X-TrackerToken: $TOKEN" "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/history/iterations/$ITERATION_ID/days"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 303
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"data":[["2024-06-22",0.0,0.0,0.0,7.0,0.0,0.0,3.0,0.0,0,0,0,6,0,0,3,0],["2024-06-23",0.0,0.0,0.0,10.0,0.0,0.0,0.0,0.0,1,0,0,6,0,0,2,0],["2024-06-24",0.0,0.0,0.0,10.0,0.0,0.0,0.0,0.0,2,0,0,5,0,0,2,0],["2024-06-25",0.0,2.0,2.0,15.0,0.0,0.0,0.0,0.0,3,1,1,5,0,0,1,0],["2024-06-26",4.0,0.0,4.0,17.0,0.0,0.0,0.0,0.0,6,0,2,5,0,0,0,0],["2024-06-27",4.0,0.0,4.0,17.0,0.0,0.0,0.0,0.0,6,0,2,5,0,0,0,0],["2024-06-28",4.0,0.0,4.0,17.0,0.0,0.0,0.0,0.0,6,0,2,5,0,0,0,0]],"header":["date","points_accepted","points_delivered","points_finished","points_started","points_rejected","points_planned","points_unstarted","points_unscheduled","counts_accepted","counts_delivered","counts_finished","counts_started","counts_rejected","counts_planned","counts_unstarted","counts_unscheduled"],"kind":"daily_history_container"}


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=101
export ITERATION_ID=3
curl -X GET -H "X-TrackerToken: $TOKEN" "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/history/iterations/$ITERATION_ID/days?label=strategy"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 303
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"data":[["2024-06-29",1.0,0.0,0.0,6.0,0.0,0.0,0.0,0.0,1,0,0,2,0,0,0,0],["2024-06-30",1.0,0.0,3.0,5.0,3.0,0.0,0.0,0.0,1,0,1,1,1,0,0,0],["2024-07-01",1.0,0.0,3.0,5.0,3.0,0.0,0.0,0.0,1,0,1,1,1,0,0,0],["2024-07-02",1.0,0.0,3.0,5.0,3.0,0.0,0.0,0.0,1,0,1,1,1,0,0,0],["2024-07-03",1.0,6.0,0.0,7.0,0.0,0.0,0.0,0.0,1,2,0,2,0,0,0,0],["2024-07-04",1.0,6.0,0.0,7.0,0.0,0.0,0.0,0.0,1,2,0,2,0,0,0,0],["2024-07-05",1.0,6.0,0.0,7.0,0.0,0.0,0.0,0.0,1,2,0,2,0,0,0,0],["2024-07-06",7.0,0.0,0.0,7.0,0.0,0.0,0.0,0.0,3,0,0,2,0,0,0,0],["2024-07-07",7.0,0.0,0.0,7.0,0.0,0.0,0.0,0.0,3,0,0,2,0,0,0,0],["2024-07-08",7.0,0.0,0.0,7.0,0.0,0.0,0.0,0.0,3,0,0,2,0,0,0,0],["2024-07-09",7.0,0.0,0.0,7.0,0.0,0.0,0.0,0.0,3,0,0,2,0,0,0,0],["2024-07-10",7.0,0.0,0.0,7.0,0.0,0.0,0.0,0.0,3,0,0,2,0,0,0,0],["2024-07-11",7.0,0.0,0.0,7.0,0.0,0.0,0.0,0.0,3,0,0,2,0,0,0,0],["2024-07-12",7.0,0.0,0.0,7.0,0.0,0.0,0.0,0.0,3,0,0,2,0,0,0,0]],"header":["date","points_accepted","points_delivered","points_finished","points_started","points_rejected","points_planned","points_unstarted","points_unscheduled","counts_accepted","counts_delivered","counts_finished","counts_started","counts_rejected","counts_planned","counts_unstarted","counts_unscheduled"],"kind":"daily_history_container"}

Successful responses to this request return the daily_history_container resource. The response from this request can be encoded in CSV, see CSV Response Format.

PARAMETERS

project_id

int in the request path.
required — The ID of the project.

iteration_number

int in the request path.
required — The iteration number.

label

extended string in the request query.
— The label to filter on

Reviews

ENDPOINT

/projects/{project_id}/stories/{story_id}/reviews

GET Returns a list of all reviews on a story.
POST Returns the review that was created.

Operations on a story's reviews


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
export STORY_ID=555
curl -X GET -H "X-TrackerToken: $TOKEN" "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/stories/$STORY_ID/reviews"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 66
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           [{"kind":"review","id":5100,"story_id":555,"review_type_id":147,"status":"unstarted","created_at":"2024-08-20T12:00:00Z","updated_at":"2024-08-20T12:00:00Z"}]

Successful responses to this request return an array containing zero or more instances of the review resource.

PARAMETERS

project_id

int in the request path.
required — The ID of the project.

story_id

int in the request path.
required — The ID of the story.


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
export STORY_ID=555
curl -X POST -H "X-TrackerToken: $TOKEN" -H "Content-Type: application/json" -d '{"review_type_id":147}' "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/stories/$STORY_ID/reviews"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 67
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"created_at":"2024-08-20T12:00:00Z","id":5101,"kind":"review","review_type_id":147,"status":"unstarted","story_id":555,"updated_at":"2024-08-20T12:00:00Z"}


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
export STORY_ID=555
curl -X POST -H "X-TrackerToken: $TOKEN" -H "Content-Type: application/json" -d '{"review_type_id":147,"status":"in_review"}' "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/stories/$STORY_ID/reviews"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 67
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"created_at":"2024-08-20T12:00:00Z","id":5101,"kind":"review","review_type_id":147,"status":"in_review","story_id":555,"updated_at":"2024-08-20T12:00:00Z"}


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
export STORY_ID=555
curl -X POST -H "X-TrackerToken: $TOKEN" -H "Content-Type: application/json" -d '{"review_type_id":147,"reviewer_id":100}' "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/stories/$STORY_ID/reviews"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 67
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"created_at":"2024-08-20T12:00:00Z","id":5101,"kind":"review","review_type_id":147,"reviewer_id":100,"status":"unstarted","story_id":555,"updated_at":"2024-08-20T12:00:00Z"}

Successful responses to this request return the review resource.

PARAMETERS

project_id

int in the request path.
required — The ID of the project.

story_id

int in the request path.
required — The ID of the story.

review_type_id

int in the request body.
— ID of the the review type assigned to this review.

reviewer_id

int in the request body.
— id of the person is responsible for this review.

status

enumerated string in the request body.
— Current status of the review.

Valid enumeration values: unstarted, in_review, pass, revise

ENDPOINT

/projects/{project_id}/stories/{story_id}/reviews/{review_id}

GET Returns the specified review on a specified story
PUT Updates the specified review
DELETE Deletes the specified review

Operations on a review


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
export STORY_ID=555
curl -X GET -H "X-TrackerToken: $TOKEN" "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/stories/$STORY_ID/reviews/5100"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 66
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"created_at":"2024-08-20T12:00:00Z","id":5100,"kind":"review","review_type_id":147,"status":"unstarted","story_id":555,"updated_at":"2024-08-20T12:00:00Z"}


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
export STORY_ID=555
curl -X GET -H "X-TrackerToken: $TOKEN" "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/stories/$STORY_ID/reviews/5100?fields=review_type_id%2Cstatus"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 66
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"id":5100,"review_type_id":147,"status":"unstarted"}

Successful responses to this request return the review resource.

PARAMETERS

project_id

int in the request path.
required — The ID of the project.

story_id

int in the request path.
required — The ID of the story.

review_id

int in the request path.
required — The ID of the review.


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
export STORY_ID=555
curl -X PUT -H "X-TrackerToken: $TOKEN" -H "Content-Type: application/json" -d '{"review_type_id":148}' "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/stories/$STORY_ID/reviews/5100"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 67
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"created_at":"2024-08-20T12:00:00Z","id":5100,"kind":"review","review_type_id":148,"status":"unstarted","story_id":555,"updated_at":"2024-08-20T12:00:00Z"}

Successful responses to this request return the review resource.

PARAMETERS

project_id

int in the request path.
required — The ID of the project.

story_id

int in the request path.
required — The ID of the story.

review_id

int in the request path.
required — The ID of the review.

review_type_id

int in the request body.
— ID of the the review type assigned to this review.

reviewer_id

int in the request body.
— id of the person is responsible for this review.

status

enumerated string in the request body.
— Current status of the review.

Valid enumeration values: unstarted, in_review, pass, revise


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
export STORY_ID=555
curl -X DELETE -H "X-TrackerToken: $TOKEN" -H "Content-Type: application/json" "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/stories/$STORY_ID/reviews/5100"



  
    View Response
  

  
    Hide Response

    
      status: 204
    

    
      Headers
        X-Tracker-Project-Version: 67
        Content-Type: application/json; potentially-other-variable-stuff

PARAMETERS

project_id

int in the request path.
required — The ID of the project.

story_id

int in the request path.
required — The ID of the story.

review_id

int in the request path.
required — The ID of the review.

Blockers

ENDPOINT

/projects/{project_id}/stories/{story_id}/blockers

GET Returns a list of all blockers on a story.
POST Returns the blocker that was created.

Operations on a story's blockers


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
export STORY_ID=555
curl -X GET -H "X-TrackerToken: $TOKEN" "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/stories/$STORY_ID/blockers"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 66
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           [{"kind":"blocker","id":1100,"story_id":555,"person_id":101,"description":"Set weapons to stun","resolved":false,"created_at":"2024-08-20T12:00:00Z","updated_at":"2024-08-20T12:00:00Z"}]

Successful responses to this request return an array containing zero or more instances of the blocker resource.

PARAMETERS

project_id

int in the request path.
required — The ID of the project.

story_id

int in the request path.
required — The ID of the story.


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
export STORY_ID=555
curl -X POST -H "X-TrackerToken: $TOKEN" -H "Content-Type: application/json" -d '{"description":"Waiting on transport shuttle to arrive.","person_id":101,"resolved":true}' "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/stories/$STORY_ID/blockers"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 67
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"created_at":"2024-08-20T12:00:00Z","description":"Waiting on transport shuttle to arrive.","id":1101,"kind":"blocker","person_id":101,"resolved":true,"story_id":555,"updated_at":"2024-08-20T12:00:00Z"}

Successful responses to this request return the blocker resource.

PARAMETERS

project_id

int in the request path.
required — The ID of the project.

story_id

int in the request path.
required — The ID of the story.

person_id

int in the request body.
— The id of the blocker creator.

description

extended string[1000] in the request body.
required — Content of the blocker.

resolved

boolean in the request body.
— Flag showing whether the blocker is resolved or not.

ENDPOINT

/projects/{project_id}/stories/{story_id}/blockers/{blocker_id}

GET Returns the specified blocker on a specified story
PUT Updates the specified blocker
DELETE Deletes the specified blocker

Operations on a blocker


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
export STORY_ID=555
curl -X GET -H "X-TrackerToken: $TOKEN" "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/stories/$STORY_ID/blockers/1100"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 66
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"created_at":"2024-08-20T12:00:00Z","description":"Set weapons to stun","id":1100,"kind":"blocker","person_id":101,"resolved":false,"story_id":555,"updated_at":"2024-08-20T12:00:00Z"}


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
export STORY_ID=555
curl -X GET -H "X-TrackerToken: $TOKEN" "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/stories/$STORY_ID/blockers/1100?fields=description%2Cresolved"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 66
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"description":"Set weapons to stun","id":1100,"resolved":false}

Successful responses to this request return the blocker resource.

PARAMETERS

project_id

int in the request path.
required — The ID of the project.

story_id

int in the request path.
required — The ID of the story.

blocker_id

int in the request path.
required — The ID of the blocker.


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
export STORY_ID=555
curl -X PUT -H "X-TrackerToken: $TOKEN" -H "Content-Type: application/json" -d '{"description":"Transport shuttle crashed on Endor."}' "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/stories/$STORY_ID/blockers/1100"



  
    View Response
  

  
    Hide Response

    
      status: 200
    

    
      Headers
        X-Tracker-Project-Version: 67
        Content-Type: application/json; potentially-other-variable-stuff
    

       Response Body
         
           {"created_at":"2024-08-20T12:00:00Z","description":"Transport shuttle crashed on Endor.","id":1100,"kind":"blocker","person_id":101,"resolved":false,"story_id":555,"updated_at":"2024-08-20T12:00:00Z"}

Successful responses to this request return the blocker resource.

PARAMETERS

project_id

int in the request path.
required — The ID of the project.

story_id

int in the request path.
required — The ID of the story.

blocker_id

int in the request path.
required — The ID of the blocker.

description

extended string[1000] in the request body.
— Content of the blocker.

resolved

boolean in the request body.
— Flag showing whether the blocker is resolved or not.


export TOKEN='your Pivotal Tracker API token'
export PROJECT_ID=99
export STORY_ID=555
curl -X DELETE -H "X-TrackerToken: $TOKEN" -H "Content-Type: application/json" "https://www.pivotaltracker.com/services/v5/projects/$PROJECT_ID/stories/$STORY_ID/blockers/1100"



  
    View Response
  

  
    Hide Response

    
      status: 204
    

    
      Headers
        X-Tracker-Project-Version: 67
        Content-Type: application/json; potentially-other-variable-stuff

PARAMETERS

project_id

int in the request path.
required — The ID of the project.

story_id

int in the request path.
required — The ID of the story.

blocker_id

int in the request path.
required — The ID of the blocker.

Two Factor Authentication

ENDPOINT

/two_factor_auth/authenticate

POST Authenticates user based on time based OTP if 2FA is enabled for the user

Two Factor Authentication API

Successful responses to this request return the me resource.

PARAMETERS

totp

string in the request query.
— Time based OTP

Resources

resource

account

PROPERTIES

int
— Database id of the account. This field is read only.

name

string[100]
— The name of the account.

plan

string
— The name of the account's current subscription plan. This field is read only.

status

enumerated string
— This string gives the subscription status of the account that contains the project. In particular, conditions that can cause the project to be read-only will be included here. This field is read only.

Valid enumeration values: active, suspended, delinquent, deleted, limited

days_left

int
— The number of days remaining in the account's Free Trial period, or 0 if it has expired. This field is read only.

over_the_limit

boolean
— True if the account is currently over its subscription plan limits. This field is read only.

created_at

datetime
— Creation time. This field is read only.

updated_at

datetime
— Time of last update. This field is read only.

project_ids

List[int]
— IDs of the project(s) that are associated with the account. This field is read only. This field is excluded by default. To include this field by using the fields parameter, see Response Customization. In API responses, this attribute may be project_ids or projects.

kind

string
— The type of this object: account. This field is read only.

resource

account_membership

PROPERTIES

int
— The id of the membership. This field is read only. This field is always returned.

person_id

int
— The id of the user. This field is writable only on create. By default this will be included in responses as a nested structure, using the key person. In API responses, this attribute may be person_id or person.

account_id

int
— The id of the account. This field is writable only on create.

created_at

datetime
— Creation time. This field is writable only on create.

updated_at

datetime
— Time of last update. This field is read only.

owner

boolean
— True if the person is the current Owner of the acount. The account Owner can be selected only through the Tracker web site and this parameter will be ignored if sent through the API. This field is read only.

admin

boolean
— True if the person has administrative rights on the account.

project_creator

boolean
— True if the person is allowed to create new projects within the account.

kind

string
— The type of this object: account_membership. This field is read only.

resource

account_summary

PROPERTIES

int
— Database id of the account. This field is read only. This field is always returned.

name

string[100]
— The name of the account.

status

Valid enumeration values: active, suspended, delinquent, deleted, limited

days_left

int
— The number of days remaining in the account's Free Trial period, or 0 if it has expired. This field is read only.

over_the_limit

boolean
— True if the account is currently over its subscription plan limits. This field is read only.

owner_id

int
— The ID of the account owner. This field is read only. This field is excluded by default. To include this field by using the fields parameter, see Response Customization. In API responses, this attribute may be owner_id or owner.

admin_ids

List[int]
— IDs of the account admins. This field is read only. This field is excluded by default. To include this field by using the fields parameter, see Response Customization. In API responses, this attribute may be admin_ids or admins.

permissions

enumerated string
— An enumerated list of the permissions that the requester has on the account. If the requestor is an implicit account member, their permissions will be 'none'. This field is read only. This field is excluded by default. To include this field by using the fields parameter, see Response Customization.

Valid enumeration values: none, project_creation, administration

number_of_projects

int
— The number of active projects, public and private, on the account. This field is read only. This field is excluded by default. To include this field by using the fields parameter, see Response Customization.

number_of_private_projects

int
— The number of active private projects on the account. This field is read only. This field is excluded by default. To include this field by using the fields parameter, see Response Customization.

project_limit

int
— The maximum number of projects allowed on the account. If the account's plan is has unlimited projects, nothing will be returned. This field is read only. This field is excluded by default. To include this field by using the fields parameter, see Response Customization.

is_enterprise_guest

boolean
— True if the member is a guest on this enterprise account. This field is read only. This field is excluded by default. To include this field by using the fields parameter, see Response Customization.

plan

string
— The name of the account's current subscription plan. This field is read only.

kind

string
— The type of this object: account_summary. This field is read only.

resource

activity

PROPERTIES

kind

string
— The value of 'kind' will reflect the specific type of activity that an activity resource represents. The value will be a string that ends in '_activity' and which starts with a name based on the change which occurred. This field is read only.

guid

string
— Project id and version of the activity. This field is read only. This field is always returned.

project_version

int
— The version of the activity. This field is read only. This field is always returned.

message

string
— Description of the activity. This field is read only.

highlight

string
— Boldface portion of the message. This field is read only.

changes

List[object]
— The set of changes. This field is read only.

primary_resources

List[object]
— The primary resource(s) affected by this command. This field is read only.

secondary_resources

List[secondary_resource]
— The secondary resource(s) affected by this command. This field is read only.

project_id

int
— id of the project. This field is read only. By default this will be included in responses as a nested structure, using the key project.

performed_by_id

int
— id of the person who performed this change. This field is read only. By default this will be included in responses as a nested structure, using the key performed_by.

occurred_at

datetime
— Time of the activity. This field is read only.

resource

analytics

PROPERTIES

stories_accepted

int
— Number of stories accepted during this iteration. This field is read only.

bugs_created

int
— Number of new bugs created. This field is read only.

cycle_time

int
— Median cycle time in milliseconds for contained stories. This field is read only.

rejection_rate

float
— Percentage of accepted bugs and features in the iteration that have ever been rejected. This field is read only.

kind

string
— The type of this object: analytics. This field is read only.

resource

attachment

This can be one of the following types: file_attachment or google_attachment

resource

blocker

PROPERTIES

int
— Database id of the blocker. This field is read only. This field is always returned.

story_id

int
— The id of the story to which the blocker is connected. This field is read only.

person_id

int
— The id of the blocker creator. This field is writable only on create. In API responses, this attribute may be person_id or person.

description

extended string[1000]
required on create — Content of the blocker. This field is required on create.

resolved

boolean
— Flag showing whether the blocker is resolved or not.

created_at

datetime
— Creation time. This field is read only.

updated_at

datetime
— Time of last update. This field is read only.

kind

string
— The type of this object: blocker. This field is read only.

resource

branch

PROPERTIES

int
— Database id of the branch. This field is read only. This field is always returned.

story_id

int
— The id of the story to which the branch is connected. This field is read only.

epic_id

int
— The id of the epic to which the branch is connected. This field is read only.

owner

string
required on create — GitHub owner of the branch. This field is required on create.

repo

string
required on create — GitHub repo of the branch. This field is required on create.

name

extended string[255]
required on create — GitHub name of the branch. This field is required on create.

host_url

string
required on create — URL for GitHub instance the branch belong to. This field is required on create.

original_url

string
required on create — Original full branch url. This field is required on create.

created_at

datetime
— Creation time. This field is read only.

updated_at

datetime
— Time of last update. This field is read only.

kind

string
— The type of this object: branch. This field is read only.

resource

bugzilla_integration

PROPERTIES

api_username

string
— The username to use to access Bugzilla.

api_password

string
— The password to use to access Bugzilla. This field is write only.

product

string
— The name of your Bugzilla Product. Use this in conjunction with the component to narrow the bugs to be imported.

component

string
— The name of your Bugzilla Component. Use this in conjunction with product to narrow the bugs to be imported.

statuses_to_exclude

string
— A comma separated list of status names that should be excluded from the imported bugs. If left blank, all bugs will be imported.

comments_private

boolean
— If enabled, comments will be marked as private. Note: the user that is used for the integration must be a member of an 'insidergroup' for this to work.

update_comments

boolean
— If enabled, comments created in Tracker will be added to the linked Bugzilla bug.

update_state

boolean
— Adds a state change comment to the Bugzilla bug.

int
— Database id of the integration. This field is read only. This field is always returned.

project_id

int
— id of the project. This field is read only.

can_import

boolean
— true if it's possible to import stories via this integration. This field is read only.

base_url

string
— url used for outgoing web links in stories imported via this integration.

is_other

boolean
— whether the integration is of type 'other'. This field is read only.

story_name

string
— The name of things imported via the integration. This field is read only.

name

string[40]
— The name given to the particular external integration in the Project Settings pages.

active

boolean
— True if the integration is currently enabled for use.

created_at

datetime
— Creation time. This field is read only.

updated_at

datetime
— Time of last update. This field is read only.

kind

string
— The type of this object: bugzilla_integration. This field is read only.

resource

comment

PROPERTIES

int
— Database id of the comment. This field is read only. This field is always returned.

story_id

int
— The id of the story to which the comment is attached (will be absent if comment attached to an epic. This field is read only.

epic_id

int
— The id of the epic to which the comment is attached (will be absent if comment attached to a story. This field is read only.

text

extended string[20000]
— Content of the comment.

person_id

int
— The id of the comment creator. This field is writable only on create. In API responses, this attribute may be person_id or person.

created_at

datetime
— Creation time. This field is read only.

updated_at

datetime
— Updated time. (Comments are updated by adding attachments, removing attachments, or changing their text.) This field is read only.

file_attachment_ids

List[int]
— IDs of any file attachments associated with the comment. This field is writable only on create. This field is excluded by default. To include this field by using the fields parameter, see Response Customization. In API responses, this attribute may be file_attachment_ids or file_attachments.

google_attachment_ids

List[int]
— IDs of any google attachments associated with the comment. This field is writable only on create. This field is excluded by default. To include this field by using the fields parameter, see Response Customization. In API responses, this attribute may be google_attachment_ids or google_attachments.

attachment_ids

List[identity_object]
— IDs of any attachments associated with the comment. This field is writable only on create. This field is excluded by default. To include this field by using the fields parameter, see Response Customization. In API responses, this attribute may be attachment_ids or attachments.

commit_identifier

string[255]
— Commit Id on the remote source control system for the comment. Present only on comments that were created by a POST to the source commits API endpoint. This field is writable only on create. (Note that this attribute does not indicate an association to another resource.)

commit_type

string[255]
— String identifying the type of remote source control system if Pivotal Tracker can determine it. Present only on comments that were created by a POST to the source commits API endpoint. This field is writable only on create.

external_source

string[255]
— String identifying, in case these comment has been cloned from another platform(eg. jira). This field is writable only on create. This field is always returned.

external_author

string[255]
— Original author name at the source platform. This field is writable only on create. This field is always returned.

external_link

string[255]
— Link of the actual comment at source platform. This field is writable only on create. This field is always returned.

kind

string
— The type of this object: comment. This field is read only.

resource

concourse_pipeline_generic_integration_object

PROPERTIES

int
— TThe id of the integration.

name

string[64]
— The name of the integration.

project_id

int
— id of the project.

url

string[255]
— The job URL.

uuid

string
— The UUID of the integration.

environment

string
— The pipeline environment for this integration. This field is read only.

git_resource_name

string[64]
— The name of the resource that points to your git repository.

integration_type

string
— The type of the integration.

created_at

string
— Creation time.

updated_at

string
— Updation time.

kind

string
— The type of this object: concourse_pipeline_generic_integration_object. This field is read only.

resource

counts_by_story_state

PROPERTIES

delivered

int
— The count for delivered stories in the epic/label.

unscheduled

int
— The count for unscheduled stories in the epic/label.

rejected

int
— The count for rejected stories in the epic/label.

finished

int
— The count for finished stories in the epic/label.

unstarted

int
— The count for unstarted stories in the epic/label.

planned

int
— The count for planned stories in the epic/label.

accepted

int
— The count for accepted stories (in the Current iteration) in the epic/label.

started

int
— The count for started stories in the epic/label.

kind

string
— The type of this object: counts_by_story_state. This field is read only.

resource

cycle_time_details

PROPERTIES

total_cycle_time

int
— The total amount of time, in milliseconds, between when the story was first started to when it was last accepted, excluding weekends. In the case where a story has not been accepted, it is the time between when the story was first started to the current time. If the story has not been started, this property is not returned. This field is read only.

started_time

int
— The total amount of time, in milliseconds, that the story was in the started state, excluding weekends. This field is read only.

started_count

int
— The number of times that the story has been in the started state. This field is read only.

finished_time

int
— The total amount of time, in milliseconds, that the story was in the finished state, excluding weekends. This field is read only.

finished_count

int
— The number of times that the story has been in the finished state. This field is read only.

delivered_time

int
— The total amount of time, in milliseconds, that the story was in the delivered state, excluding weekends. This field is read only.

delivered_count

int
— The number of times that the story has been in the delivered state. This field is read only.

rejected_time

int
— The total amount of time, in milliseconds, that the story was in the rejected state, excluding weekends. This field is read only.

rejected_count

int
— The number of times that the story has been in the rejected state. This field is read only.

story_id

int
— The id of the associated story. This field is read only.

kind

string
— The type of this object: cycle_time_details. This field is read only.

resource

daily_history_container

PROPERTIES

header

List[string]
— Contains a list of names for the data elements in each sub-array within the 'data' property array-of-arrays. In most uses, the first entry will be "date", indicating that the first entry of each row (sub-array) in 'data' is a date (a string in ISO-8601 format). Subsequent entries will identify the data type of the row entry that matches its position. The entry names may be the names of attributes of other API resources, indicating that the matching values will always be legal values for that particular attribute. They can also be composite names, made up of multiple attribute names or values, separated by underscores.

For example, when retrieving information about the stories accepted in an iteration from the projects/##/iterations endpoint, there are header values like "points_accepted" or "accepted_count". These indicate that the matching values relate to "accepted" stories. "accepted" is one of the possible values in a story's 'current_state' attribute, while "points" and "count" are specific to the endpoint. These names indicate that the matching value is either a count of stories or the sum of the points for the particular stories.

The possible values for column headers are determined as the cross-product of all the data sets which an individual API request is to return. For example, when retrieving all of the counts of stories and point count sums for stories where the stories are broken down by their 'current_state', there are 16 possible data column headers (two types of values, counts and points, times eight possible 'current_state' values).

NOTE: Tracker may omit columns from the response if all of the contained values are 0. A client should make no assumptions about the order of columns or about the order of underscore-separated keywords in the data column headers. The one exception is the division between header entries that identify columns whose values are label data (that come first), and header entries that identify columns whose values are data (that come last) In a data column header, "points_accepted" and "accepted_points" are synonyms.

data

List[List[scalar]]
— An array of arrays. The individual sub-arrays correspond to rows of data points, all of which share the same context/scope, indicated by the initial column(s) of the row. The overall array contains all of the rows appropriate for the request which generated the 'daily_history_container'. NOTE: Tracker may omit rows where all the contained values are 0. It is also possible, depending on the endpoint, that no data is available to generate a particular row, in which case it will also be omitted. There is no guaranteed sort order to the row sub-arrays. It is the client's responsibility to order/group rows in whatever way is appropriate to their use.

kind

string
— The type of this object: daily_history_container. This field is read only.

resource

epic

PROPERTIES

int
— Database id of the epic. This field is read only. This field is always returned.

project_id

int
— id of the project.

name

extended string[5000]
required on create — Name of the epic. This field is required on create.

label_id

int
— id of the epic's label. By default this will be included in responses as a nested structure, using the key label. In API responses, this attribute may be label_id or label.

description

extended string[20000]
— In-depth explanation of the epic's goals, scope, etc.

comment_ids

List[int]
— IDs of comments currently on the epic. This field is writable only on create. This field is excluded by default. To include this field by using the fields parameter, see Response Customization. In API responses, this attribute may be comment_ids or comments.

pull_request_ids

List[int]
— IDs of pull requests currently on the epic. This field is writable only on create. This field is excluded by default. To include this field by using the fields parameter, see Response Customization. In API responses, this attribute may be pull_request_ids or pull_requests.

branch_ids

List[int]
— IDs of branches currently on the epic. This field is writable only on create. This field is excluded by default. To include this field by using the fields parameter, see Response Customization. In API responses, this attribute may be branch_ids or branches.

follower_ids

List[int]
— IDs of people currently following the story. This field is excluded by default. To include this field by using the fields parameter, see Response Customization. In API responses, this attribute may be follower_ids or followers.

created_at

datetime
— Creation time. This field is read only.

updated_at

datetime
— Time of last update. This field is read only.

after_id

int
— id of the epic preceding the epic. This field is excluded by default. To include this field by using the fields parameter, see Response Customization.

before_id

int
— id of the epic following the epic. This field is excluded by default. To include this field by using the fields parameter, see Response Customization.

past_done_story_estimates

float
— total point values of the past_done stories. This field is read only. This field is excluded by default. To include this field by using the fields parameter, see Response Customization.

past_done_stories_count

int
— number of past_done stories. This field is read only. This field is excluded by default. To include this field by using the fields parameter, see Response Customization.

past_done_stories_no_point_count

int
— number of past_done stories without estimates. This field is read only. This field is excluded by default. To include this field by using the fields parameter, see Response Customization.

url

string
— The url for this epic in Tracker. This field is read only.

completed_at

datetime
— The date and time of the Epic's completion. This field is read only. This field is excluded by default. To include this field by using the fields parameter, see Response Customization.

projected_completion

datetime
— The date and time of the Epic's projected completion. This field is read only. This field is excluded by default. To include this field by using the fields parameter, see Response Customization.

kind

string
— The type of this object: epic. This field is read only.

resource

epics_search_result

PROPERTIES

epics

List[epic]
— Array of epics which matched the search criteria.

total_hits

int
— Number of non-done epics which matched the search criteria.

total_hits_with_done

int
— Number of epics, including done, which matched the search criteria.

kind

string
— The type of this object: epics_search_result. This field is read only.

resource

external_story

PROPERTIES

name

string
— Name of this external story.

description

string[20000]
— In-depth explanation of the story requirements.

integration_id

int
— ID of the Tracker external integration with which this external_story is associated. In API responses, this attribute may be integration_id or integration.

external_id

string
— Unique ID of the issue/ticket in the external system for this integration. (Note that this attribute does not indicate an association to another resource.)

estimate

float
— estimate of this external story.

state

int
— State of this external_story.

created_at

datetime
— Creation time of this external_story.

external_requester

string
— Identifier for the person who "requested" this story in the external system.

external_owner

string
— Identifier for the person who "owns" this story in the external system.

requested_by_id

int
— id of the person who requested this story in Tracker. Only shows in the hash if the 'external_requester' matches the name of a member of the project. In API responses, this attribute may be requested_by_id or requested_by.

owned_by_id

int
— id of the person who owns this story in Tracker. Only shows in the hash if the 'external_owner' matches the name of a member of the project. In API responses, this attribute may be owned_by_id or owned_by.

owner_ids

List[int]
— IDs of the current story owners. By default this will be included in responses as an array of nested structures, using the key owners. In API responses, this attribute may be owner_ids or owners.

story_type

string
— story_type of this external story.

extra

object
— A hash containing arbitrary extra fields which are specific to the type of integration with which this story is associated.

kind

string
— The type of this object: external_story. This field is read only.

resource

file_attachment

PROPERTIES

int
— Database id of the file_attachment. This field is read only. This field is always returned.

filename

string[255]
— The file's name. This field is read only.

created_at

datetime
— Creation time. This field is read only.

uploader_id

int
— The id of the person who uploaded the file. This field is read only. In API responses, this attribute may be uploader_id or uploader.

thumbnailable

boolean
— Flag indicating whether Tracker knows how to make a thumbnail image from the attachment. This field is read only.

height

int
— If the attachment is thumbnailable the height of it in pixels. This field is read only.

width

int
— If the attachment is thumbnailable the width of it in pixels. This field is read only.

size

int
— The size of the attachment in bytes. This field is read only.

download_url

string
— The URL for the original attachment on S3. This field is read only.

content_type

string[255]
— The MIME type of the attachment. This field is read only.

uploaded

boolean
— Flag indicating whether the attachment has been moved to S3. This field is read only.

big_url

string
— URL to larger-size thumbnail version if attachment is an image. This field is read only.

thumbnail_url

string
— URL to small-size thumbnail version if attachment is an image. This field is read only.

kind

string
— The type of this object: file_attachment. This field is read only.

resource

follower

PROPERTIES

int
— Database id of the person. This field is always returned.

name

string[100]
— The full name of the person.

string[255]
— The email address of the person. This field may be omitted for security reasons depending on the request from which it is being returned. For example, the content of a public project can be retrieved through the API without user authentication, but in this case the email is not included in person resources contained in the project's 'members' list.

initials

string[100]
— The initials of the person.

username

string
— The username of the person.

kind

string
— The type of this object: follower. This field is read only.

resource

following

PROPERTIES

int
— The id of the following. This field is read only. This field is always returned.

person_id

int
— The id of the follower. This field is writable only on create. By default this will be included in responses as a nested structure, using the key person.

story_id

int
— The id of the story. This field is writable only on create.

epic_id

int
— The id of the epic. This field is writable only on create.

kind

string
— The type of this object: following. This field is read only.

resource

generic_integration_object

PROPERTIES

kind

string
— The type of this object. One of the following strings: github_generic_integration_object, github_enterprise_generic_integration_object, gitlab_generic_integration_object, gitlab_self_managed_generic_integration_object, concourse_pipeline_generic_integration_object. This field is read only.

resource

get_satisfaction_integration

PROPERTIES

company

string
— Can be found in the URL in your company's community on Satisfaction. For example - http://www.getsatisfaction.com/yourcompany.

product

string
— Can be found in your company's Satisfaction URL, when you're looking at topics for a specific product. For example - http://www.getsatisfaction.com/yourcompany/products/yourproduct.

int
— Database id of the integration. This field is read only. This field is always returned.

project_id

int
— id of the project. This field is read only.

can_import

boolean
— true if it's possible to import stories via this integration. This field is read only.

base_url

string
— url used for outgoing web links in stories imported via this integration.

is_other

boolean
— whether the integration is of type 'other'. This field is read only.

story_name

string
— The name of things imported via the integration. This field is read only.

name

string[40]
— The name given to the particular external integration in the Project Settings pages.

active

boolean
— True if the integration is currently enabled for use.

created_at

datetime
— Creation time. This field is read only.

updated_at

datetime
— Time of last update. This field is read only.

kind

string
— The type of this object: get_satisfaction_integration. This field is read only.

resource

github_enterprise_generic_integration_object

PROPERTIES

int
— The id of the integration.

account_id

int
— The account id of the project.

project_id

int
— The id of the project.

webhook_uuid

string
— The webhook UUID of the github integration.

title

string[200]
— The title of the integration.

created_at

string
— Creation time.

updated_at

string
— Updation time.

integration_type

string
— The type of the integration.

secret_token

string
— The secret token related to webhook.

host_url

string[200]
— The base url from GitHub Enterprise.

webhook_url

string
— The webhook url for the github enterprise integration.

kind

string
— The type of this object: github_enterprise_generic_integration_object. This field is read only.

resource

github_generic_integration_object

PROPERTIES

int
— The id of the integration.

account_id

int
— The account id of the project.

project_id

int
— The id of the project.

webhook_uuid

string
— The webhook UUID of the github integration.

title

string[200]
— The title of the integration.

created_at

string
— Creation time.

updated_at

string
— Updation time.

integration_type

string
— The type of the integration.

secret_token

string
— The secret token related to webhook.

webhook_url

string
— The webhook url for the github integration.

kind

string
— The type of this object: github_generic_integration_object. This field is read only.

resource

gitlab_generic_integration_object

PROPERTIES

int
— The id of the integration.

account_id

int
— The account id of the project.

project_id

int
— The id of the project.

webhook_uuid

string
— The webhook UUID of the gitlab integration.

title

string[200]
— The title of the integration.

created_at

string
— Creation time.

updated_at

string
— Updation time.

integration_type

string
— The type of the integration.

secret_token

string
— The secret token related to webhook.

webhook_url

string
— The webhook url for the gitlab integration.

kind

string
— The type of this object: gitlab_generic_integration_object. This field is read only.

resource

gitlab_self_managed_generic_integration_object

PROPERTIES

int
— The id of the integration.

account_id

int
— The account id of the project.

project_id

int
— The id of the project.

webhook_uuid

string
— The webhook UUID of the gitlab self-managed integration.

title

string[200]
— The title of the integration.

created_at

string
— Creation time.

updated_at

string
— Updation time.

integration_type

string
— The type of the integration.

secret_token

string
— The secret token related to webhook.

host_url

string[200]
— The base url from Gitlab Self Managed.

webhook_url

string
— The webhook url for the gitlab self-managed integration.

kind

string
— The type of this object: gitlab_self_managed_generic_integration_object. This field is read only.

resource

google_attachment

PROPERTIES

int
— Database id of the google_attachment. This field is read only. This field is always returned.

comment_id

int
— The id of the comment. This field is read only.

person_id

int
— The id of the linked Google Drive user. This field is writable only on create. In API responses, this attribute may be person_id or person.

google_kind

string[255]
— The Google 'kind' string for this attachment. This field is writable only on create.

title

extended string[255]
— The google attachment's name. This field is writable only on create.

google_id

string[255]
— The link to the file on Google's servers. This field is writable only on create. (Note that this attribute does not indicate an association to another resource.)

alternate_link

string[255]
— An alternate link to the file on Google's servers. This field is writable only on create.

resource_id

string[255]
— Google's unique identifier for the file. This field is writable only on create. (Note that this attribute does not indicate an association to another resource.)

kind

string
— The type of this object: google_attachment. This field is read only.

resource

identity_object

PROPERTIES

int
— Database id. This field is read only. This field is always returned.

kind

string
— The type of this object: identity_object. This field is read only.

resource

integration

PROPERTIES

type

enumerated string
required on create — The name of the type of external integration that this resource represents. NOTE - Few account level & project level integrations such as GitHub, GitHub Enterprise, Gitlab, Gitlab Self-Managed and Concourse Pipeline currently can only be managed via the can be managed via Generic Integrations endpoint. This field is writable only on create. This field is required on create.

Valid enumeration values: bugzilla, get_satisfaction, jira, lighthouse, other, zendesk

api_username

string
— The username to use to access the external API.

api_password

string
— The password to use to access the external API. This field is write only.

zendesk_user_email

string
— The email of the Zendesk user which you want to use for integration purposes.

zendesk_user_password

string
— The password of the Zendesk user which you want to use for integration purposes. This field is write only.

view_id

string
— Only show tickets from the specified Zendesk view. (Note that this attribute does not indicate an association to another resource.)

company

string
— Can be found in the URL in your company's community on Satisfaction. For example - http://www.getsatisfaction.com/yourcompany.

product

string
— The name of your Bugzilla Product. Use this in conjunction with the component to narrow the bugs to be imported.

component

string
— The name of your Bugzilla Component. Use this in conjunction with product to narrow the bugs to be imported.

statuses_to_exclude

string
— A comma separated list of status names that should be excluded from the imported bugs. If left blank, all bugs will be imported.

filter_id

string
— The ID of the saved JIRA filter to use to load stories. (Note that this attribute does not indicate an association to another resource.)

account

string
— Your Lighthouse account name, and can be found in the first part of your Lighthouse URL, for example http://yourcompany.lighthouseapp.com.

external_api_token

string
— Your Lighthouse API token. This field is write only.

bin_id

int
— Only import tickets from the specified ticket bin. (Note that this attribute does not indicate an association to another resource.)

external_project_id

int
— The unique ID of your Lighthouse project, which can be found in a project URL, for example http://yourcompany.lighthouseapp.com/projects/1234-project-name/overview. (Note that this attribute does not indicate an association to another resource.)

import_api_url

string
— The URL to import stories from.

basic_auth_username

string
— The username to use when importing stories.

basic_auth_password

string
— The password to use when importing stories. This field is write only.

comments_private

boolean
— If enabled, comments made by Tracker on the external bug will be marked as private.

update_comments

boolean
— If enabled, comments created in Tracker will be added to the linked ticket or bug.

update_state

boolean
— Adds a state change comment to the linked ticket or bug.

int
— Database id of the integration. This field is read only. This field is always returned.

project_id

int
— id of the project. This field is read only.

can_import

boolean
— true if it's possible to import stories via this integration. This field is read only.

base_url

string
— url used for outgoing web links in stories imported via this integration.

is_other

boolean
— whether the integration is of type 'other'. This field is read only.

story_name

string
— The name of things imported via the integration. This field is read only.

name

string[40]
— The name given to the particular external integration in the Project Settings pages.

active

boolean
— True if the integration is currently enabled for use.

created_at

datetime
— Creation time. This field is read only.

updated_at

datetime
— Time of last update. This field is read only.

kind

string
— The type of this object. One of the following strings: bugzilla_integration, get_satisfaction_integration, jira_integration, lighthouse_integration, other_integration, zendesk_integration. This field is read only.

resource

iteration

PROPERTIES

number

int
— Iteration number starting from 1 for the first iteration in the project. This field is read only. This field is always returned.

project_id

int
— id of the project. This field is read only.

length

int
— Iteration length in weeks.

team_strength

float
— Iteration team strength, 1.0 is full-strength.

story_ids

List[int]
— Array of stories contained in the iteration. This field is read only. By default this will be included in responses as an array of nested structures, using the key stories. In API responses, this attribute may be story_ids or stories.

start

datetime
— Iteration start time. This field is read only.

finish

datetime
— Iteration finish time. This field is read only.

velocity

float
— The averaged number of points completed over a number of previous iterations, as determined by the project's velocity_averaged_over attribute. This field is read only. This field is excluded by default. To include this field by using the fields parameter, see Response Customization.

points

int
— The number of points in the iteration. This field is read only. This field is excluded by default. To include this field by using the fields parameter, see Response Customization.

accepted_points

int
— The number of accepted points in the iteration. This field is read only. This field is excluded by default. To include this field by using the fields parameter, see Response Customization.

effective_points

float
— The number of points in the iteration normalized by iteration length and team strength. This field is read only. This field is excluded by default. To include this field by using the fields parameter, see Response Customization.

accepted

daily_history_container
— The daily summary of stories accepted in this iteration. This field is read only. This field is excluded by default. To include this field by using the fields parameter, see Response Customization.

created

daily_history_container
— The number of stories created in this iteration by type. This field is read only. This field is excluded by default. To include this field by using the fields parameter, see Response Customization.

analytics

analytics
— Analytics data for this iteration. This field is read only. This field is excluded by default. To include this field by using the fields parameter, see Response Customization.

kind

string
— The type of this object: iteration. This field is read only.

resource

iteration_override

PROPERTIES

number

int
— Iteration number, starting from 1 for the first iteration in the project. This field is read only. This field is always returned.

project_id

int
— id of the project. This field is read only.

length

int
— Iteration length in weeks.

team_strength

float
— Iteration team strength, 1.0 is full-strength.

kind

string
— The type of this object: iteration_override. This field is read only.

resource

jira_integration

PROPERTIES

api_username

string
— The username of a JIRA user that has read/write access to your JIRA instance, via the JIRA API.

api_password

string
— Password of the JIRA user. This field is write only.

filter_id

string
— The ID of the saved JIRA filter to use to load stories. (Note that this attribute does not indicate an association to another resource.)

update_comments

boolean
— If enabled, comments created in Tracker will be added to the linked Jira ticket.

update_state

boolean
— Adds a state change comment to the linked Jira ticket.

account

string
— Account of user to link it with webhook.

webhook_url

string
— Webhook url to link with jira.

int
— Database id of the integration. This field is read only. This field is always returned.

project_id

int
— id of the project. This field is read only.

can_import

boolean
— true if it's possible to import stories via this integration. This field is read only.

base_url

string
— url used for outgoing web links in stories imported via this integration.

is_other

boolean
— whether the integration is of type 'other'. This field is read only.

story_name

string
— The name of things imported via the integration. This field is read only.

name

string[40]
— The name given to the particular external integration in the Project Settings pages.

active

boolean
— True if the integration is currently enabled for use.

created_at

datetime
— Creation time. This field is read only.

updated_at

datetime
— Time of last update. This field is read only.

kind

string
— The type of this object: jira_integration. This field is read only.

resource

known_person

PROPERTIES

person

person
— Content of 'person' resource. This field is read only.

collaboration_factor

int
— The count of projects, in the reference account, on which this person is already a collaborator. This field is read only.

kind

string
— The type of this object: known_person. This field is read only.

resource

label

PROPERTIES

int
— Database id of the label. This field is read only. This field is always returned.

project_id

int
— id of the project. This field is read only.

name

extended string[255]
required — The label's name.

created_at

datetime
— Creation time. This field is read only.

updated_at

datetime
— Time of last update. This field is read only.

counts

story_counts
— Summary of numbers of stories and points contained. This field is read only. This field is excluded by default. To include this field by using the fields parameter, see Response Customization.

kind

string
— The type of this object: label. This field is read only.

resource

lighthouse_integration

PROPERTIES

account

string
— Your Lighthouse account name, and can be found in the first part of your Lighthouse URL, for example http://yourcompany.lighthouseapp.com.

external_api_token

string
required on create — Your Lighthouse API token. This field is write only. This field is required on create.

bin_id

int
— Only import tickets from the specified ticket bin. (Note that this attribute does not indicate an association to another resource.)

external_project_id

update_comments

boolean
— If enabled, comments created in Tracker will be added to the linked Lighthouse ticket.

update_state

boolean
— Adds a state change comment to the linked Lighthouse ticket.

int
— Database id of the integration. This field is read only. This field is always returned.

project_id

int
— id of the project. This field is read only.

can_import

boolean
— true if it's possible to import stories via this integration. This field is read only.

base_url

string
— url used for outgoing web links in stories imported via this integration.

is_other

boolean
— whether the integration is of type 'other'. This field is read only.

story_name

string
— The name of things imported via the integration. This field is read only.

name

string[40]
— The name given to the particular external integration in the Project Settings pages.

active

boolean
— True if the integration is currently enabled for use.

created_at

datetime
— Creation time. This field is read only.

updated_at

datetime
— Time of last update. This field is read only.

kind

string
— The type of this object: lighthouse_integration. This field is read only.

resource

me

PROPERTIES

int
— Database id of the authenticated user. This field is read only. This field is always returned.

name

string[100]
— Name of the authenticated user. This field is read only.

initials

string[100]
— Authenticated user's initials. This field is read only.

username

string[40]
— Authenticated user's optional 'username' for login purposes. This field is read only.

time_zone

time_zone
— The authenticated user's time zone. This field is read only.

api_token

string[32]
— A string that can be used as the API authentication token (X-TrackerToken) to authenticate future API requests as being on behalf of the current user. This field is read only.

has_google_identity

boolean
— True if the authenticated user's profile is associated with a Google Email identity and the current request is authenticated with that identity. This field is read only. (Note that this attribute does not indicate an association to another resource.)

account_ids

List[int]
— IDs of the accounts that the authenticated user is a member of. This field is read only. By default this will be included in responses as an array of nested structures, using the key accounts. In API responses, this attribute may be account_ids or accounts.

project_ids

List[int]
— IDs of the project(s) that the authenticated user is a member of. This field is read only. By default this will be included in responses as an array of nested structures, using the key projects. In API responses, this attribute may be project_ids or projects.

workspace_ids

List[int]
— IDs of the workspaces(s) that the authenticated user owns. This field is read only. This field is excluded by default. To include this field by using the fields parameter, see Response Customization. In API responses, this attribute may be workspace_ids or workspaces.

string[255]
— Authenticated user's email. This field is read only.

receives_in_app_notifications

boolean
— Returns whether or not user is currently receiving in app notifications. This field is read only.

twofactor_auth_enabled

boolean
— Boolean representing whether two factor authentication is enabled for this user. This field is read only.

created_at

datetime
— Creation time. This field is read only.

updated_at

datetime
— Time of last update. This field is read only.

personal_settings

personal_settings
— Settings for the authenticated user. This field is excluded by default. To include this field by using the fields parameter, see Response Customization.

kind

string
— The type of this object: me. This field is read only.

resource

membership_summary

PROPERTIES

int
— The id of the membership. This field is read only. This field is always returned.

project_id

int
— The id of the project.

project_name

string
— The name of the project.

project_color

string
— The color of the project on the member's views.

favorite

boolean
— Whether or not the project is one of the member's favorites.

role

enumerated string
— The relationship between the authenticated user making the request and the project.

Valid enumeration values: owner, member, viewer, inactive

last_viewed_at

datetime
— The last (approximate) time at which the authenticated user accessed the project.

kind

string
— The type of this object: membership_summary. This field is read only.

resource

notification

PROPERTIES

int
— Database id of the notification. This field is read only.

project_id

int
— id of the project. This field is read only. By default this will be included in responses as a nested structure, using the key project.

performer_id

int
— id of the person who triggered the notification. This field is read only. By default this will be included in responses as a nested structure, using the key performer. In API responses, this attribute may be performer_id or performer.

message

string
— Message of the notification. This field is read only.

link

string
— link in the notification. This field is read only.

context

string
— Context of the notification. For example, if a comment was added, this will contain the comment text. This field is read only.

notification_type

enumerated string
— Resource or activity that generated the notification. This field is read only.

Valid enumeration values: story, epic, comment, comment_with_mention, blocker

new_attachment_count

int
— Number of new attachments on a comment create/update, if any. This field is read only.

action

string
— Action against the resource that triggered notification. This field is read only.

story_id

int
— ID of the story this notification is about. This field is read only. By default this will be included in responses as a nested structure, using the key story. In API responses, this attribute may be story_id or story.

epic_id

int
— ID of the epic this notification is about. This field is read only. By default this will be included in responses as a nested structure, using the key epic. In API responses, this attribute may be epic_id or epic.

comment_id

int
— The id of the comment if the notification is based on a comment. This field is read only. In API responses, this attribute may be comment_id or comment.

created_at

datetime
— Creation time. This field is read only.

updated_at

datetime
— Update time. This field is read only.

read_at

datetime
— Time notification was read.

kind

string
— The type of this object: notification. This field is read only.

resource

other_integration

PROPERTIES

import_api_url

string
— The URL to import stories from.

basic_auth_username

string
— The username to use when importing stories.

basic_auth_password

string
— The password to use when importing stories. This field is write only.

int
— Database id of the integration. This field is read only. This field is always returned.

project_id

int
— id of the project. This field is read only.

can_import

boolean
— true if it's possible to import stories via this integration. This field is read only.

base_url

string
— url used for outgoing web links in stories imported via this integration.

is_other

boolean
— whether the integration is of type 'other'. This field is read only.

story_name

string
— The name of things imported via the integration. This field is read only.

name

string[40]
— The name given to the particular external integration in the Project Settings pages.

active

boolean
— True if the integration is currently enabled for use.

created_at

datetime
— Creation time. This field is read only.

updated_at

datetime
— Time of last update. This field is read only.

kind

string
— The type of this object: other_integration. This field is read only.

resource

person

PROPERTIES

int
— Database id of the person. This field is read only. This field is always returned.

name

string[100]
required on create — The full name of the person. This field is required on create.

string[255]
required on create — The email address of the person. This field may be omitted for security reasons depending on the request from which it is being returned. For example, the content of a public project can be retrieved through the API without user authentication, but in this case the email is not included in person resources contained in the project's 'members' list. This field is required on create.

initials

string[100]
— The initials of the person.

username

string
— The username of the person.

kind

string
— The type of this object: person. This field is read only.

resource

personal_settings

PROPERTIES

header_display_mode

enumerated string
— Controls the state of the header on the project pages.

Valid enumeration values: expanded, collapsed

reports_autorefresh

boolean
— Boolean representing whether or not autorefresh should be enabled in reports.

kind

string
— The type of this object: personal_settings. This field is read only.

resource

project

PROPERTIES

int
— Database id of the project. This field is read only. This field is always returned.

name

extended string[50]
required on create — The name of the project. This field is required on create.

status

string
— The status of the project. This field is excluded by default. To include this field by using the fields parameter, see Response Customization.

version

int
— A counter that is incremented each time something is changed within a project. The project version is used to track whether a client is 'up to date' with respect to the current content of the project on the server, and to identify what updates have to be made to the client's local copy of the project (if it stores one) to re-synchronize it with the server. This field is read only.

iteration_length

int
— The number of weeks in an iteration.

week_start_day

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

Valid enumeration values: Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday

point_scale

string[255]
— The specification for the "point scale" available for entering story estimates within the project. It is specified as a comma-delimited series of values--any value that would be acceptable on the Project Settings page of the Tracker web application may be used here. If an exact match to one of the built-in point scales, the project will use that point scale. If another comma-separated point-scale string is passed, it will be treated as a "custom" point scale. The built-in scales are "0,1,2,3", "0,1,2,4,8", and "0,1,2,3,5,8".

point_scale_is_custom

boolean
— True if the value of the point_scale string represents a custom, user-defined point scale rather than one of the ones built into Pivotal Tracker. This is important because of restrictions on moving stories from projects using a custom point scale into one using a standard point scale. Note that the set of built-in point scales is not considered part of the definition of an API version. Clients should be capable of processing any point_scale string that adheres to the format described above, and rely on this flag (rather than any explicit list that the client contains) to determine whether the project's point_scale is custom or standard. This field is read only.

bugs_and_chores_are_estimatable

boolean
— When true, Tracker will allow estimates to be set on Bug- and Chore-type stories. This is strongly not recommended. Please see the FAQ for more information.

automatic_planning

boolean
— When false, Tracker suspends the emergent planning of iterations based on the project's velocity, and allows users to manually control the set of unstarted stories included in the Current iteration. See the FAQ for more information.

enable_following

boolean
— When true, Tracker allows users to follow stories and epics, as well as use @mentions in comments. This field is read only.

enable_tasks

boolean
— When true, Tracker allows individual tasks to be created and managed within each story in the project.

show_story_priority

boolean
— When true, Tracker allows Priority field to be hidden within each story in the project.

show_priority_icon

boolean
— When true, Tracker allows Priority field to be hidden within each story in the project.

show_priority_icon_in_all_panels

boolean
— When true, Tracker allows Priority field to be hidden within each story in the project.

start_date

date
— The first day that should be in an iteration of the project. If both this and "week_start_day" are supplied, they must be consistent. It is specified as a string in the format "YYYY-MM-DD" with "01" for January. If this is not supplied, it will remain blank (null), but "start_time" will have a default value based on the stories in the project. If a value is supplied for start_date, but that date is later than the accepted_at date of the earliest accepted story in your project, start_time will be based on the accepted_at date of the earliest accepted story.

time_zone

time_zone
— The "native" time zone for the project, independent of the time zone(s) from which members of the project view or modify it.

velocity_averaged_over

int
— 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.

shown_iterations_start_time

datetime
— The start time of the first iteration for which stories will be returned as part of the project, see 'number_of_done_iterations_to_show'. This field is read only. This field is excluded by default. To include this field by using the fields parameter, see Response Customization.

start_time

datetime
— The computed start time of the project, based on the other project attributes and the stories contained in the project. If they are provided, the value of start_time will be based on week_start_day and/or start_date. However, if the project contains stories with accepted_at dates before the time that would otherwise be computed, the value returned in start_time will be adjusted accordingly. This field is read only.

number_of_done_iterations_to_show

int
— There are areas within the Tracker UI and the API in which sets of stories automatically exclude the Done stories contained in older iterations. For example, in the web UI, the DONE panel doesn't necessarily show all Done stories by default, and provides a link to click to cause the full story set to be loaded/displayed. The value of this attribute is the maximum number of Done iterations that will be loaded/shown/included in these areas.

has_google_domain

boolean
— When true, the project has been associated with a Google Apps domain. Unless this is true, the /projects/{project_id}/google_attachments endpoint and the google_attachment resource cannot be used. This field is read only.

description

extended string[140]
— A description of the project's content. Entered through the web UI on the Project Settings page.

profile_content

extended string[65535]
— A long description of the project. This is displayed on the Project Overview page in the Tracker web UI.

enable_incoming_emails

boolean
— When true, the project will accept incoming email responses to Tracker notification emails and convert them to comments on the appropriate stories.

initial_velocity

int
— The number which should be used as the project's velocity when there are not enough recent iterations with Done stories for an actual velocity to be computed.

project_type

enumerated string
— The project's type which determines visibility and permissions [demo is deprecated].

Valid enumeration values: demo, private, public, shared

public

boolean
— When true, Tracker will allow any user on the web to view the content of the project. The project will not count toward the limits of a paid subscription, and may be included on Tracker's Public Projects listing page.

atom_enabled

boolean
— When true, Tracker allows people to subscribe to the Atom (RSS, XML) feed of project changes.

current_iteration_number

int
— Current iteration number for the project. This field is read only.

current_standard_deviation

float
— Standard deviation of the average points completed (adjusted for team strength and iteration length) for the number iterations used to compute velocity. This field is read only. This field is excluded by default. To include this field by using the fields parameter, see Response Customization.

current_velocity

int
— Current velocity for the project. This field is read only. This field is excluded by default. To include this field by using the fields parameter, see Response Customization.

current_volatility

float
— Relative standard deviation of the points completed (adjusted for team strength and iteration length) for the number iterations used to compute velocity. This field is read only. This field is excluded by default. To include this field by using the fields parameter, see Response Customization.

account_id

int
— The ID number for the account which contains the project.

join_as

enumerated string
— The default join_as value for the project [viewer, member]. This field is excluded by default. To include this field by using the fields parameter, see Response Customization.

Valid enumeration values: owner, member, viewer

story_ids

List[int]
— IDs of stories currently in the project. It is possible that not all stories in the 'accepted' state will be included in this list. Only those stories accepted since the begining of a particular done iteration will be returned. This is controlled by an entry on the project's Settings page in the Tracker web user interface, and the state of that entry is reflected in the number_of_done_iterations_to_show property of the project. This property contains a number of iterations. Tracker counts back this number of iterations prior to the present Current iteration, and will not include stories from Done iterations prior to this group. To access these stories, use the GET /projects/##/stories endpoint. This field is read only. This field is excluded by default. To include this field by using the fields parameter, see Response Customization. In API responses, this attribute may be story_ids or stories.

epic_ids

List[int]
— IDs of epics currently in the project. This field is read only. This field is excluded by default. To include this field by using the fields parameter, see Response Customization. In API responses, this attribute may be epic_ids or epics.

membership_ids

List[int]
— IDs of the existing memberships. This field is read only. This field is excluded by default. To include this field by using the fields parameter, see Response Customization. In API responses, this attribute may be membership_ids or memberships.

label_ids

List[int]
— IDs of labels currently in the project. This field is read only. This field is excluded by default. To include this field by using the fields parameter, see Response Customization. In API responses, this attribute may be label_ids or labels.

integration_ids

List[int]
— IDs of integrations currently configured for the project. Note that integration information must be retrieved by getting project information with integrations included as a nested resource; there is currently no independent RESTy endpoint for accessing integrations. This field is read only. This field is excluded by default. To include this field by using the fields parameter, see Response Customization. In API responses, this attribute may be integration_ids or integrations.

review_type_ids

List[int]
— IDs of review types created for the project. This field is read only. This field is excluded by default. To include this field by using the fields parameter, see Response Customization. In API responses, this attribute may be review_type_ids or review_types.

story_template_ids

List[int]
— IDs of story templates created for the project. This field is read only. This field is excluded by default. To include this field by using the fields parameter, see Response Customization. In API responses, this attribute may be story_template_ids or story_templates.

iteration_override_numbers

List[int]
— IDs of iteration overrides currently configured for the project. Note that iteration override information must be retrieved by getting project information with iteration overrides included as a nested resource; there is currently no independent RESTy endpoint for accessing iteration overrides, but there is one for iterations, which contains the same info plus additional dynamic fields related to emergent iteration calculation. This field is read only. This field is excluded by default. To include this field by using the fields parameter, see Response Customization.

created_at

datetime
— Creation time. This field is read only.

updated_at

datetime
— Time of last update. This field is read only.

scm_type_host_url_mapping

object
— Hash of host urls and their associated account integration type for integrations associated with the project. This field is read only. This field is excluded by default. To include this field by using the fields parameter, see Response Customization.

kind

string
— The type of this object: project. This field is read only.

resource

project_id_and_version

PROPERTIES

int
— Database id of the project.

version

kind

string
— The type of this object: project_id_and_version. This field is read only.

resource

project_membership

PROPERTIES

int
— The id of the membership. This field is read only. This field is always returned.

created_at

datetime
— Creation time. This field is writable only on create.

updated_at

datetime
— Time of last update. This field is read only.

person_id

project_id

int
— The id of the project. This field is writable only on create.

role

enumerated string
— The relationship between the authenticated user making the request and the project.

Valid enumeration values: owner, member, viewer, inactive

project_color

string
— The color of the project on the member's views.

favorite

boolean
— Whether or not the project is one of the member's favorites.

last_viewed_at

datetime
— The last (approximate) time at which the authenticated user accessed the project.

wants_comment_notification_emails

boolean
— Whether the user will receive emails about (non-commit) comments in this project. This field is read only.

will_receive_mention_notifications_or_emails

boolean
— Whether the user will receive notifications (email and/or in-application) from comments which @-mention them. This field is read only.

kind

string
— The type of this object: project_membership. This field is read only.

resource

project_snapshot

PROPERTIES

date

date
— This date that the snapshot represents. This field is always returned.

current

List[story_snapshot]
— All of the stories in current at the time of the snapshot.

backlog

List[story_snapshot]
— All of the stories in the backlog at the time of the snapshot. This field is excluded by default. To include this field by using the fields parameter, see Response Customization.

icebox

List[story_snapshot]
— All of the stories in the icebox at the time of the snapshot. This field is excluded by default. To include this field by using the fields parameter, see Response Customization.

kind

string
— The type of this object: project_snapshot. This field is read only.

resource

project_summary

PROPERTIES

int
— Database id of the project.

name

string[50]
— The name of the project.

role

enumerated string
— The relationship between the authenticated user making the request and the project.

Valid enumeration values: owner, member, viewer, inactive

last_viewed_at

datetime
— The authenticated user's last time loading the project.

kind

string
— The type of this object: project_summary. This field is read only.

resource

project_workspace

PROPERTIES

int
— Database id of the workspace. This field is always returned.

position

int
— The position of the project in the workspace.

project_id

int
— ID of the project. This field is read only. In API responses, this attribute may be project_id or project.

workspace_id

int
— ID of the workspace. In API responses, this attribute may be workspace_id or workspace.

kind

string
— The type of this object: project_workspace. This field is read only.

resource

pull_request

PROPERTIES

int
— Database id of the pull request. This field is read only. This field is always returned.

story_id

int
— The id of the story to which the pull request is connected. This field is read only.

epic_id

int
— The id of the epic to which the pull request is connected. This field is read only.

owner

string
required on create — GitHub owner of the pull request. This field is required on create.

repo

string
required on create — GitHub repo of the pull request. This field is required on create.

number

int
required on create — GitHub number of the pull request. This field is required on create.

host_url

string
required on create — URL for GitHub instance the PR belongs to. This field is required on create.

original_url

string
required on create — Original full pull request url. This field is required on create.

status

string
required on create — Status of the pull request (i.e. open, closed, merged). This field is required on create.

created_at

datetime
— Creation time. This field is read only.

updated_at

datetime
— Time of last update. This field is read only.

kind

string
— The type of this object: pull_request. This field is read only.

resource

release

PROPERTIES

int
— Database id of the release. This field is read only. This field is always returned.

project_id

int
— id of the project. This field is read only.

name

string[5000]
— Name of the release.

description

string[20000]
— In-depth explanation of the release requirements.

current_state

enumerated string
— Release's state of completion.

Valid enumeration values: accepted, delivered, finished, started, rejected, planned, unstarted, unscheduled

accepted_at

datetime
— Acceptance time.

deadline

datetime
— Due date/time.

label_ids

List[int]
— IDs of labels currently applied to release. By default this will be included in responses as an array of nested structures, using the key labels. In API responses, this attribute may be label_ids or labels.

story_ids

List[int]
— IDs of stories currently in the release. This field is excluded by default. To include this field by using the fields parameter, see Response Customization. In API responses, this attribute may be story_ids or stories.

created_at

datetime
— Creation time. This field is writable only on create.

updated_at

datetime
— Time of last update. This field is read only.

url

string
— The url for this release in Tracker. This field is read only.

projected_completion

datetime
— Projected completion date/time. This field is read only. This field is excluded by default. To include this field by using the fields parameter, see Response Customization.

projected_completion_interval

datetime_interval
— Projected completion date/time interval. This field is read only. This field is excluded by default. To include this field by using the fields parameter, see Response Customization.

points_accepted

float
— Sum of estimates of accepted stories in a release. This field is read only. This field is excluded by default. To include this field by using the fields parameter, see Response Customization.

points_total

float
— Sum of estimates of all stories in a release. This field is read only. This field is excluded by default. To include this field by using the fields parameter, see Response Customization.

counts_accepted

int
— Sum of all accepted stories in a release. This field is read only. This field is excluded by default. To include this field by using the fields parameter, see Response Customization.

counts_total

int
— Sum of all stories in a release. This field is read only. This field is excluded by default. To include this field by using the fields parameter, see Response Customization.

kind

string
— The type of this object: release. This field is read only.

resource

review

PROPERTIES

int
— Database id of the review. This field is read only. This field is always returned.

story_id

int
— The id of the story to which the review is connected. This field is read only.

review_type_id

int
— ID of the the review type assigned to this review. In API responses, this attribute may be review_type_id or review_type.

reviewer_id

int
— id of the person is responsible for this review.

status

enumerated string
— Current status of the review.

Valid enumeration values: unstarted, in_review, pass, revise

created_at

datetime
— Creation time. This field is read only.

updated_at

datetime
— Time of last update. This field is read only.

kind

string
— The type of this object: review. This field is read only.

resource

review_type

PROPERTIES

int
— Database id of the review_type. This field is read only. This field is always returned.

project_id

int
— ID of the project. This field is read only.

name

string
required on create — Name of the review type. This field is required on create.

hidden

boolean
— Whether to show the review type in review type menu.

created_at

datetime
— Creation time. This field is read only.

updated_at

datetime
— Time of last update. This field is read only.

kind

string
— The type of this object: review_type. This field is read only.

resource

saved_search

PROPERTIES

int
— Database id of the saved search. This field is read only. This field is always returned.

project_id

int
— id of the project. This field is read only.

name

string[255]
required on create — Name of the saved search. This field is required on create.

query

string[1000]
required on create — The search criteria string containing search terms and options which were specified for this saved search. How can a search be refined? This field is required on create.

kind

string
— The type of this object: saved_search. This field is read only.

resource

search_result_container

PROPERTIES

query

string[1000]
— The search criteria string containing search terms and options which were specified for this search. How can a search be refined?

stories

stories_search_result
— A hash containing information about the stories which matched the search criteria.

epics

epics_search_result
— A hash containing information about the epics which matched the search criteria.

kind

string
— The type of this object: search_result_container. This field is read only.

resource

secondary_resource

PROPERTIES

message

string
— Description of the activity.

highlight

string
— Boldface portion of the message.

resource

object
— Content of the resource also updated. The message strings in the secondary_resource are phrased within the context of this resource.

kind

string
— The type of this object: secondary_resource. This field is read only.

resource

source_commit

PROPERTIES

commit_id

string
— The identifier of the commit in the Source Control system. Optional. Will only be shown if the url is not present. (Note that this attribute does not indicate an association to another resource.)

message

string
— The message associated with the commit in the Source Control system.

url

string
— A URL which links to the commit in the Source Control system. Optional. If present, it will be used as a link in the comment. Otherwise, the commit_id will be shown.

author

string
— The author of the commit. If this is an exact match for the name of a member of the Tracker project which contains the story referenced in the source_commit message, the comment will be shown as created by that member and associated with that members person_id. Otherwise, the user performing the source_commits api call will be the creator of the comment.

repo

string
— The name of the repository the commit was pushed to. Optional.

kind

string
— The type of this object: source_commit. This field is read only.

resource

stories_search_result

PROPERTIES

stories

List[story]
— The story resources found during the search.

total_hits

int
— Number of non-done stories which matched the search criteria.

total_hits_with_done

int
— Number of stories, including done, which matched the search criteria.

total_points

float
— Sum of the points of all stories, in any state, which matched the search criteria.

total_points_completed

float
— Sum of the points only the stories in the accepted state which matched the search criteria.

kind

string
— The type of this object: stories_search_result. This field is read only.

resource

story

PROPERTIES

int
— Database id of the story. This field is read only. This field is always returned.

project_id

int
— id of the project.

name

extended string[5000]
required on create — Name of the story. This field is required on create.

description

extended string[20000]
— In-depth explanation of the story requirements.

story_type

enumerated string
— Type of story.

Valid enumeration values: feature, bug, chore, release

current_state

enumerated string
— Story's state of completion.

Valid enumeration values: accepted, delivered, finished, started, rejected, planned, unstarted, unscheduled

estimate

float
— Point value of the story.

accepted_at

datetime
— Acceptance time.

deadline

datetime
— Due date/time (for a release-type story).

projected_completion

datetime
— Projected completion date/time (for a release-type story). This field is read only. This field is excluded by default. To include this field by using the fields parameter, see Response Customization.

points_accepted

float
— Sum of estimates of accepted stories in a release (for a release-type story). This field is read only. This field is excluded by default. To include this field by using the fields parameter, see Response Customization.

points_total

float
— Sum of estimates of all stories in a release (for a release-type story). This field is read only. This field is excluded by default. To include this field by using the fields parameter, see Response Customization.

counts_accepted

int
— Sum of all accepted stories in a release (for a release-type story). This field is read only. This field is excluded by default. To include this field by using the fields parameter, see Response Customization.

counts_total

int
— Sum of all stories in a release (for a release-type story). This field is read only. This field is excluded by default. To include this field by using the fields parameter, see Response Customization.

requested_by_id

int
— The id of the person who requested the story. In API responses, this attribute may be requested_by_id or requested_by.

owned_by_id

int
— The id of the person who owns the story. In API responses, this attribute may be owned_by_id or owned_by.

owner_ids

label_ids

List[int]
— IDs of labels currently applied to story. By default this will be included in responses as an array of nested structures, using the key labels. In API responses, this attribute may be label_ids or labels.

task_ids

List[int]
— IDs of tasks currently on the story. This field is writable only on create. This field is excluded by default. To include this field by using the fields parameter, see Response Customization. In API responses, this attribute may be task_ids or tasks.

pull_request_ids

List[int]
— IDs of pull requests currently on the story. This field is writable only on create. This field is excluded by default. To include this field by using the fields parameter, see Response Customization. In API responses, this attribute may be pull_request_ids or pull_requests.

cicd_event_ids

List[int]
— IDs of CICD events currently on the story. This field is read only. This field is excluded by default. To include this field by using the fields parameter, see Response Customization. In API responses, this attribute may be cicd_event_ids or cicd_events.

branch_ids

List[int]
— IDs of branches currently on the story. This field is writable only on create. This field is excluded by default. To include this field by using the fields parameter, see Response Customization. In API responses, this attribute may be branch_ids or branches.

blocker_ids

List[int]
— IDs of blockers currently on the story. This field is writable only on create. This field is excluded by default. To include this field by using the fields parameter, see Response Customization. In API responses, this attribute may be blocker_ids or blockers.

follower_ids

comment_ids

List[int]
— IDs of comments currently on the story. This field is writable only on create. This field is excluded by default. To include this field by using the fields parameter, see Response Customization. In API responses, this attribute may be comment_ids or comments.

created_at

datetime
— Creation time. This field is writable only on create.

updated_at

datetime
— Time of last update. This field is read only.

before_id

int
— ID of the story that the current story is located before. Null if story is last one in the project. This field is excluded by default. To include this field by using the fields parameter, see Response Customization.

after_id

int
— ID of the story that the current story is located after. Null if story is the first one in the project. This field is excluded by default. To include this field by using the fields parameter, see Response Customization.

integration_id

int
— ID of the integration API that is linked to this story. In API responses, this attribute may be integration_id or integration.

external_id

string[255]
— The integration's specific ID for the story. (Note that this attribute does not indicate an association to another resource.)

url

string
— The url for this story in Tracker. This field is read only.

transitions

List[story_transition]
— All state transitions for the story. This field is read only. This field is excluded by default. To include this field by using the fields parameter, see Response Customization.

blocked_story_ids

List[int]
— IDs of other stories that are blocked by this story. This field is read only. This field is excluded by default. To include this field by using the fields parameter, see Response Customization. In API responses, this attribute may be blocked_story_ids or blocked_stories.

review_ids

List[int]
— IDs of reviews currently on the story. This field is writable only on create. This field is excluded by default. To include this field by using the fields parameter, see Response Customization. In API responses, this attribute may be review_ids or reviews.

cycle_time_details

cycle_time_details
— All information regarding a story's cycle time and state transitions (duration and occurrences). This field is read only. This field is excluded by default. To include this field by using the fields parameter, see Response Customization.

story_priority

enumerated string
— Story Priority of the specified story.

Valid enumeration values: p0, p1, p2, p3, none

kind

string
— The type of this object: story. This field is read only.

resource

story_counts

PROPERTIES

number_of_zero_point_stories_by_state

counts_by_story_state
— How many stories in each story state have no points.

sum_of_story_estimates_by_state

counts_by_story_state
— Total point estimates for each story state.

number_of_stories_by_state

counts_by_story_state
— Total number of stories in each story state.

kind

string
— The type of this object: story_counts. This field is read only.

resource

story_reference

PROPERTIES

int
— Database id of the story. This field is read only. This field is always returned.

kind

string
— The type of this object: story_reference. This field is read only.

resource

story_snapshot

PROPERTIES

story_id

int
— The id of the story that this snapshot is for. Hydrating a story via this ID will return the contemporary information about this story. This field is always returned. In API responses, this attribute may be story_id or story.

state

enumerated string
— The state at the time of the snapshot.

Valid enumeration values: accepted, delivered, finished, started, rejected, planned, unstarted, unscheduled

story_accepted_at

datetime
— The story accepted_at at the time of the snapshot.

estimate

int
— The estimate at the time of the snapshot.

story_type

enumerated string
— The type at the time of the snapshot.

Valid enumeration values: feature, bug, chore, release

kind

string
— The type of this object: story_snapshot. This field is read only.

resource

story_template

PROPERTIES

int
— The id of the story_template. This field is read only. This field is always returned.

project_id

int
— The id of the project. This field is read only.

name

string
— The name of the story_template. This field is read only. This field is always returned.

description

string
— The name of the story_template. This field is read only. This field is always returned.

created_at

datetime
— Creation time. This field is writable only on create.

updated_at

datetime
— Time of last update. This field is read only.

kind

string
— The type of this object: story_template. This field is read only.

resource

story_transition

PROPERTIES

state

enumerated string
— State the story transitioned to. This field is read only.

Valid enumeration values: accepted, delivered, finished, started, rejected, planned, unstarted, unscheduled

story_id

int
— ID of the story. This field is read only.

project_id

int
— ID of the project. This field is read only.

project_version

int
— The activity version of the story transition. This field is read only.

occurred_at

datetime
— Time of the transition. This field is read only.

performed_by_id

int
— ID of the person who performed the story transition. This field is read only.

kind

string
— The type of this object: story_transition. This field is read only.

resource

task

PROPERTIES

int
— Database id of the task. This field is read only. This field is always returned.

story_id

int
— The id of the story to which the task is connected. This field is read only.

description

extended string[1000]
required on create — Content of the task. This field is required on create.

complete

boolean
— Flag showing the completion of the task.

position

int
— Offset from the top of the task list. Positions start counting from 1 for the first task on a story.

created_at

datetime
— Creation time. This field is read only.

updated_at

datetime
— Time of last update. This field is read only.

kind

string
— The type of this object: task. This field is read only.

resource

time_zone

PROPERTIES

olson_name

string
— The Olson name for the time zone.

offset

string
— The offset, from UTC, of the time zone. This is a string containing a formatted representation of the time zone offset. First, and optional + or - sign (no sign is equivalent to '+'), then a number of hours, a colon, and a number of minutes. Only valid, internationally-recognized time zone offsets should be used when sending zone information for the client. For example, "-01:03" and "+23:00" are not valid values, even though they match the encoding pattern.

kind

string
— The type of this object: time_zone. This field is read only.

resource

webhook

PROPERTIES

int
— Database id of the webhook. This field is read only. This field is always returned.

project_id

int
— The id of the project. This field is writable only on create.

webhook_url

string
required on create — The location of the application listening for Tracker events. This field is required on create.

created_at

datetime
— Creation time. This field is read only.

updated_at

datetime
— Time of last update. This field is read only.

enabled

boolean
— Allows user to enable/disable webhook.

last_error_code

int
— Most recent error code received. This field is always returned.

last_response_body

extended string[10000]
— Most recent response body received. This field is always returned.

kind

string
— The type of this object: webhook. This field is read only.

resource

workspace

PROPERTIES

int
— Database id of the workspace. This field is read only. This field is always returned.

name

extended string[25]
— The name of the workspace.

person_id

int
— ID of the person that owns the workspace. This field is read only. In API responses, this attribute may be person_id or person.

project_ids

List[int]
— Array of projects contained in the workspace. By default this will be included in responses as an array of nested structures, using the key projects. In API responses, this attribute may be project_ids or projects.

kind

string
— The type of this object: workspace. This field is read only.

resource

zendesk_integration

PROPERTIES

zendesk_user_email

string
— The email of the Zendesk user which you want to use for integration purposes.

zendesk_user_password

string
— The password of the Zendesk user which you want to use for integration purposes. This field is write only.

view_id

string
— Only show tickets from the specified Zendesk view. (Note that this attribute does not indicate an association to another resource.)

update_comments

boolean
— If enabled, comments created in Tracker will be added to the linked Zendesk ticket.

update_state

boolean
— Adds a state change comment to the linked Zendesk ticket.

int
— Database id of the integration. This field is read only. This field is always returned.

project_id

int
— id of the project. This field is read only.

can_import

boolean
— true if it's possible to import stories via this integration. This field is read only.

base_url

string
— url used for outgoing web links in stories imported via this integration.

is_other

boolean
— whether the integration is of type 'other'. This field is read only.

story_name

string
— The name of things imported via the integration. This field is read only.

name

string[40]
— The name given to the particular external integration in the Project Settings pages.

active

boolean
— True if the integration is currently enabled for use.

created_at

datetime
— Creation time. This field is read only.

updated_at

datetime
— Time of last update. This field is read only.

kind

string
— The type of this object: zendesk_integration. This field is read only.