Preview features are available to all users and receive the same level of support as generally available features. Schemas, fields, and behavior may still change before general availability (GA), and breaking changes are subject to a minimum 1-month deprecation notice, announced in the Teamwork Graph changelog.

To review the current limitations, see Limitations and considerations.

To share feedback or report an issue, visit the Atlassian developer community.

Represents a deployment from an external CI/CD or deployment system. Deployments track the release of software changes to various environments.

Available fields and properties

The Teamwork Graph API has the following fields and properties that you can use in your queries:

Object type fields are the core data fields of the object. Use these when you want to retrieve specific information about the object in your queries.
Cypher query properties are metadata properties used for filtering and traversing relationships between different object types in Teamwork Graph. Use Cypher query properties when you need to filter or navigate relationships between this object and other objects in your queries.

Object type fields

Cypher query properties

Object type fields

You can access these fields in the GraphiQL playground using the book icon in the top left, and then searching for External deployment.

Field	Type	Description
`author`	`User`	User who triggered or initiated this deployment action.
`containerId`	`ID`	Identifier of the container (e.g., pipeline) that holds this deployment.
`createdAt`	`DateTime`	Timestamp when the deployment was created.
`creator`	`User`	User who created or initiated this deployment.
`deploymentSequenceNumber`	`Int`	Sequence number for this deployment, typically incrementing with each new deployment.
`description`	`String`	Description of the deployment.
`displayName`	`String`	Display name of the deployment.
`duration`	`Int`	Duration of the deployment execution in milliseconds.
`environment`	`ExternalEnvironment`	Environment information for where this deployment was executed.
`externalId`	`ID`	Identifier of the deployment in the external system.
`id`	`ID!`	Unique identifier for the deployment. This ID is globally unique across the entire Teamwork Graph.
`label`	`String`	Label or tag associated with this deployment.
`lastEditor`	`User`	User who last updated this deployment.
`lastUpdatedAt`	`DateTime`	Timestamp of the most recent update to the deployment.
`owners`	`[User]`	List of users who own this deployment.
`pipeline`	`ExternalPipeline`	Pipeline information that contains this deployment.
`provider`	`ExternalProvider`	Provider or integration that supplies this deployment.
`region`	`String`	Region where the deployment was executed (e.g., "us-west-2", "eu-central-1").
`state`	`ExternalDeploymentState`	Current state of the deployment (e.g., "SUCCESSFUL", "FAILED", "IN_PROGRESS", "CANCELLED", "ROLLED_BACK").
`thirdPartyId`	`ID`	Additional identifier used by the third-party system.
`url`	`URL`	Direct URL to view the deployment in its source system.

Fields for ExternalEnvironment

Field	Type	Description
`displayName`	`String`	Display name of the environment.
`id`	`ID!`	Identifier of the environment.
`type`	`ExternalEnvironmentType`	Type or classification of the environment.

Values for ExternalEnvironmentType

Value	Description
`DEVELOPMENT`	Development environment for active development work.
`PRODUCTION`	Production environment serving live users.
`STAGING`	Staging environment for pre-production testing.
`TESTING`	Testing environment for quality assurance.
`UNMAPPED`	Environment type not mapped to standard types.

Fields for ExternalPipeline

Field	Type	Description
`displayName`	`String`	Display name of the pipeline.
`id`	`ID!`	Identifier of the pipeline.
`url`	`URL`	URL to view the pipeline in its source system.

Fields for ExternalProvider

Field	Type	Description
`id`	`ID!`	Unique identifier for the external provider.
`logoUrl`	`URL`	URL to the provider's logo image for UI display.
`name`	`String`	Display name of the provider (e.g., "Google Drive", "Dropbox", "GitHub").

Values for ExternalDeploymentState

Value	Description
`CANCELLED`	Deployment was cancelled before completion.
`FAILED`	Deployment failed.
`IN_PROGRESS`	Deployment is currently in progress.
`PENDING`	Deployment is pending and has not started yet.
`ROLLED_BACK`	Deployment was rolled back after being deployed.
`SUCCESSFUL`	Deployment completed successfully.
`UNKNOWN`	Deployment state is unknown or cannot be determined.

Available relationships

The following relationships are currently supported for External deployment:

From relationships

To relationships

Relationships where External deployment is the source object.

Relationship name	From object type	To object type
Content entity links entity	External deployment	Compass component Compass component link Compass scorecard Confluence blog post Confluence comment Confluence database Confluence embed Confluence page Confluence space Confluence whiteboard External customer contact External customer org category External organisation External position External work item External worker External branch External build External calendar event External comment External commit External conversation External customer org External dashboard External data table External deal External deployment External design External document External feature flag External messages External project External pull request External remote link External repository External Service External space External video External vulnerability Atlassian team Atlassian team custom field value Atlassian team type Atlassian user Jira board Jira work item Jira work item comment Jira work item priority Jira work item remote link Jira work item status Jira space Jira sprint Jira version Jira worklog Loom comment Loom meeting Loom meeting recurrence Loom space Loom video Focus change proposal Focus focus area Opsgenie team Atlassian Home comment Atlassian goal Atlassian goal update Atlassian project Atlassian project update Atlassian Home tag
External deployment has external commit	External deployment	External commit
External deployment links external deployment	External deployment	External deployment
External deployment links external repository	External deployment	External repository
External entity is third party entity	External deployment	>> COULD NOT FIND