The Space object type represents a space entity like a Confluence space or a Jira project. atlassian:space should be used to ingest space-specific fields.

Additional required fields for Space:

displayName - Required

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]
  └─ permissions [] [Required]
      └─ accessControls
         └─ principals
            └─type
  └─ associations [] [Optional]
      ├─ associationType (string)
      └─ values []
      
  atlassian:space
  ├─ key (string) [Required]
  ├─ spaceType (string) [Required]
  ├─ subtype (string) [Required]
  ├─ icon (Icon) [Optional]
      ├─ url (string) [Optional]
      ├─ width (integer) [Required]
      ├─ height (integer) [Required]
      └─ isDefault (boolean) [Required]
  └─ labels (List<string>) [Optional]

Common properties

Property	Type	Required	Description
`schemaVersion`	`string`	Yes	The schema version of the object.
`id`	`string`	Yes	The ID of the object in the source system.
`updateSequenceNumber`	`long`	Yes	A 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.
`displayName`	`string`	Yes	The display name of the object.
`description`	`string`	No	The description of the object.
`url`	`string`	Yes	The URL from the provider which the object is accessible from.
`createdAt`	`string`	Yes	The date the object was created. Format: Instant (ISO8601 / RFC3339)
`createdBy`	`userReference`	No	A reference to the user that created the object. See userReference to learn more.
`lastUpdatedAt`	`string`	Yes	The date the object was last updated. Format: Instant (ISO8601 / RFC3339)
`lastUpdatedBy`	`userReference`	No	A reference to the user that last updated the object. See userReference to learn more.
`owners`	`list<userReference>`	No	List of references of users that own the object.
`thumbnail`	`thumbnail`	No	The thumbnail of the object. See Thumbnail to learn more.
`parentKey`	`entityKey`	No	The ID of the parent object. If null, it is a standalone object. See Entity key to learn more.
`containerKey`	`entityKey`	No	The container identifier that this object belongs to. See Entity key to learn more.
`permissions`	`list<Permissions>`	Yes	The permissions configuration of the object. See Permissions to learn more.
`associations`	`association`	No	List of objects associated with the object. Generally used to link an external object to a Atlassian object. See Association to learn more.

Space properties

Property	Type	Required	Description
`key`	`string`	Yes	The key of the space. Validation: max-length: 255
`spaceType`	`string`	Yes	The type of the space. Validation: max-length: 255
`subtype`	`string`	Yes	The subtype of the space. Allowed values: `space`, `project`, `business`, `software`, `service_desk`, `site`, `drive`
`icon`	`Icon`	No	The icon of the space.
`icon.url`	`string`	No	The URL of the icon. Format: Valid URL
`icon.width`	`integer`	Yes	The width of the icon. Format: int64
`icon.height`	`integer`	Yes	The height of the icon. Format: int64
`icon.isDefault`	`boolean`	Yes	Indicates if the icon is the default.
`labels`	`List<string>`	No	The labels of the space.

Example payload

1
2
{
  "objects" : [ {
    "schemaVersion" : "2.0",
    "id" : "siteId/spaceId1",
    "updateSequenceNumber" : 1,
    "displayName" : "My space",
    "description" : "The space contains work related stuff",
    "url" : "https://www.example-space.com/share/spaceId1",
    "createdAt" : "2024-07-01T10:00:00.000Z",
    "lastUpdatedAt" : "2024-07-09T14:27:37.000Z",
    "permissions" : [ {
      "accessControls" : [ {
        "principals" : [ {
          "type" : "ATLASSIAN_WORKSPACE"
        } ]
      } ]
    } ],
    "atlassian:space" : {
      "key" : "spaceKey1",
      "spaceType" : "personal",
      "subtype" : "space",
      "icon" : {
        "url" : "https://www.icon.com/1",
        "height" : 48,
        "width" : 48,
        "isDefault" : true
      },
      "labels" : [ "label1", "label2" ]
    }
  } ]
}