Last updated Jul 16, 2025

Software service

The Software service object type represents a software service object. atlassian:software-service should be used to ingest software service-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
  └─ permissions 
      └─ accessControls
         └─ principals
            └─type
  └─ associations [] [Optional]
      ├─ associationType (string)
      └─ values []
      
  atlassian:software-service
  ├─ description (string) [Optional]
  ├─ associationsMetadata (object) [Optional]
  ├─ namespace (string) [Optional]
  ├─ environment (string) [Optional]
  ├─ tags (List<string>) [Optional]
  ├─ tier (string) [Optional]
  └─ serviceType (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`	`user`	No	The user that created the object. See User to learn more.
`lastUpdatedAt`	`string`	Yes	The date the object was last updated. Format: Instant (ISO8601 / RFC3339)
`lastUpdatedBy`	`user`	No	The user that last updated the object. See User to learn more.
`owners`	`list<User>`	No	List 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.

Software Service properties

Property	Type	Required	Description
`description`	`string`	No	A description of the software service.
`associationsMetadata`	`object`	No	An object containing additional metadata for associations. Each property key represents an association type, and its value is a list of metadata objects related to that association. Max number of objects: 500
`namespace`	`string`	No	The namespace of this software service. It is usually used to separate organizations.
`environment`	`string`	No	The environment where the service is deployed. Max length: 255 characters.
`tags`	`List<string>`	No	Tags for this software service. Tags help to group or filter services. Max number of tags: 500
`tier`	`string`	No	The importance level of the service, for example: Tier 1, Tier 2, or Tier 3.
`serviceType`	`string`	No	The category of service, e.g., API, database, frontend, backend, or microservice.

Example payload

1
2
{
  "objects" : [ {
    "schemaVersion" : "2.0",
    "id" : "service-1",
    "updateSequenceNumber" : 123,
    "url" : "https://example-service.com",
    "description" : "",
    "createdAt" : "2024-04-16T09:01:32+00:00",
    "createdBy" : {
      "email" : "e-mail@user1.com",
      "externalId" : "external-id-1",
      "name" : "John Smith",
      "avatar" : "https://example-service.com/avatar/31"
    },
    "lastUpdatedAt" : "2024-04-16T09:01:42+00:00",
    "lastUpdatedBy" : {
      "email" : "e-mail@user2.com",
      "externalId" : "external-id-2"
    },
    "permissions" : [ {
      "action" : "READ",
      "accessControls" : [ {
        "principals" : [ {
          "type" : "EVERYONE"
        } ]
      } ]
    } ],
    "atlassian:software-service" : {
      "namespace" : "ns1",
      "environment" : "staging",
      "tags" : [ "tg1", "tg2" ],
      "tier" : "1",
      "serviceType" : "software",
      "associationsMetadata" : {
        "svc2" : [ {
          "associationType" : "CALLS",
          "experience" : "ext"
        } ]
      }
    }
  } ],
  "operationType" : "NORMAL"
}