Developer
News and Updates
Get Support
Sign in
Get Support
Sign in
DOCUMENTATION
Cloud
Data Center
Resources
Sign in
Sign in
DOCUMENTATION
Cloud
Data Center
Resources
Sign in
Object types
Object operations
User operations
Group operations
Last updated Jan 14, 2025

Test Run

The Test Run object type represents the run of a Test in third parties. atlassian:test-run should be used to ingest test run-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 (userReference) [Optional]
      ├─ accountId (string) [Optional]
      ├─ email (string) [Optional]
      └─ externalId (string) [Required]
  └─ lastUpdatedAt (Instant (ISO8601 / RFC3339)) [Required]
  └─ lastUpdatedBy (userReference) [Optional]
      ├─ accountId (string) [Optional]
      ├─ email (string) [Optional]
      └─ externalId (string) [Required]
  └─ owners (List<userReference>) [Optional]
      ├─ accountId (string) [Optional]
      ├─ email (string) [Optional]
      └─ externalId (string) [Required]
  └─ thumbnail [Optional]
      └─ externalUrl (string)
  └─ parentKey (EntityKey) [Optional]
      ├─ type (string) [Required]
      └─ value (jsonNode) [Required]
  └─ permissions [] [Required]
      └─ accessControls
         └─ principals
            └─ type
  └─ associations [] [Optional]
      ├─ associationType (string)
      └─ values []
      
  atlassian:test-run
  ├─ status (string) [Required]
  ├─ assignee (userReference) [Optional]
      ├─ accountId (string) [Optional]
      ├─ email (string) [Optional]
      └─ externalId (string) [Required]
  ├─ startedAt (string) [Optional]
  ├─ finishedAt (string) [Optional]
  ├─ version (string) [Optional]
  └─ environment (string) [Optional]

Common properties

PropertyTypeRequiredDescription
schemaVersion

string

YesThe schema version of the object.
id

string

YesThe ID of the object in the source system.
updateSequenceNumberlongYesA sequence number to compare when writing to the database. Objects are written following a last write wins strategy, therefore an object with a greater UpdateSequenceNumber is considered a more recently updated object.
displayNamestringYesThe display name of the object.
descriptionstringNoThe description of the object.
urlstringYesThe URL from the provider which the object is accessible from.
createdAtstringYes

The date the object was created.

Format: Instant (ISO8601 / RFC3339)

createdByuserReferenceNo

A reference to the user that created the object.

See userReference to learn more.

lastUpdatedAtstringYes

The date the object was last updated.

Format: Instant (ISO8601 / RFC3339)

lastUpdatedByuserReferenceNo

A reference to the user that last updated the object.

See userReference to learn more.

ownerslist<userReference>NoList of references of users that own the object.
thumbnailthumbnailNo

The thumbnail of the object.

See Thumbnail to learn more.

parentKeyentityKeyNo

The ID of the parent object. If null, it is a standalone object.

See Entity key to learn more.

permissionslist<Permissions>Yes

The permissions configuration of the object.

See Permissions to learn more.

associationsassociationNo

List of objects associated with the object. Generally used to link an external object to a Atlassian object.

See Association to learn more.

Test run properties

PropertyTypeRequiredDescription
statusstringYes

Used to maintain the status of the TestRun entity. Separate from the Jira workflow status. Example of values: TO DO, EXECUTING, PASSED, etc.

Validation: max-length: 255

assigneeuserReferenceNo

Used to optionally specify a user which is responsible to run the test and document the output.

See userReference.

startedAtstringNo

Used to maintain the date where the test run started.

Format: Instant (ISO8601 / RFC3339)

finishedAtstringNo

Used to maintain the date where the test run ended.

Format: Instant (ISO8601 / RFC3339)

versionstringNo

Used to specify a scope of the test execution, in this case the respective test version that was executed. Example of values: 1, 1.2, 2-ix123.

Validation: max-length: 255

environmentstringNo

Used to specify a scope of the test execution, in this case the respective environment where the test was executed. Example of values: QE, STAG, PROD.

Validation: max-length: 255

Example payload

1
2
{
  "objects" : [ {
    "schemaVersion" : "2.0",
    "id" : "test-run-example-1",
    "updateSequenceNumber" : 1,
    "displayName" : "Test run noun example",
    "description" : "Test run noun ingestion request body example",
    "url" : "https://www.example-test.com/test-run/1",
    "createdAt" : "2024-07-09T14:27:37.000Z",
    "lastUpdatedAt" : "2024-07-09T14:27:37.000Z",
    "createdBy" : {
      "externalId" : "external-id-1"
    },
    "lastUpdatedBy" : {
      "externalId" : "external-id-2"
    },
    "permissions" : [ {
      "accessControls" : [ {
        "principals" : [ {
          "type" : "ATLASSIAN_WORKSPACE"
        } ]
      } ]
    } ],
    "atlassian:test-run" : {
      "status" : "PASSED",
      "startedAt" : "2024-04-16T09:01:32+00:00",
      "finishedAt" : "2024-04-16T09:15:45+00:00",
      "version" : "1.2.3",
      "environment" : "staging",
      "assignee" : {
        "externalId" : "external-id-2"
      }
    }
  } ]
}

Rate this page: