The Teamwork Graph API is available through Forge's Early Access Program (EAP).
EAPs are offered to selected users for testing and feedback purposes. These features are unsupported and are subject to change without notice.
You must only install apps that call the Teamwork Graph API in test organizations. Apps calling
the Teamwork Graph API require the read:graph:jiraor read:graph:confluence scope, which provides access to Teamwork Graph
data across your entire organization. While apps still respect end-user permissions, this scope may
grant access to sensitive information. For safety, only install these apps in organizations with test
data unless you have an approved path to production.
Additionally, this EAP has significant limitations. To review the full list of limitations, see Limitations and considerations.
You must be part of this EAP in order to use the Teamwork Graph API. Express interest in joining through this form.
A role in an organization used for headcount tracking and worker management.
The Teamwork Graph API has the following fields and properties that you can use in your queries:
You can access these fields in the GraphiQL playground using the book icon in the top left, and then searching for Talent position.
| Field | Type | Description |
|---|---|---|
entityId | ID! | An internal UUID for the entity. This is not an ARI. |
id | ID! | The unique Atlassian Resource Identifier (ARI) for this position. |
managerId | ID | The ARI of the manager position, if this position has a manager. |
role | TalentPositionRole | The role of this position - either an individual contributor or a manager. |
type | TalentEntityType! | The type of entity. |
workerId | ID | The ARI of the worker currently filling this position, if filled. |
| Value | Description |
|---|---|
INDIVIDUAL_CONTRIBUTOR | |
MANAGER |
| Value | Description |
|---|---|
FOCUS_AREA | |
FOCUS_AREA_TYPE | |
POSITION | |
PROPOSAL | |
PROPOSED_MOVEMENT | |
TEAM | |
VIEW | |
WORKER |
Rate this page: