Pull request

The Pull request object type represents a pull request object within a repository. atlassian:pull-request should be used to ingest pull request-specific fields.

Payload structure

1
2
  objects {}
  ├─ schemaVersion (string) [Required]
  ├─ id (string) [Required]
  ├─ updateSequenceNumber (long) [Required]
  ├─ displayName (string) [Required]
  ├─ description (string) [Optional]
  ├─ url (string) [Required]
  ├─ createdAt (Instant (ISO8601 / RFC3339)) [Required]
  └─ createdBy [] [Optional]
      ├─ accountId (string)
      └─ ari (string)
  └─ lastUpdatedAt (Instant (ISO8601 / RFC3339)) [Required]
  └─ lastUpdatedBy [] [Required]
      ├─accountId (string)
      └─ ari
  └─ containerKey ()[Required]
      ├─ type
      └─ value
  └─ permissions 
      └─ accessControls
         └─ principals
            └─type
  └─ associations [] [Optional]
      ├─ associationType (string)
      └─ values []

  atlassian:pull-request
  ├─ title (string)
  ├─ displayId (string) [Required]
  ├─ status (string) [Required]
  ├─ author (UserReference)
      ├─ accountId (string) [Optional]
      ├─ email (string) [Optional]
      ├─ externalId (string) [Optional]
      ├─ ari (string) [Optional]
      ├─ name (string) [Optional]
      ├─ userName (string) [Optional]
      ├─ avatar (string) [Optional]
      └─ url (string) [Optional]
  ├─ commentCount (integer)
  ├─ sourceBranch (string) [Required]
  ├─ sourceBranchUrl (string)
  ├─ destinationBranch (string)
  ├─ destinationBranchUrl (string)
  ├─ reviewers (List<Reviewer>) [Required]
      ├─ accountId (string) [Optional]
      ├─ id (string) [Optional]
      ├─ email (string) [Optional]
      ├─ approvalStatus (string) [Optional]
      ├─ name (string) [Optional]
      ├─ avatar (string) [Optional]
      ├─ url (string) [Optional]
      └─ ari (string) [Optional]
  └─ taskCount (integer)

Common properties

Pull request properties

Example payload

1
2
{
  "objects" : [ {
    "id" : "repo-1",
    "updateSequenceNumber" : 1,
    "displayName" : "My repository",
    "description" : "A test repository",
    "url" : "https://bitbucket.org/my-project/my-repo/src/master/",
    "lastUpdatedAt" : "2023-07-19T15:27:37.000Z",
    "atlassian:repository" : {
      "forkOf" : "repo-2",
      "avatar" : "avatar.png",
      "avatarDescription" : "An avatar"
    }
  }, {
    "id" : "pr-1",
    "updateSequenceNumber" : 1,
    "displayName" : "SAI-123 A PR to do things",
    "description" : "This Pull request does X, Y, and Z.",
    "url" : "https://bitbucket.org/my-project/my-repo/src/master/",
    "lastUpdatedAt" : "2023-07-19T15:27:37.000Z",
    "containerKey" : {
      "type" : "atlassian:repository",
      "value" : {
        "repositoryId" : "repo-1"
      }
    },
    "owners" : [ {
      "externalId" : "external-id-1",
      "email" : "user4@example.com"
    } ],
    "atlassian:pull-request" : {
      "displayId" : "#2",
      "status" : "OPEN",
      "commentCount" : 324,
      "sourceBranch" : "SAI-123-sdf",
      "destinationBranch" : "main",
      "reviewers" : [ {
        "externalId" : "external-id-1",
        "email" : "user5@example.com"
      } ],
      "taskCount" : 21
    }
  } ],
  "operationType" : "NORMAL"
}