Returns the time-based allocation breakdown for a specific contributor and work item within the given date range. The query window must not exceed 2 years. Results are split into weekly time periods.

Forge and OAuth2 apps cannot access this REST resource.

Request

Query parameters

contributorDataId

string

Required

workDataId

string

Required

startDate

string

Required

endDate

string

Required

valueType

string

Responses

application/json

GetContributionsResponse

Response containing contribution cells for a contributor-work pair

GET/contributions

curl

Node.js

Java

Python

PHP

1
2
3

curl --request GET \
  --url 'https://api.atlassian.com/ex/capacity-planning/{cloudId}/v1/contributions?contributorDataId=ari%3Acloud%3Aidentity%3A%3Auser%2F5e43cd5aa17f930c9b942ed4&workDataId=ari%3Acloud%3Ajira%3Acloud-id%3Aissue%2F10042&startDate=2026-01-01&endDate=2026-12-31' \
  --header 'Accept: application/json'

200Response

{
  "contributions": [
    {
      "contributorDataId": "ari:cloud:identity::user/5e43cd5aa17f930c9b942ed4",
      "endDate": "2026-06-21",
      "startDate": "2026-06-15",
      "value": 8,
      "valueType": "HOURS",
      "workDataId": "ari:cloud:jira:cloud-id:issue/10042"
    }
  ]
}

POST

Create or update contributionsPreview

Sets the allocation for one or more contributor-work pairs within specified date ranges (max 100 per call). A single contribution must not span more than 90 days, the start date must not be more than 2 years in the past, and the end date must not be more than 2 years in the future. If a contribution already exists for the same contributor, work item, and date range it is replaced with the new value; otherwise a new contribution is created.

Forge and OAuth2 apps cannot access this REST resource.

Request

Request bodyapplication/json

contributions

array<ContributionInputDto>

Required

Responses

application/json

UpsertContributionsResponse

Response containing the upserted contributions

POST/contributions

curl

Node.js

Java

Python

PHP

curl --request POST \
  --url 'https://api.atlassian.com/ex/capacity-planning/{cloudId}/v1/contributions' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{
  "contributions": [
    {
      "contributorDataId": "ari:cloud:identity::user/5e43cd5aa17f930c9b942ed4",
      "endDate": "2026-01-12",
      "startDate": "2026-01-06",
      "value": 8,
      "valueType": "HOURS",
      "workDataId": "ari:cloud:jira:cloud-id:issue/10042"
    }
  ]
}'

200Response

{
  "contributions": [
    {
      "contributorDataId": "ari:cloud:identity::user/5e43cd5aa17f930c9b942ed4",
      "endDate": "2026-06-21",
      "startDate": "2026-06-15",
      "value": 8,
      "valueType": "HOURS",
      "workDataId": "ari:cloud:jira:cloud-id:issue/10042"
    }
  ]
}

POST

Clear contributionsPreview

Removes the allocation for the specified contributor-work pairs and date ranges (max 100 per call). Each clear key must have a start date that is not after its end date. After this call, the affected date ranges will return a zero allocation. The response echoes back the keys that were cleared.

Forge and OAuth2 apps cannot access this REST resource.

Request

Request bodyapplication/json

contributions

array<ContributionKeyDto>

Required

Responses

application/json

ClearContributionsResponse

Response containing the composite keys of cleared contributions

POST/contributions:clear

curl

Node.js

Java

Python

PHP

curl --request POST \
  --url 'https://api.atlassian.com/ex/capacity-planning/{cloudId}/v1/contributions:clear' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{
  "contributions": [
    {
      "contributorDataId": "ari:cloud:identity::user/5e43cd5aa17f930c9b942ed4",
      "endDate": "2026-01-12",
      "startDate": "2026-01-06",
      "workDataId": "ari:cloud:jira:cloud-id:issue/10042"
    }
  ]
}'

200Response

{
  "cleared": [
    {
      "contributorDataId": "ari:cloud:identity::user/5e43cd5aa17f930c9b942ed4",
      "endDate": "2026-01-12",
      "startDate": "2026-01-06",
      "workDataId": "ari:cloud:jira:cloud-id:issue/10042"
    }
  ]
}