{
  "service": "pivotal_tracker",
  "displayName": "Pivotal Tracker",
  "categories": [
    "Productivity"
  ],
  "authTypes": [
    "api_key"
  ],
  "auth": [
    {
      "type": "api_key",
      "label": "API Token",
      "placeholder": "pivotal_tracker_api_token",
      "description": "Pivotal Tracker API token sent with the X-TrackerToken header. View or copy it from your Tracker profile page under API Token: https://www.pivotaltracker.com/profile",
      "extraFields": []
    }
  ],
  "homepageUrl": "https://www.pivotaltracker.com",
  "actions": [
    {
      "id": "pivotal_tracker.create_story",
      "service": "pivotal_tracker",
      "name": "create_story",
      "description": "Create a Pivotal Tracker story in a project.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "projectId": {
            "type": "integer",
            "minimum": 1,
            "description": "The numeric Pivotal Tracker project ID."
          },
          "name": {
            "type": "string",
            "minLength": 1,
            "description": "Story name.",
            "pattern": "\\S"
          },
          "storyType": {
            "type": "string",
            "enum": [
              "feature",
              "bug",
              "chore",
              "release"
            ],
            "description": "Tracker story type."
          },
          "currentState": {
            "type": "string",
            "enum": [
              "unscheduled",
              "unstarted",
              "started",
              "finished",
              "delivered",
              "accepted",
              "rejected"
            ],
            "description": "Tracker story state."
          },
          "description": {
            "type": "string",
            "minLength": 1,
            "description": "Story description."
          },
          "estimate": {
            "type": "number",
            "description": "Story estimate."
          },
          "requestedById": {
            "type": "integer",
            "minimum": 1,
            "description": "ID of the requester person."
          },
          "ownerIds": {
            "type": "array",
            "items": {
              "type": "integer",
              "minimum": 1,
              "description": "One numeric Tracker ID."
            },
            "description": "Numeric Tracker IDs.",
            "minItems": 1
          },
          "labelNames": {
            "type": "array",
            "items": {
              "type": "string",
              "minLength": 1,
              "description": "One label name.",
              "pattern": "\\S"
            },
            "description": "Label names to apply to the story.",
            "minItems": 1
          }
        },
        "additionalProperties": false,
        "required": [
          "projectId",
          "name"
        ],
        "description": "The input payload for creating a Tracker story."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "story": {
            "type": "object",
            "properties": {
              "kind": {
                "type": "string",
                "description": "Resource kind returned by Tracker."
              },
              "id": {
                "type": "integer",
                "minimum": 1,
                "description": "The numeric Pivotal Tracker ID."
              },
              "project_id": {
                "type": "integer",
                "minimum": 1,
                "description": "The numeric Pivotal Tracker project ID."
              },
              "name": {
                "type": "string",
                "description": "Story name."
              },
              "story_type": {
                "type": "string",
                "description": "Story type returned by Tracker."
              },
              "current_state": {
                "type": "string",
                "description": "Current story state returned by Tracker."
              },
              "url": {
                "type": "string",
                "description": "Browser URL for the story."
              },
              "created_at": {
                "type": "string",
                "description": "Timestamp when the story was created."
              },
              "updated_at": {
                "type": "string",
                "description": "Timestamp when the story was last updated."
              }
            },
            "additionalProperties": true,
            "description": "The Pivotal Tracker story returned by the API."
          }
        },
        "additionalProperties": false,
        "description": "The response returned when creating a Tracker story."
      }
    },
    {
      "id": "pivotal_tracker.create_story_comment",
      "service": "pivotal_tracker",
      "name": "create_story_comment",
      "description": "Create a text comment on a Pivotal Tracker story.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "projectId": {
            "type": "integer",
            "minimum": 1,
            "description": "The numeric Pivotal Tracker project ID."
          },
          "storyId": {
            "type": "integer",
            "minimum": 1,
            "description": "The numeric Pivotal Tracker story ID."
          },
          "text": {
            "type": "string",
            "minLength": 1,
            "description": "Comment text.",
            "pattern": "\\S"
          }
        },
        "additionalProperties": false,
        "description": "The input payload for creating a Tracker story comment."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "comment": {
            "type": "object",
            "properties": {
              "kind": {
                "type": "string",
                "description": "Resource kind returned by Tracker."
              },
              "id": {
                "type": "integer",
                "minimum": 1,
                "description": "The numeric Pivotal Tracker ID."
              },
              "story_id": {
                "type": "integer",
                "minimum": 1,
                "description": "The numeric Pivotal Tracker story ID."
              },
              "person_id": {
                "type": "integer",
                "minimum": 1,
                "description": "ID of the person who created the comment."
              },
              "text": {
                "type": "string",
                "description": "Comment text."
              },
              "created_at": {
                "type": "string",
                "description": "Timestamp when the comment was created."
              },
              "updated_at": {
                "type": "string",
                "description": "Timestamp when the comment was last updated."
              }
            },
            "additionalProperties": true,
            "description": "The Pivotal Tracker story comment returned by the API."
          }
        },
        "additionalProperties": false,
        "description": "The response returned when creating a Tracker story comment."
      }
    },
    {
      "id": "pivotal_tracker.get_current_user",
      "service": "pivotal_tracker",
      "name": "get_current_user",
      "description": "Get the Pivotal Tracker user associated with the API token.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {},
        "additionalProperties": false,
        "description": "The input payload for getting the current Tracker user."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "user": {
            "type": "object",
            "properties": {
              "kind": {
                "type": "string",
                "description": "Resource kind returned by Tracker."
              },
              "id": {
                "type": "integer",
                "minimum": 1,
                "description": "The numeric Pivotal Tracker ID."
              },
              "name": {
                "type": "string",
                "description": "User display name."
              },
              "username": {
                "type": "string",
                "description": "Tracker username."
              },
              "email": {
                "type": "string",
                "description": "User email address."
              },
              "initials": {
                "type": "string",
                "description": "User initials."
              }
            },
            "additionalProperties": true,
            "description": "The Pivotal Tracker user returned by the API."
          }
        },
        "additionalProperties": false,
        "description": "The response returned when getting the current Tracker user."
      }
    },
    {
      "id": "pivotal_tracker.get_project",
      "service": "pivotal_tracker",
      "name": "get_project",
      "description": "Get one Pivotal Tracker project by ID.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "projectId": {
            "type": "integer",
            "minimum": 1,
            "description": "The numeric Pivotal Tracker project ID."
          },
          "fields": {
            "type": "string",
            "minLength": 1,
            "description": "Optional Tracker fields selector.",
            "pattern": "\\S"
          }
        },
        "additionalProperties": false,
        "required": [
          "projectId"
        ],
        "description": "The input payload for getting a Tracker project."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "project": {
            "type": "object",
            "properties": {
              "kind": {
                "type": "string",
                "description": "Resource kind returned by Tracker."
              },
              "id": {
                "type": "integer",
                "minimum": 1,
                "description": "The numeric Pivotal Tracker ID."
              },
              "name": {
                "type": "string",
                "description": "Project name."
              },
              "version": {
                "type": "integer",
                "description": "Project version returned by Tracker."
              },
              "iteration_length": {
                "type": "integer",
                "description": "Iteration length in weeks."
              },
              "week_start_day": {
                "type": "string",
                "description": "Project week start day."
              },
              "point_scale": {
                "type": "string",
                "description": "Project point scale."
              },
              "account_id": {
                "type": "integer",
                "minimum": 1,
                "description": "Account ID that owns the project."
              }
            },
            "additionalProperties": true,
            "description": "The Pivotal Tracker project returned by the API."
          }
        },
        "additionalProperties": false,
        "description": "The response returned when getting a Tracker project."
      }
    },
    {
      "id": "pivotal_tracker.get_story",
      "service": "pivotal_tracker",
      "name": "get_story",
      "description": "Get one Pivotal Tracker story by project ID and story ID.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "projectId": {
            "type": "integer",
            "minimum": 1,
            "description": "The numeric Pivotal Tracker project ID."
          },
          "storyId": {
            "type": "integer",
            "minimum": 1,
            "description": "The numeric Pivotal Tracker story ID."
          },
          "fields": {
            "type": "string",
            "minLength": 1,
            "description": "Optional Tracker fields selector.",
            "pattern": "\\S"
          }
        },
        "additionalProperties": false,
        "required": [
          "projectId",
          "storyId"
        ],
        "description": "The input payload for getting a Tracker story."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "story": {
            "type": "object",
            "properties": {
              "kind": {
                "type": "string",
                "description": "Resource kind returned by Tracker."
              },
              "id": {
                "type": "integer",
                "minimum": 1,
                "description": "The numeric Pivotal Tracker ID."
              },
              "project_id": {
                "type": "integer",
                "minimum": 1,
                "description": "The numeric Pivotal Tracker project ID."
              },
              "name": {
                "type": "string",
                "description": "Story name."
              },
              "story_type": {
                "type": "string",
                "description": "Story type returned by Tracker."
              },
              "current_state": {
                "type": "string",
                "description": "Current story state returned by Tracker."
              },
              "url": {
                "type": "string",
                "description": "Browser URL for the story."
              },
              "created_at": {
                "type": "string",
                "description": "Timestamp when the story was created."
              },
              "updated_at": {
                "type": "string",
                "description": "Timestamp when the story was last updated."
              }
            },
            "additionalProperties": true,
            "description": "The Pivotal Tracker story returned by the API."
          }
        },
        "additionalProperties": false,
        "description": "The response returned when getting a Tracker story."
      }
    },
    {
      "id": "pivotal_tracker.list_project_stories",
      "service": "pivotal_tracker",
      "name": "list_project_stories",
      "description": "List stories in a Pivotal Tracker project with optional filters.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "projectId": {
            "type": "integer",
            "minimum": 1,
            "description": "The numeric Pivotal Tracker project ID."
          },
          "filter": {
            "type": "string",
            "minLength": 1,
            "description": "Tracker story filter query such as label:plans.",
            "pattern": "\\S"
          },
          "withState": {
            "type": "string",
            "enum": [
              "unscheduled",
              "unstarted",
              "started",
              "finished",
              "delivered",
              "accepted",
              "rejected"
            ],
            "description": "Tracker story state."
          },
          "withStoryType": {
            "type": "string",
            "enum": [
              "feature",
              "bug",
              "chore",
              "release"
            ],
            "description": "Tracker story type."
          },
          "limit": {
            "type": "integer",
            "minimum": 1,
            "description": "Maximum number of records to return."
          },
          "offset": {
            "type": "integer",
            "minimum": 0,
            "description": "Number of records to skip before returning results."
          },
          "fields": {
            "type": "string",
            "minLength": 1,
            "description": "Optional Tracker fields selector.",
            "pattern": "\\S"
          }
        },
        "additionalProperties": false,
        "required": [
          "projectId"
        ],
        "description": "The input payload for listing Tracker project stories."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "stories": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "kind": {
                  "type": "string",
                  "description": "Resource kind returned by Tracker."
                },
                "id": {
                  "type": "integer",
                  "minimum": 1,
                  "description": "The numeric Pivotal Tracker ID."
                },
                "project_id": {
                  "type": "integer",
                  "minimum": 1,
                  "description": "The numeric Pivotal Tracker project ID."
                },
                "name": {
                  "type": "string",
                  "description": "Story name."
                },
                "story_type": {
                  "type": "string",
                  "description": "Story type returned by Tracker."
                },
                "current_state": {
                  "type": "string",
                  "description": "Current story state returned by Tracker."
                },
                "url": {
                  "type": "string",
                  "description": "Browser URL for the story."
                },
                "created_at": {
                  "type": "string",
                  "description": "Timestamp when the story was created."
                },
                "updated_at": {
                  "type": "string",
                  "description": "Timestamp when the story was last updated."
                }
              },
              "additionalProperties": true,
              "description": "The Pivotal Tracker story returned by the API."
            },
            "description": "Stories returned by Tracker."
          }
        },
        "additionalProperties": false,
        "description": "The response returned when listing Tracker stories."
      }
    },
    {
      "id": "pivotal_tracker.list_projects",
      "service": "pivotal_tracker",
      "name": "list_projects",
      "description": "List Pivotal Tracker projects visible to the API token.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "limit": {
            "type": "integer",
            "minimum": 1,
            "description": "Maximum number of records to return."
          },
          "offset": {
            "type": "integer",
            "minimum": 0,
            "description": "Number of records to skip before returning results."
          },
          "fields": {
            "type": "string",
            "minLength": 1,
            "description": "Optional Tracker fields selector.",
            "pattern": "\\S"
          }
        },
        "additionalProperties": false,
        "description": "The input payload for listing Tracker projects."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "projects": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "kind": {
                  "type": "string",
                  "description": "Resource kind returned by Tracker."
                },
                "id": {
                  "type": "integer",
                  "minimum": 1,
                  "description": "The numeric Pivotal Tracker ID."
                },
                "name": {
                  "type": "string",
                  "description": "Project name."
                },
                "version": {
                  "type": "integer",
                  "description": "Project version returned by Tracker."
                },
                "iteration_length": {
                  "type": "integer",
                  "description": "Iteration length in weeks."
                },
                "week_start_day": {
                  "type": "string",
                  "description": "Project week start day."
                },
                "point_scale": {
                  "type": "string",
                  "description": "Project point scale."
                },
                "account_id": {
                  "type": "integer",
                  "minimum": 1,
                  "description": "Account ID that owns the project."
                }
              },
              "additionalProperties": true,
              "description": "The Pivotal Tracker project returned by the API."
            },
            "description": "Projects returned by Tracker."
          }
        },
        "additionalProperties": false,
        "description": "The response returned when listing Tracker projects."
      }
    },
    {
      "id": "pivotal_tracker.list_story_comments",
      "service": "pivotal_tracker",
      "name": "list_story_comments",
      "description": "List text comments on a Pivotal Tracker story.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "projectId": {
            "type": "integer",
            "minimum": 1,
            "description": "The numeric Pivotal Tracker project ID."
          },
          "storyId": {
            "type": "integer",
            "minimum": 1,
            "description": "The numeric Pivotal Tracker story ID."
          },
          "limit": {
            "type": "integer",
            "minimum": 1,
            "description": "Maximum number of records to return."
          },
          "offset": {
            "type": "integer",
            "minimum": 0,
            "description": "Number of records to skip before returning results."
          },
          "fields": {
            "type": "string",
            "minLength": 1,
            "description": "Optional Tracker fields selector.",
            "pattern": "\\S"
          }
        },
        "additionalProperties": false,
        "required": [
          "projectId",
          "storyId"
        ],
        "description": "The input payload for listing Tracker story comments."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "comments": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "kind": {
                  "type": "string",
                  "description": "Resource kind returned by Tracker."
                },
                "id": {
                  "type": "integer",
                  "minimum": 1,
                  "description": "The numeric Pivotal Tracker ID."
                },
                "story_id": {
                  "type": "integer",
                  "minimum": 1,
                  "description": "The numeric Pivotal Tracker story ID."
                },
                "person_id": {
                  "type": "integer",
                  "minimum": 1,
                  "description": "ID of the person who created the comment."
                },
                "text": {
                  "type": "string",
                  "description": "Comment text."
                },
                "created_at": {
                  "type": "string",
                  "description": "Timestamp when the comment was created."
                },
                "updated_at": {
                  "type": "string",
                  "description": "Timestamp when the comment was last updated."
                }
              },
              "additionalProperties": true,
              "description": "The Pivotal Tracker story comment returned by the API."
            },
            "description": "Comments returned by Tracker."
          }
        },
        "additionalProperties": false,
        "description": "The response returned when listing Tracker story comments."
      }
    },
    {
      "id": "pivotal_tracker.update_story_state",
      "service": "pivotal_tracker",
      "name": "update_story_state",
      "description": "Update the current state of a Pivotal Tracker story.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "projectId": {
            "type": "integer",
            "minimum": 1,
            "description": "The numeric Pivotal Tracker project ID."
          },
          "storyId": {
            "type": "integer",
            "minimum": 1,
            "description": "The numeric Pivotal Tracker story ID."
          },
          "currentState": {
            "type": "string",
            "enum": [
              "unscheduled",
              "unstarted",
              "started",
              "finished",
              "delivered",
              "accepted",
              "rejected"
            ],
            "description": "Tracker story state."
          }
        },
        "additionalProperties": false,
        "description": "The input payload for updating a Tracker story state."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "story": {
            "type": "object",
            "properties": {
              "kind": {
                "type": "string",
                "description": "Resource kind returned by Tracker."
              },
              "id": {
                "type": "integer",
                "minimum": 1,
                "description": "The numeric Pivotal Tracker ID."
              },
              "project_id": {
                "type": "integer",
                "minimum": 1,
                "description": "The numeric Pivotal Tracker project ID."
              },
              "name": {
                "type": "string",
                "description": "Story name."
              },
              "story_type": {
                "type": "string",
                "description": "Story type returned by Tracker."
              },
              "current_state": {
                "type": "string",
                "description": "Current story state returned by Tracker."
              },
              "url": {
                "type": "string",
                "description": "Browser URL for the story."
              },
              "created_at": {
                "type": "string",
                "description": "Timestamp when the story was created."
              },
              "updated_at": {
                "type": "string",
                "description": "Timestamp when the story was last updated."
              }
            },
            "additionalProperties": true,
            "description": "The Pivotal Tracker story returned by the API."
          }
        },
        "additionalProperties": false,
        "description": "The response returned when updating a Tracker story state."
      }
    }
  ]
}