Video

The Video object type represents a video entity like a Loom video. atlassian:video should be used to ingest video-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]
  └─ containerKey (EntityKey) [Optional]
      ├─ type (string) [Required]
      └─ value (jsonNode) [Required]
  └─ permissions [] [Required]
      └─ accessControls
         └─ principals
            └─ type
  └─ associations [] [Optional]
      ├─ associationType (string)
      └─ values []
      
  atlassian:video
  ├─ thumbnailUrl (string) [Required]
  ├─ embedUrl (string) [Required]
  ├─ durationInSeconds (integer) [Optional]
  ├─ width (integer) [Optional]
  ├─ height (integer) [Optional]
  ├─ commentCount (integer) [Optional]
  ├─ textTracks (List<Track>) [Optional]
      ├─ name (string) [Optional]
      ├─ locale (string) [Optional]
      └─ cues (List<Cue>) [Required]
          ├─ id (string) [Optional]
          ├─ startTimeInSeconds (double) [Required]
          ├─ endTimeInSeconds (double) [Optional]
          └─ text (string) [Required]
  ├─ chapters (List<Chapter>) [Optional]
      ├─ startTimeInSeconds (integer) [Required]
      └─ title (string) [Required]
  └─ contributors (List<Contributor>) [Optional]
      ├─ user (userReference) [Required]
          ├─ accountId (string) [Optional]
          ├─ email (string) [Optional]
          └─ externalId (string) [Required]
      └─ interactionCount (integer) [Required]

Common properties

Video properties

Example payload

1
2
{
  "objects" : [ {
    "schemaVersion" : "2.0",
    "id" : "video-1",
    "updateSequenceNumber" : 1,
    "displayName" : "My cool video",
    "description" : "AI generated summary for this really cool video",
    "url" : "https://www.loom.com/share/59105659e3b84d2d8491bcc8f608284d",
    "createdAt" : "2024-01-15T10:00:00.000Z",
    "lastUpdatedAt" : "2024-07-09T14:27:37.000Z",
    "permissions" : [ {
      "accessControls" : [ {
        "principals" : [ {
          "type" : "ATLASSIAN_WORKSPACE"
        } ]
      } ]
    } ],
    "atlassian:video" : {
      "thumbnailUrl" : "https://cdn.loom.com/sessions/thumbnails/59105659e3b84d2d8491bcc8f608284d-thumbnail.jpg",
      "embedUrl" : "https://www.loom.com/embed/59105659e3b84d2d8491bcc8f608284d",
      "durationInSeconds" : 503,
      "width" : 3840,
      "height" : 2160,
      "commentCount" : 1,
      "textTracks" : [ {
        "name" : "English subtitles",
        "locale" : "en-US",
        "cues" : [ {
          "id" : "cue-intro",
          "startTimeInSeconds" : 0,
          "endTimeInSeconds" : 5.5,
          "text" : "Hello, Rafael from Team World Graph here..."
        } ]
      } ],
      "chapters" : [ {
        "startTimeInSeconds" : 0,
        "title" : "Introduction"
      }, {
        "startTimeInSeconds" : 90,
        "title" : "Provider and Consumer Schemas"
      }, {
        "startTimeInSeconds" : 220,
        "title" : "Transition to V2 API"
      } ],
      "contributors" : [ {
        "user" : {
          "externalId" : "some-external-worker-id"
        },
        "interactionCount" : 5
      } ]
    }
  } ]
}