API References

A user object creates and acts on other objects.  When multiple user records are associated with an individual, due to differences in email or variations in a name for example, user records can be merged under a single apex user record. &...

A user alias object is created for each unique way a user shows up in a source system such as GitHub, and Jira. One person may do work under many different email addresses or user ids. The user alias object is a record of each of those identities. ...

A commit represents a set of code changes stored in git.   Supported request Get a list of commits:  https://flow.pluralsight.com/v3/customer/core/commits/ Fields Name Type Description id double Commit ID (not the SH...

An event represents a labeled date of note that is defined by a user and appears in various reports to offer context. Event can be given tags, which allow them to be organized into logical groups.   Supported request Get a list of event...

An integration is a representation of a connection between Flow and a vendor.   Supported request Get a list of integrations: https://flow.pluralsight.com/v3/customer/core/integrations/ Fields Name Type Description id dou...

A pull request comment is a comment made by a user related to a specific pull request.   Supported requests Get a list of pull request comments:  https://flow.pluralsight.com/v3/customer/core/pull_request_comments/ Fields Nam...

A pull request event is an event about a pull request such as a comment or an approval.  It is supplied to Flow by the vendor.   Supported request Get a list of pull request events:  https://flow.pluralsight.com/v3/customer/co...

The request URL is a string representing the URL of the request. The URL syntax looks like:   [protocol]://[hostname][api version][customer/core][object][parameter(s)] Where: Protocol is the network protocol used to make the re...

A pull request project represents an entity that is the recipient of pull requests. All pull requests are tied to a pull request project. Typically, all pull request projects are also bound to a repository, which are discovered using a user's c...

A pull request represents an author's request to have a set of commits merged into a specific repository branch. Once an author submits a pull request, assigners, reviewers, and approvers can alter its state.   Supported request Get...

The Flow API is built using the Django REST Framework and supports basic and enhanced filtering options. Most operators are supported. Learn more about Django REST framework (external site, opens in new tab) . In this article Basic filter op...

A repository is a representation of a source control repository that has been discovered by Flow using a set of user credentials. Once a repository is discovered, it is then tied to a pull request project.   Supported request Get a list...

A target represents a user-defined goal for a metric for an individual or team.   Supported request Get a list of targets: https://flow.pluralsight.com/v3/customer/core/targets/ Fields Name Type Description id double Uniq...

Requesting data from two related objects is usually not easy in Rest requests. Normally, you have to make separate API calls to get the exact data you want. Flow uses filter-traversable objects to make this possible in a single call.   F...

Team membership is what defines a relationship between users and teams, as well as the nature of their relationship.   Supported request Get a list of team memberships:  https://flow.pluralsight.com/v3/customer/core/team_membership...

A team represents a user-defined group of authors.   Supported request Get a list of teams:  https://flow.pluralsight.com/v3/customer/core/teams/ Fields Name Type Description id double Unique identifier for a team. ...

A ticket comment is a comment made by a user related to a specific ticket.   Supported request Get a list of ticket comments:  https://flow.pluralsight.com/v3/customer/core/ticket_comments/ Fields Name Type Description ...

A ticket event represents a state change within an issue-tracking system lifecycle.   Supported request Get a list of ticket events:  https://flow.pluralsight.com/v3/customer/core/ticket_events/ Fields Name Type Description...

A ticket project represents a project within an issue-tracking software that contains tickets. All tickets are tied to a ticket project, which is discovered using a set of credentials.   Supported request Get a list of ticket projects:&...

A ticket is a specific issue filed by a user within an integrated issue-tracking software application.   Supported request Get a list of tickets:  https://flow.pluralsights.com/v3/customer/core/tickets/ Fields Name Type Des...

The Coding metrics API provides the coding metrics from the Team health insights report for use outside of Flow. Note:  The Coding metrics API is not documented in Flow's interactive API documentation (opens in new tab) .  ...

The collaboration metrics API provides the collaboration and PR metrics from the Team health insights report for use outside of Flow. In this article Permissions Calling the API Supported parameters Results Example responses ...