ActivityTimeline Help Center
ActivityTimeline Help Center
Breadcrumbs

REST API

All API requests can be made by ActivityTimeline user with Administrator permission only.

ActivityTimeline REST API is turned off by default. You must turn it on before the first use.

ActivityTimeline REST API can be turned on by changing ActivityTimeline REST API setting at AT REST API page in Configuration:

image-20250422-092541.png

How to Use REST API

  1. Create a unique AT REST API authorization token in ActivityTimeline configuration

  2. Call API methods with specifying that auth-token as a request Header or URL parameter (or auth_token before AT v8.3.0). 

  3. If an API key is missing, malformed, or invalid, you will receive an HTTP 401 Unauthorized response code.

Sample Java/C# code of AT REST API usage

Sample Java project that demonstrates how to call AT REST API can be downloaded here (all API methods).

Sample .NET (C#) project that demonstrates how to call AT REST API can be downloaded here (some API methods).

Handling Large Number IDs in JavaScript/Node.js

When calling ActivityTimeline REST API from JavaScript/Node.js, be aware that ActivityTimeline uses numeric identifiers that may be larger than JavaScript's Number type can safely support.

Example Issue:

✅ Expected ID

❌ JavaScript Parsed ID

1235598463805867311

1235598463805867300

Important: Handling “ID Does Not Exist” Errors

If you encounter errors such as “team with this ID does not exist” or “event with this ID does not exist” please keep in mind:

  • When viewing responses in JSON format, large numeric IDs may appear truncated or end with placeholder zeros — masking the actual identifier.

  • To see the full, accurate ID, always check the response in raw text format instead of JSON.

Authorization

You can authorize into the REST API by specifying a unique Authorization Token in one of four supported ways:

  • ✅ Preferred: Add auth-token Header with the value of your Authorization Token

  • ✅ Alternative: Add auth-token URL parameter with the value of your Authorization Token

🔹 Where to Generate the Token?

ActivityTimeline Configuration → AT REST API page.

Important: Handle the Authorization Token with the same security as a password.

Rate Limits

To ensure consistent performance and fair resource usage, the ActivityTimeline REST API enforces request rate limits.

🔹 Rate limit thresholds:

  • 1000 requests per hour

  • 200 requests per minute

If a client exceeds these thresholds, the API responds with:

  • HTTP 429 — Too Many Requests

The response includes standard rate-limit headers to support proper retry handling:

  • Retry-After — number of seconds to wait before sending the next request

  • X-Rate-Limit-Remaining — number of requests still available in the current window

These controls help clients manage request bursts and maintain reliable integrations with the API.

Methods

Timeline Schedule & Workload  v4.2.0+

Get Timeline

GET /rest/api/1/timeline?auth-token=YOUR_AUTH_TOKEN

Returns information about user and events (Jira issues and custom events) for specified user for specified period of time.

Maximum 1000 records per request. Pass issueOffset parameter to load the next portions.


Request 

GET /rest/api/1/timeline?auth-token=YOUR_AUTH_TOKEN

QUERY PARAMETERS

Parameter

Type

Description

start *

string

Start of the period formatted in "yyyy-MM-dd" format

end *

string

End of the period formatted in "yyyy-MM-dd" format

teamId *

long

Id of a specific team

issueOffset

int

Offset for the first level, default is 0

eventType

string

Optional

If specified then the system will filter returned items to the specified type.

  • supported custom event type names: BOOKING, DAY_OFF, HOLIDAY,
    NOTE, PLACEHOLDER, SICK_LEAVE, VACATION.

  • ISSUE for Jira issues only,

  • WORKLOG for Jira worklogs only,

  • empty - return all items in a period.

jql

string

v10.4.0+

Optional

If specified, the system will filter the issues based on the provided JQL query.

By default, non-working events (such vacations, holidays, sick leaves, etc.) are included in the output. To exclude these events, you can add the optional parameter:

jqlWithNonWorkingEvents=false

* indicates required parameters

Example

https://<ACTIVITYTIMELINE_INSTANCE>/rest/api/1/timeline?teamId=1234567890&start=2016-07-11&end=2016-07-18&auth-token=YOUR_AUTH_TOKEN

https://<ACTIVITYTIMELINE_INSTANCE>/rest/api/1/timeline?teamId=1234567890&start=2018-11-30&end=2019-01-01&eventType=HOLIDAY&auth-token=YOUR_AUTH_TOKEN

https://<ACTIVITYTIMELINE_INSTANCE>/rest/api/1/timeline?teamId=1234567890&start=2018-11-30&end=2019-01-01&eventType=BOOKING&auth-token=YOUR_AUTH_TOKEN

https://<ACTIVITYTIMELINE_INSTANCE>/rest/api/1/timeline?teamId=1234567890&start=2018-11-30&end=2019-01-01&eventType=ISSUE&auth-token=YOUR_AUTH_TOKEN

https://<ACTIVITYTIMELINE_INSTANCE>/rest/api/1/timeline?teamId=1234567890&start=2018-11-30&end=2019-01-01&eventType=WORKLOG&auth-token=YOUR_AUTH_TOKEN

Responses


status 200 application/json Returns json representation of the result if request performed successfully.

Example

{
    "id": "1107507732947945188",
    "name": "External Team",
    "members": [
        {
            "id": "3786270175247354575",
            "involvement": 8,
            "personPosition": {
                "id": "8582213406392863840",
                "positionNameLong": "QA",
                "positionDescription": "QA Engineer"
            },
            "userRealName": "Amy Kartel",
            "email": "amy.kartel@company.com",
            "enabled": true,
            "username": "amy.kartel",
            "issues": [
                {
                    "id": "273688659851364550",
                    "issueId": 20003,
                    "issueKey": "TRP-10",
                    "summary": "[TRP-10] Incorrect wording on a label",
                    "plannedStart": "2016-07-13",
                    "plannedEnd": "2016-07-13",
                    "due": "",
                    "color": "Red",
                    "issueType": "JIRA_ISSUE",
                    "originalTimeEstimate": 0,
                    "remainingTimeEstimate": 0
                },
                {
                    "id": "10913502816060634",
                    "issueId": null,
                    "issueKey": "TRPae98fee1-96c1-4b0b-ada6-dd138e12e693",
                    "summary": "[Booking] Reperi Product | potential work",
                    "plannedStart": "2016-07-14",
                    "plannedEnd": "2016-07-15",
                    "due": "",
                    "color": null,
                    "issueType": "BOOKING",
                    "originalTimeEstimate": 7200,
                    "remainingTimeEstimate": 7200,
                    "estimatePerWorkDay": "yes",
                    "extraLink": "",
                    "approvedBy": null
                },
                {
                    "id": "4960169761522796814",
                    "issueId": 16802,
                    "issueKey": "TA-8",
                    "summary": "[TA-8] Choose ISP",
                    "plannedStart": "2016-07-14",
                    "plannedEnd": "2016-07-14",
                    "due": "",
                    "color": "None",
                    "issueType": "JIRA_ISSUE",
                    "originalTimeEstimate": 0,
                    "remainingTimeEstimate": 0
                },
                {
                    "id": "4445216931731619881",
                    "issueId": null,
                    "issueKey": "_AT_2db7247c-a0f5-4e3b-bfe5-4baf1df566fa",
                    "summary": "[Day Off] out of the office",
                    "plannedStart": "2016-07-11",
                    "plannedEnd": "2016-07-12",
                    "due": "",
                    "color": "Yellow",
                    "issueType": "DAY_OFF",
                    "originalTimeEstimate": 0,
                    "remainingTimeEstimate": 0,
                    "extraLink": "",
                    "approvedBy": null
                }
            ]
        },
        {
            "id": "4759616025136811794",
            "involvement": 4,
            "personPosition": {
                "id": "3712124335976172354",
                "positionNameLong": "Consultant",
                "positionDescription": null
            },
            "userRealName": "Bob Robinson",
            "email": "bob.robinson@company.com",
            "enabled": true,
            "username": "bob.robinson",
            "issues": [
                {
                    "id": "6068295962237947803",
                    "issueId": 15103,
                    "issueKey": "TDES-1",
                    "summary": "[TDES-1] Two new graphics",
                    "plannedStart": "2016-07-11",
                    "plannedEnd": "2016-07-22",
                    "due": "",
                    "color": null,
                    "issueType": "JIRA_ISSUE",
                    "originalTimeEstimate": 57600,
                    "remainingTimeEstimate": 144000
                }
            ]
        },
        {
            "id": "2612086174493854452",
            "involvement": 8,
            "personPosition": null,
            "userRealName": "Janny Miller",
            "email": "janny.miller@company.com",
            "enabled": true,
            "username": "janny.miller",
            "issues": [
                {
                    "id": "3121097772564302182",
                    "issueId": 15106,
                    "issueKey": "TDES-4",
                    "summary": "[TDES-4] Update default layout",
                    "plannedStart": "2016-07-12",
                    "plannedEnd": "2016-07-12",
                    "due": "",
                    "color": null,
                    "issueType": "JIRA_ISSUE",
                    "originalTimeEstimate": 14400,
                    "remainingTimeEstimate": 5400
                },
                {
                    "id": "3954119684277487799",
                    "issueId": 15105,
                    "issueKey": "TDES-3",
                    "summary": "[TDES-3] Update title styles",
                    "plannedStart": "2016-07-11",
                    "plannedEnd": "2016-07-11",
                    "due": "",
                    "color": "Purple",
                    "issueType": "JIRA_ISSUE",
                    "originalTimeEstimate": 0,
                    "remainingTimeEstimate": 0
                },
                {
                    "id": "4134472451282322432",
                    "issueId": 15100,
                    "issueKey": "TRP-1",
                    "summary": "[TRP-1] Implement Data Migration Script",
                    "plannedStart": "2016-07-13",
                    "plannedEnd": "2016-07-15",
                    "due": "",
                    "color": null,
                    "issueType": "JIRA_ISSUE",
                    "originalTimeEstimate": 57600,
                    "remainingTimeEstimate": 86400
                },
                {
                    "id": "41351470354940514",
                    "issueId": null,
                    "issueKey": "TRPddc956ec-bb5b-4201-85ab-8f4f32f50e2c",
                    "summary": "[Placeholder | TRP-4] Add Print dialog",
                    "plannedStart": "2016-07-12",
                    "plannedEnd": "2016-07-12",
                    "due": "",
                    "color": null,
                    "issueType": "PLACEHOLDER",
                    "originalTimeEstimate": 7200,
                    "remainingTimeEstimate": 7200,
                    "placeholderIssueKey": "TRP-4",
                    "extraLink": "",
                    "approvedBy": null
                }
            ]
        }
    ]
}


status 400 Returns if incorrect input parameters were supplied

status 401 Returns if user was not logged in

status 403 Returns if user didn't have permissions

status 500 Returns if errors occurred during request
GET /rest/api/1/timeline/$username?auth-token=YOUR_AUTH_TOKEN

Returns information about user and events (Jira issues and custom events) for specified user for specified period of time.

Maximum 1000 records per request. Pass issueOffset parameter to load the next portions.


Request 

GET /rest/api/1/timeline/$username?auth-token=YOUR_AUTH_TOKEN

QUERY PARAMETERS

Parameter

Type

Description

start *

string

Start of the period formatted in "yyyy-MM-dd" format

end *

string

End of the period formatted in "yyyy-MM-dd" format

username *

string

Username or accountId of specific user

issueOffset

int

Offset for the first level, default is 0

eventType

string

Optional

If specified then the system will filter returned items to the specified type.

  • supported custom event type names: BOOKING, DAY_OFF, HOLIDAY,
    NOTE, PLACEHOLDER, SICK_LEAVE, VACATION.

  • ISSUE for Jira issues only,

  • WORKLOG for Jira worklogs only,

  • empty - return all items in a period.

jql

string

v10.4.0+

Optional

If specified, the system will filter the issues based on the provided JQL query.

By default, non-working events (such vacations, holidays, sick leaves, etc.) are included in the output. To exclude these events, you can add the optional parameter:

jqlWithNonWorkingEvents=false

* indicates required parameters

Example

https://<ACTIVITYTIMELINE_INSTANCE>/rest/api/1/timeline/admin?start=2016-07-11&end=2016-07-18&auth_token=YOUR_AUTH_TOKEN
 
https://<ACTIVITYTIMELINE_INSTANCE>/rest/api/1/timeline/admin?start=2018-11-30&end=2019-01-01&eventType=HOLIDAY&auth_token=YOUR_AUTH_TOKEN
 
https://<ACTIVITYTIMELINE_INSTANCE>/rest/api/1/timeline/admin?start=2018-11-30&end=2019-01-01&eventType=BOOKING&auth_token=YOUR_AUTH_TOKEN
 
https://<ACTIVITYTIMELINE_INSTANCE>/rest/api/1/timeline/admin?start=2018-11-30&end=2019-01-01&eventType=ISSUE&auth_token=YOUR_AUTH_TOKEN
 
https://<ACTIVITYTIMELINE_INSTANCE>/rest/api/1/timeline/admin?start=2018-11-30&end=2019-01-01&eventType=WORKLOG&auth_token=YOUR_AUTH_TOKEN

Responses


status 200 application/json Returns json representation of the result if request performed successfully.

Example

{
    "id": "2641502681345183593",
    "involvement": 8.0,
    "personPosition": null,
    "userRealName": "Administrator",
    "email": "admin@company.com",
    "enabled": true,
    "username": "admin",
    "issues": [{
        "id": "1800561052349910244",
        "issueId": null,
        "issueKey": "_AT_-ce48f923-bb20-47c1-8a71-95aaa2742d6f",
        "summary": "Placeholder",
        "plannedStart": "2020-07-29",
        "plannedEnd": "2020-07-29",
        "due": "",
        "color": "Green",
        "issueType": "PLACEHOLDER",
        "originalTimeEstimate": 18000,
        "remainingTimeEstimate": 18000,
        "placeholderIssueKey": null,
        "extraLink": "",
        "approvedBy": null
    }, {
        "id": "2163682457033067837",
        "issueId": null,
        "issueKey": "ADP-eb93d739-4aa7-4b1b-9b19-7b283d3b6442",
        "summary": "[Placeholder | ADP-69] Test",
        "plannedStart": "2020-07-28",
        "plannedEnd": "2020-07-28",
        "due": "",
        "color": "Green",
        "issueType": "PLACEHOLDER",
        "originalTimeEstimate": 18000,
        "remainingTimeEstimate": 18000,
        "placeholderIssueKey": "ADP-69",
        "extraLink": "",
        "approvedBy": null
    }, {
        "id": "4519045037419348631",
        "issueId": null,
        "issueKey": "ADP-6a2eb537-bf08-4403-a07a-2e8c8b520994",
        "summary": "[Placeholder | ADP-63] My team issue",
        "plannedStart": "2020-07-30",
        "plannedEnd": "2020-07-30",
        "due": "",
        "color": "Green",
        "issueType": "PLACEHOLDER",
        "originalTimeEstimate": 225000,
        "remainingTimeEstimate": 225000,
        "placeholderIssueKey": "ADP-63",
        "extraLink": "",
        "approvedBy": null
    }, {
        "id": "7749083366501270133",
        "issueId": null,
        "issueKey": "ADP-74f4b492-a4b9-432e-a463-cda63a7d447c",
        "summary": "[Placeholder | ADP-66] API issue",
        "plannedStart": "2020-07-27",
        "plannedEnd": "2020-07-27",
        "due": "",
        "color": "Green",
        "issueType": "PLACEHOLDER",
        "originalTimeEstimate": 0,
        "remainingTimeEstimate": 248400,
        "placeholderIssueKey": "ADP-66",
        "extraLink": "",
        "approvedBy": null
    }]
}


status 400 Returns if incorrect input parameters were supplied

status 401 Returns if user was not logged in

status 403 Returns if user didn't have permissions

status 500 Returns if errors occurred during request


GET /rest/api/1/team/$teamId/timeline?auth-token=YOUR_AUTH_TOKEN (since v11.2.0)

Returns information about Jira issues and custom events scheduled on the Team Panel (not users) for a specified period of time.

Maximum 1000 records per request. Pass issueOffset parameter to load the next portions.


Request 

GET /rest/api/1/team/$teamId/timeline?auth-token=YOUR_AUTH_TOKEN

 

QUERY PARAMETERS

Parameter

Type

Description

start *

string

Start of the period formatted in "yyyy-MM-dd" format

end *

string

End of the period formatted in "yyyy-MM-dd" format

teamId *

long

Id of a specific team

issueOffset

int

Offset for the first level, default is 0

* indicates required parameters

Example

https://<ACTIVITYTIMELINE_INSTANCE>/rest/api/1/team/1234567890/timeline?start=2025-07-11&end=2025-07-18&auth_token=YOUR_AUTH_TOKEN

Responses


status 200 application/json Returns json representation of the result if request performed successfully.

Example

{
    "teamId": "1107507732947945188",
    "teamName": "External Team",
    "issues": [
                {
                    "id": "273688659851364550",
                    "issueId": 20003,
                    "issueKey": "TRP-10",
                    "summary": "[TRP-10] Incorrect wording on a label",
                    "plannedStart": "2025-07-13",
                    "plannedEnd": "2025-07-13",
                    "due": "",
                    "color": "Red",
                    "issueType": "JIRA_ISSUE",
                    "originalTimeEstimate": 0,
                    "remainingTimeEstimate": 0
                },
                {
                    "id": "10913502816060634",
                    "issueId": null,
                    "issueKey": "TRPae98fee1-96c1-4b0b-ada6-dd138e12e693",
                    "summary": "[Booking] Reperi Product | potential work",
                    "plannedStart": "2025-07-14",
                    "plannedEnd": "2025-07-15",
                    "due": "",
                    "color": null,
                    "issueType": "BOOKING",
                    "originalTimeEstimate": 7200,
                    "remainingTimeEstimate": 7200,
                    "estimatePerWorkDay": "yes",
                    "extraLink": "",
                    "approvedBy": null
                    "approvedBy": null
                }
            ]
}

 

status 400 Returns if incorrect input parameters were supplied

status 401 Returns if user was not logged in

status 403 Returns if user didn't have permissions

status 500 Returns if errors occurred during request

 

Get Workload

GET /rest/api/1/workload?auth-token=YOUR_AUTH_TOKEN

Returns information about users and workloads for specified team for specified period of time.


Request 

GET /rest/api/1/workload?auth-token=YOUR_AUTH_TOKEN


QUERY PARAMETERS

Parameter

Type

Description

start *

string

Start of the period formatted in "yyyy-MM-dd" format

end *

string

End of the period formatted in "yyyy-MM-dd" format

teamId *

long

id of specified team

projectKey

string

Optional ActivityTimeline v8.1.2 and above
The system will output the per-user workload per specific project if
projectKey parameter is set

startOffset

int

Offset for first users, default is 0

maxUsers

int

Maximum users count to return, max 50

includeProjectDetails

boolean

Optional Activity Timeline v8.2.0 and above
If set to 'true" then the app will return break down of hours per project key.

Example

"username": "amy.kartel",
"workload": [
    {
        "day": "2021-07-12",
        "day0fWeek" : "mon",
        "hours": {
            "ABC": 4,
            "CDF": 2,
            "AMS": 0.5
        }
    },
    {
        "day": "2021-07-13",
        "day0fWeek": "tue",
        "hours": 0
    },
    ..........
    {
        "day": "2021-07-16",
        "dayOfWeek": "fri",
        "hours": {
              "CDF": 7,
              "AMS": 1
        }
    }         
]

jql

string

v10.4.0+

Optional

If specified, the system will filter the issues based on the provided JQL query.

By default, non-working events (such vacations, holidays, sick leaves, etc.) are included in the output. To exclude these events, you can add the optional parameter:

jqlWithNonWorkingEvents=false

* indicates required parameters

Example

http://<ACTIVITYTIMELINE_INSTANCE>/rest/api/1/workload?start=2016-07-11&end=2016-07-18&teamId=1107507732947945188&startOffset=0&maxUsers=50&auth_token=YOUR_AUTH_TOKEN


Responses


status 200 application/json Returns json representation of the result if request performed successfully.

Example

{
    "id": "1107507732947945188",
    "name": "External Team",
    "members": [
        {
            "id": "3786270175247354575",
            "involvement": 8,
            "personPosition": {
                "id": "8582213406392863840",
                "positionNameLong": "QA",
                "positionDescription": "QA Engineer"
            },
            "userRealName": "Amy Kartel",
            "email": "amy.kartel@company.com",
            "enabled": true,
            "username": "amy.kartel",
            "workload": [
                {
                    "day": "2016-07-10",
                    "dayOfWeek": "sun",
                    "hours": -1000
                },
                {
                    "day": "2016-07-11",
                    "dayOfWeek": "mon",
                    "hours": -2000
                },
                {
                    "day": "2016-07-12",
                    "dayOfWeek": "tue",
                    "hours": -2000
                },
                {
                    "day": "2016-07-13",
                    "dayOfWeek": "wed",
                    "hours": 0
                },
                {
                    "day": "2016-07-14",
                    "dayOfWeek": "thu",
                    "hours": 2
                },
                {
                    "day": "2016-07-15",
                    "dayOfWeek": "fri",
                    "hours": 2
                },
                {
                    "day": "2016-07-16",
                    "dayOfWeek": "sat",
                    "hours": -1000
                },
                {
                    "day": "2016-07-17",
                    "dayOfWeek": "sun",
                    "hours": -1000
                },
                {
                    "day": "2016-07-18",
                    "dayOfWeek": "mon",
                    "hours": 0
                },
                {
                    "day": "2016-07-19",
                    "dayOfWeek": "tue",
                    "hours": 0
                }
            ]
        },
        {
            "id": "4759616025136811794",
            "involvement": 4,
            "personPosition": {
                "id": "3712124335976172354",
                "positionNameLong": "Consultant",
                "positionDescription": null
            },
            "userRealName": "Bob Robinson",
            "email": "bob.robinson@company.com",
            "enabled": true,
            "username": "bob.robinson",
            "workload": [
                {
                    "day": "2016-07-10",
                    "dayOfWeek": "sun",
                    "hours": -1000
                },
                {
                    "day": "2016-07-11",
                    "dayOfWeek": "mon",
                    "hours": 4
                },
                {
                    "day": "2016-07-12",
                    "dayOfWeek": "tue",
                    "hours": 4
                },
                {
                    "day": "2016-07-13",
                    "dayOfWeek": "wed",
                    "hours": 4
                },
                {
                    "day": "2016-07-14",
                    "dayOfWeek": "thu",
                    "hours": 4
                },
                {
                    "day": "2016-07-15",
                    "dayOfWeek": "fri",
                    "hours": 4
                },
                {
                    "day": "2016-07-16",
                    "dayOfWeek": "sat",
                    "hours": -1000
                },
                {
                    "day": "2016-07-17",
                    "dayOfWeek": "sun",
                    "hours": -1000
                },
                {
                    "day": "2016-07-18",
                    "dayOfWeek": "mon",
                    "hours": 4
                },
                {
                    "day": "2016-07-19",
                    "dayOfWeek": "tue",
                    "hours": 4
                }
            ]
        },
        {
            "id": "2612086174493854452",
            "involvement": 8,
            "personPosition": null,
            "userRealName": "Janny Miller",
            "email": "janny.miller@company.com",
            "enabled": true,
            "username": "janny.miller",
            "workload": [
                {
                    "day": "2016-07-10",
                    "dayOfWeek": "sun",
                    "hours": -1000
                },
                {
                    "day": "2016-07-11",
                    "dayOfWeek": "mon",
                    "hours": 0
                },
                {
                    "day": "2016-07-12",
                    "dayOfWeek": "tue",
                    "hours": 3.5
                },
                {
                    "day": "2016-07-13",
                    "dayOfWeek": "wed",
                    "hours": 8
                },
                {
                    "day": "2016-07-14",
                    "dayOfWeek": "thu",
                    "hours": 8
                },
                {
                    "day": "2016-07-15",
                    "dayOfWeek": "fri",
                    "hours": 8
                },
                {
                    "day": "2016-07-16",
                    "dayOfWeek": "sat",
                    "hours": -1000
                },
                {
                    "day": "2016-07-17",
                    "dayOfWeek": "sun",
                    "hours": -1000
                },
                {
                    "day": "2016-07-18",
                    "dayOfWeek": "mon",
                    "hours": 0
                },
                {
                    "day": "2016-07-19",
                    "dayOfWeek": "tue",
                    "hours": 0
                }
            ]
        }
    ]
}


status 400 Returns if incorrect input parameters were supplied

status 401 Returns if user was not logged in

status 403 Returns if user didn't have permissions

status 500 Returns if errors occurred during request
GET /rest/api/1/workload/$username?auth-token=YOUR_AUTH_TOKEN (since v8.3.0)

Returns information about user and workloads for specified user for specified period of time.


Request 

GET /rest/api/1/workload/$username?auth-token=YOUR_AUTH_TOKEN


QUERY PARAMETERS

Parameter

Type

Description

start *

string

Start of the period formatted in "yyyy-MM-dd" format

end *

string

End of the period formatted in "yyyy-MM-dd" format

username *

string

Username or accountId of specific user

jql

string

v10.4.0+

Optional

If specified, the system will filter the issues based on the provided JQL query.

By default, non-working events (such vacations, holidays, sick leaves, etc.) are included in the output. To exclude these events, you can add the optional parameter:

jqlWithNonWorkingEvents=false

* indicates required parameters


Example 

https://<ACTIVITYTIMELINE_INSTANCE>/rest/api/1/workload/admin?start=2020-07-01&end=2020-07-30&auth_token=YOUR_AUTH_TOKEN


Responses


status 200 application/json Returns json representation of the result if request performed successfully.

Example

{
    "id": "2641502681345183593",
    "involvement": 8.0,
    "personPosition": null,
    "userRealName": "Administrator",
    "email": "admin@company.com",
    "enabled": true,
    "username": "admin",
    "workload": [{
        "day": "2020-07-01",
        "hours": 0,
        "dayOfWeek": "wed"
    }, {
        "day": "2020-07-02",
        "hours": 0,
        "dayOfWeek": "thu"
    }, {
        "day": "2020-07-03",
        "hours": 0,
        "dayOfWeek": "fri"
    }, {
        "day": "2020-07-04",
        "hours": 0,
        "dayOfWeek": "sat"
    }, {
        "day": "2020-07-05",
        "hours": 0,
        "dayOfWeek": "sun"
    }, {
        "day": "2020-07-06",
        "hours": 0,
        "dayOfWeek": "mon"
    }, {
        "day": "2020-07-07",
        "hours": 0,
        "dayOfWeek": "tue"
    }, {
        "day": "2020-07-08",
        "hours": 0,
        "dayOfWeek": "wed"
    }, {
        "day": "2020-07-09",
        "hours": 0,
        "dayOfWeek": "thu"
    }, {
        "day": "2020-07-10",
        "hours": 0,
        "dayOfWeek": "fri"
    }, {
        "day": "2020-07-11",
        "hours": 0,
        "dayOfWeek": "sat"
    }, {
        "day": "2020-07-12",
        "hours": 0,
        "dayOfWeek": "sun"
    }, {
        "day": "2020-07-13",
        "hours": 0,
        "dayOfWeek": "mon"
    }, {
        "day": "2020-07-14",
        "hours": 0,
        "dayOfWeek": "tue"
    }, {
        "day": "2020-07-15",
        "hours": 0,
        "dayOfWeek": "wed"
    }, {
        "day": "2020-07-16",
        "hours": 0,
        "dayOfWeek": "thu"
    }, {
        "day": "2020-07-17",
        "hours": 0,
        "dayOfWeek": "fri"
    }, {
        "day": "2020-07-18",
        "hours": 0,
        "dayOfWeek": "sat"
    }, {
        "day": "2020-07-19",
        "hours": 0,
        "dayOfWeek": "sun"
    }, {
        "day": "2020-07-20",
        "hours": 0,
        "dayOfWeek": "mon"
    }, {
        "day": "2020-07-21",
        "hours": 0,
        "dayOfWeek": "tue"
    }, {
        "day": "2020-07-22",
        "hours": 0,
        "dayOfWeek": "wed"
    }, {
        "day": "2020-07-23",
        "hours": 0,
        "dayOfWeek": "thu"
    }, {
        "day": "2020-07-24",
        "hours": 0,
        "dayOfWeek": "fri"
    }, {
        "day": "2020-07-25",
        "hours": 0,
        "dayOfWeek": "sat"
    }, {
        "day": "2020-07-26",
        "hours": 0,
        "dayOfWeek": "sun"
    }, {
        "day": "2020-07-27",
        "hours": 0,
        "dayOfWeek": "mon"
    }, {
        "day": "2020-07-28",
        "hours": 0,
        "dayOfWeek": "tue"
    }, {
        "day": "2020-07-29",
        "hours": 0,
        "dayOfWeek": "wed"
    }, {
        "day": "2020-07-30",
        "hours": 62.5,
        "dayOfWeek": "thu"
    }, {
        "day": "2020-07-31",
        "hours": 0,
        "dayOfWeek": "fri"
    }]
}


status 400 Returns if incorrect input parameters were supplied

status 401 Returns if user was not logged in

status 403 Returns if user didn't have permissions

status 500 Returns if errors occurred during request
GET /rest/api/1/team/$teamId/workload?auth-token=YOUR_AUTH_TOKEN (since v11.2.0)

Returns information about Team Panel workload (not users) for a specified period of time.


Request 

GET /rest/api/1/team/$teamId/workload?auth-token=YOUR_AUTH_TOKEN


QUERY PARAMETERS

Parameter

Type

Description

start *

string

Start of the period formatted in "yyyy-MM-dd" format

end *

string

End of the period formatted in "yyyy-MM-dd" format

teamId *

string

id of a specific team

* indicates required parameters


Example 

https://<ACTIVITYTIMELINE_INSTANCE>/rest/api/1/team/1234567890/workload?start=2025-07-01&end=2025-07-07&auth_token=YOUR_AUTH_TOKEN


Responses


status 200 application/json Returns json representation of the result if request performed successfully.

Example

{
    "teamId": "2641502681345183593",
    "displayName": "Sample Team",
    "workload": [
          {
              "day": "2025-07-01",
              "hours": 16,
              "dayOfWeek": "tue"
          }, {
              "day": "2025-07-02",
              "hours": 16,
              "dayOfWeek": "wed"
          }, {
              "day": "2025-07-03",
              "hours": 8,
              "dayOfWeek": "thu"
          }, {
              "day": "2025-07-04",
              "hours": 40,
              "dayOfWeek": "fri"
          }, {
              "day": "2025-07-05",
              "hours": 0,
              "dayOfWeek": "sat"
          }, {
              "day": "2025-07-06",
              "hours": 0,
              "dayOfWeek": "sun"
          }, {
              "day": "2025-07-07",
              "hours": 32,
              "dayOfWeek": "mon"
          } 
    ]
}

 

status 400 Returns if incorrect input parameters were supplied

status 401 Returns if user was not logged in

status 403 Returns if user didn't have permissions

status 500 Returns if errors occurred during request

Get Availability

GET /rest/api/1/availability?auth-token=YOUR_AUTH_TOKEN (since v9.5.4)

Returns information about availability of users of a specific team for a specified period of time.
User’s availability means how many hours of work user still has capacity to do taking into account currently scheduled tasks on that user.


Request 

GET /rest/api/1/availability?auth-token=YOUR_AUTH_TOKEN


QUERY PARAMETERS

Parameter

Type

Description

start *

string

Start of the period formatted in "yyyy-MM-dd" format

end *

string

End of the period formatted in "yyyy-MM-dd" format

teamId *

long

id of specified team

startOffset

int

Offset for first users, default is 0

maxUsers

int

Maximum users count to return, max 50

jql

string

v10.4.0+

Optional

If specified, the system will filter the issues based on the provided JQL query.

By default, non-working events (such vacations, holidays, sick leaves, etc.) are included in the output. To exclude these events, you can add the optional parameter:

jqlWithNonWorkingEvents=false

* indicates required parameters

Example

http://<ACTIVITYTIMELINE_INSTANCE>/rest/api/1/availability?start=2023-02-11&end=2023-02-18&teamId=5648895637201243664&startOffset=0&maxUsers=50&auth_token=YOUR_AUTH_TOKEN


Responses


status 200 application/json Returns json representation of the result if request performed successfully.

Example

{
   "id":"5648895637201243664",
   "name":"Sample Team",
   "members":[
      {
         "id":"5412165287981567372",
         "involvement":8.0,
         "personPosition":null,
         "userRealName":"Fefofi",
         "email":"person@company.com",
         "enabled":true,
         "username":"63c83eb49d59ec705fedddddd",
         "availability":[
            {
               "day":"2023-02-11",
               "hours":"0",
               "dayOfWeek":"sat"
            },
            {
               "day":"2023-02-12",
               "hours":"0",
               "dayOfWeek":"sun"
            },
            {
               "day":"2023-02-13",
               "hours":"8",
               "dayOfWeek":"mon"
            },
            {
               "day":"2023-02-14",
               "hours":"8",
               "dayOfWeek":"tue"
            },
            {
               "day":"2023-02-15",
               "hours":"8",
               "dayOfWeek":"wed"
            },
            {
               "day":"2023-02-16",
               "hours":"8",
               "dayOfWeek":"thu"
            },
            {
               "day":"2023-02-17",
               "hours":"8",
               "dayOfWeek":"fri"
            },
            {
               "day":"2023-02-18",
               "hours":"0",
               "dayOfWeek":"sat"
            }
         ]
      }
   ]
}


status 400 Returns if incorrect input parameters were supplied

status 401 Returns if user was not logged in

status 403 Returns if user didn't have permissions

status 500 Returns if errors occurred during request
GET /rest/api/1/availability/$username?auth-token=YOUR_AUTH_TOKEN (since v9.5.4)

Returns information about availability of a specific user for a specified period of time.
User’s availability means how many hours of work user still has capacity to do taking into account currently scheduled tasks on that user.


Request 

GET rest/api/1/availability/$username?auth-token=YOUR_AUTH_TOKEN


QUERY PARAMETERS

Parameter

Type

Description

start *

string

Start of the period formatted in "yyyy-MM-dd" format

end *

string

End of the period formatted in "yyyy-MM-dd" format

jql

string

v10.4.0+

Optional

If specified, the system will filter the issues based on the provided JQL query.

By default, non-working events (such vacations, holidays, sick leaves, etc.) are included in the output. To exclude these events, you can add the optional parameter:

jqlWithNonWorkingEvents=false

* indicates required parameters

Example

http://<ACTIVITYTIMELINE_INSTANCE>/rest/api/1/availability/63c83eb49d59ec705dddddd?start=2023-02-11&end=2023-02-18&auth_token=YOUR_AUTH_TOKEN


Responses


status 200 application/json Returns json representation of the result if request performed successfully.

Example

{
   "id":"5412165287981567372",
   "involvement":8.0,
   "personPosition":null,
   "userRealName":"Fefofi",
   "email":"person@company.com",
   "enabled":true,
   "username":"63c83eb49d59ec705fdddddd",
   "availability":[
      {
         "day":"2023-02-11",
         "hours":"0",
         "dayOfWeek":"sat"
      },
      {
         "day":"2023-02-12",
         "hours":"0",
         "dayOfWeek":"sun"
      },
      {
         "day":"2023-02-13",
         "hours":"8",
         "dayOfWeek":"mon"
      },
      {
         "day":"2023-02-14",
         "hours":"8",
         "dayOfWeek":"tue"
      },
      {
         "day":"2023-02-15",
         "hours":"8",
         "dayOfWeek":"wed"
      },
      {
         "day":"2023-02-16",
         "hours":"8",
         "dayOfWeek":"thu"
      },
      {
         "day":"2023-02-17",
         "hours":"8",
         "dayOfWeek":"fri"
      },
      {
         "day":"2023-02-18",
         "hours":"0",
         "dayOfWeek":"sat"
      }
   ]
}


status 400 Returns if incorrect input parameters were supplied

status 401 Returns if user was not logged in

status 403 Returns if user didn't have permissions

status 500 Returns if errors occurred during request

Get Capacity

GET /rest/api/1/capacity?auth-token=YOUR_AUTH_TOKEN (since v9.5.4)

Returns information about total capacity of users of a specific team for a specified period of time.
User’s capacity means how many hours of work user can do each day ignoring currently scheduled tasks on that user.


Request 

GET /rest/api/1/capacity?auth-token=YOUR_AUTH_TOKEN


QUERY PARAMETERS

Parameter

Type

Description

start *

string

Start of the period formatted in "yyyy-MM-dd" format

end *

string

End of the period formatted in "yyyy-MM-dd" format

teamId *

long

id of specified team

startOffset

int

Offset for first users, default is 0

maxUsers

int

Maximum users count to return, max 50

* indicates required parameters

Example

http://<ACTIVITYTIMELINE_INSTANCE>/rest/api/1/capacity?start=2023-02-11&end=2023-02-18&teamId=5648895637201243664&startOffset=0&maxUsers=50&auth_token=YOUR_AUTH_TOKEN


Responses


status 200 application/json Returns json representation of the result if request performed successfully.

Example

{
   "id":"5648895637201243664",
   "name":"Sample Team",
   "members":[
      {
         "id":"5412165287981567372",
         "involvement":8.0,
         "personPosition":null,
         "userRealName":"Fefofi",
         "email":"person@company.com",
         "enabled":true,
         "username":"63c83eb49d59ec70dddddd",
         "capacity":[
            {
               "day":"2023-02-11",
               "hours":"0",
               "dayOfWeek":"sat"
            },
            {
               "day":"2023-02-12",
               "hours":"0",
               "dayOfWeek":"sun"
            },
            {
               "day":"2023-02-13",
               "hours":"8",
               "dayOfWeek":"mon"
            },
            {
               "day":"2023-02-14",
               "hours":"8",
               "dayOfWeek":"tue"
            },
            {
               "day":"2023-02-15",
               "hours":"8",
               "dayOfWeek":"wed"
            },
            {
               "day":"2023-02-16",
               "hours":"8",
               "dayOfWeek":"thu"
            },
            {
               "day":"2023-02-17",
               "hours":"8",
               "dayOfWeek":"fri"
            },
            {
               "day":"2023-02-18",
               "hours":"0",
               "dayOfWeek":"sat"
            }
         ]
      }
   ]
}


status 400 Returns if incorrect input parameters were supplied

status 401 Returns if user was not logged in

status 403 Returns if user didn't have permissions

status 500 Returns if errors occurred during request
GET /rest/api/1/capacity/$username?auth-token=YOUR_AUTH_TOKEN (since v9.5.4)

Returns information about total capacity of a specific user for a specified period of time.
User’s capacity means how many hours of work user can do each day ignoring currently scheduled tasks on that user.


Request 

GET rest/api/1/capacity/$username?auth-token=YOUR_AUTH_TOKEN


QUERY PARAMETERS

Parameter

Type

Description

start *

string

Start of the period formatted in "yyyy-MM-dd" format

end *

string

End of the period formatted in "yyyy-MM-dd" format

* indicates required parameters

Example

http://<ACTIVITYTIMELINE_INSTANCE>/rest/api/1/capacity/63c83eb49d59ec705dddddd?start=2023-02-11&end=2023-02-18&auth_token=YOUR_AUTH_TOKEN


Responses


status 200 application/json Returns json representation of the result if request performed successfully.

Example

{
   "id":"5412165287981567372",
   "involvement":8.0,
   "personPosition":null,
   "userRealName":"Fefofi",
   "email":"person@company.com",
   "enabled":true,
   "username":"63c83eb49d59ec705dddddd",
   "capacity":[
      {
         "day":"2023-02-11",
         "hours":"0",
         "dayOfWeek":"sat"
      },
      {
         "day":"2023-02-12",
         "hours":"0",
         "dayOfWeek":"sun"
      },
      {
         "day":"2023-02-13",
         "hours":"8",
         "dayOfWeek":"mon"
      },
      {
         "day":"2023-02-14",
         "hours":"8",
         "dayOfWeek":"tue"
      },
      {
         "day":"2023-02-15",
         "hours":"8",
         "dayOfWeek":"wed"
      },
      {
         "day":"2023-02-16",
         "hours":"8",
         "dayOfWeek":"thu"
      },
      {
         "day":"2023-02-17",
         "hours":"8",
         "dayOfWeek":"fri"
      },
      {
         "day":"2023-02-18",
         "hours":"0",
         "dayOfWeek":"sat"
      }
   ]
}


status 400 Returns if incorrect input parameters were supplied

status 401 Returns if user was not logged in

status 403 Returns if user didn't have permissions

status 500 Returns if errors occurred during request



Custom events   v4.5.5+

POST /rest/api/1/event?auth-token=YOUR_AUTH_TOKEN

Creates a new custom event.


Request 

POST /rest/api/1/event?auth-token=YOUR_AUTH_TOKEN


QUERY PARAMETERS

Parameter

Type

Description

start *

string

Start of the period formatted in "yyyy-MM-dd" format

end *

string

End of the period formatted in "yyyy-MM-dd" format

username *

string

Assignee username (Jira Server) or accountld (Jira Cloud)

eventTypeId *

long

id of eventType

eventTitle *

string

Title of event

projectKey (optional)

string

Key of target project (Booking, Placeholder and Note types)

hours (optional)

number

Booking event estimate in hours / hours for partial Day Off event

estimate (optional)

number

Estimate in hours for Placeholder event type
Available starting from AT v7.3.5

color (optional)

string

Set custom Color for the newly created event.
Possible values:
RedOrange Yellow Green Blue Purple
VioletLivid Teal Silver Olive Gray

Available starting from AT v9.5.5

isApproved (optional)

string

If set to "true" then custom event will be created pre-approved.
Applicable to Placeholder, Vacation and Booking event types.
Available starting from AT v5.0.7

teamId (optional)

number

Id of a team. A new event will be created on a Team Panel of that team.
Supported event types: Note, Booking and Placeholder (and custom event types based on those three types).
usernameparameter must not be specified if teamId parameter is specified.
Available starting from AT v9.7.0

* indicates required parameters

Example

http://<ACTIVITYTIMELINE_INSTANCE>/rest/api/1/event?username=admin&=240025532758377186&eventTitle=someTitle&projectKey=TPA&hours=7&start=2016-11-14&end=2016-11-14&auth_token=YOUR_AUTH_TOKEN


Responses


status 200 application/json Returns created event id and new assignee username.

Example

{
	"users":["admin"],
	"message":"admin|||<b>Booking</b> has been successfully created for admin.",
	"result":true,
	"id":3728690601734324315
}


status 400 Returns if incorrect input parameters were supplied

status 401 Returns if user was not logged in

status 403 Returns if user didn't have permissions

status 500 Returns if errors occurred during request


GET /rest/api/1/event/$id?auth-token=YOUR_AUTH_TOKEN (since v9.3.2)

Get a single custom event data by id.


Request 

GET /rest/api/1/event/$id?auth-token=YOUR_AUTH_TOKEN


QUERY PARAMETERS

Parameter

Type

Description

id *

number

ID of custom event

* indicates required parameters

Example

http://<ACTIVITYTIMELINE_INSTANCE>/rest/api/1/event/29686068180042429?auth_token=YOUR_AUTH_TOKEN


Responses


status 200 application/json Returns custom event JSON data.

Example

{
    "id": "29686068180042429",
    "issueId": null,
    "issueKey": "SCRUM2b4e3596-31f2-4099-bf80-89765656975",
    "projectKey": "SCRUM",
    "summary": "[Booking] Scrum Project | Reservation",
    "plannedStart": "2022-07-18",
    "plannedEnd": "2022-07-31",
    "due": "",
    "color": "Green",
    "issueType": "BOOKING",
    "originalTimeEstimate": 28800,
    "remainingTimeEstimate": 28800,
    "estimatePerWorkDay": "yes",
    "extraLink": "",
    "approvedBy": null,
    "username": "557058:387baa8b-b43f-452e-cee0-08965456768"
}


status 400 Returns if incorrect input parameters were supplied

status 401 Returns if user was not logged in

status 404 Returns if custom event does not exist

status 500 Returns if errors occurred during request


PUT /rest/api/1/event?auth-token=YOUR_AUTH_TOKEN (since v9.7.0)

Updates a custom event.


Request 

PUT /rest/api/1/event?auth-token=YOUR_AUTH_TOKEN


QUERY PARAMETERS

Parameter

Type

Description

id *

long number

Id of a custom event to update

start *

string

New Start date of the scheduled period formatted in "yyyy-MM-dd" format

end *

string

New End date of the scheduled period formatted in "yyyy-MM-dd" format

username*

string

New Assignee username (Jira Server) or accountld (Jira Cloud)
to re-assign an item to

teamId (optional)

number

Id of Team to re-assign an item to / put an item on a Team Panel.
Supported event types: Note, Booking and Placeholder (and custom event types based on those three types).
If specified then username parameter is ignored.

title (optional)

string

New title for the item

projectKey (optional)

string

Key of target project (Booking, Placeholder, Overtime and Note types)

hours (optional)

number

Set estimate in hours per day for Issue / Issue part / Booking / Partial Day Off / Overtime events

estimate (optional)

number

Set total remaining estimate in hours for Placeholder events

color (optional)

string

New color for the event.
Possible values:
RedOrange Yellow Green Blue Purple
VioletLivid Teal Silver Olive Gray

isApproved (optional)

string

Defines whether event is approved or not (true - approved, false - not approved).
Applicable to Placeholder, Vacation and Booking event types.

* indicates required parameters

Example

https://<ACTIVITYTIMELINE_INSTANCE>/rest/api/1/event/24002553275837718634?title=New%20Title&start=2023-11-14&end=2023-11-14&auth_token=YOUR_AUTH_TOKEN


Responses


status 200 application/json Returns created event id and new assignee username.

Example

{
	"users":["admin"],
	"message":"admin|||<b>Booking</b> has been successfully updated for admin.",
	"result":true,
	"id":24002553275837718634
}


status 400 Returns if incorrect input parameters were supplied

status 401 Returns if user was not logged in

status 403 Returns if user didn't have permissions

status 500 Returns if errors occurred during request


DELETE /rest/api/1/event/$id?auth-token=YOUR_AUTH_TOKEN

Deletes a custom event.


Request 

DELETE /rest/api/1/event/$id?auth-token=YOUR_AUTH_TOKEN


QUERY PARAMETERS

Parameter

Type

Description

id *

long

id of custom event

* indicates required parameters

Example

http://<ACTIVITYTIMELINE_INSTANCE>/rest/api/1/event/312463?auth_token=YOUR_AUTH_TOKEN

Responses


status 200 application/json Returns success message.

Example

{
	"message":"Event has been successfully deleted!"
}


status 400 Returns if incorrect input parameters were supplied

status 401 Returns if user was not logged in

status 403 Returns if user didn't have permissions

status 500 Returns if errors occurred during request


POST /rest/api/1/event/$id/color?auth-token=YOUR_AUTH_TOKEN (since v9.5.5)

Updates color of an issue/event on the timeline.


Request 

POST /rest/api/1/event/$id/color?auth-token=YOUR_AUTH_TOKEN


QUERY PARAMETERS

Parameter

Type

Description

id *

long

id of custom event

color *

string

color of the event to be set.
Possible values:
RedOrange Yellow Green Blue Purple
VioletLivid Teal Silver Olive Gray

* indicates required parameters

Example

http://<ACTIVITYTIMELINE_INSTANCE>/rest/api/1/event/312463534535435/color?auth_token=YOUR_AUTH_TOKEN

Responses


status 200 application/json Returns updated issue/event data.

Example

{
	"id": 312463534535435,
	......
	"summary": "Event title",
	"username": "bob.robinson"
}


status 400 Returns if incorrect input parameters were supplied

status 401 Returns if user was not logged in

status 403 Returns if user didn't have permissions

status 404 Returns if issue/event does not exist

status 500 Returns if errors occurred during request


GET /rest/api/1/eventType/list?auth-token=YOUR_AUTH_TOKEN

Returns a list of custom event types.


Request 

GET /rest/api/1/eventType/list?auth-token=YOUR_AUTH_TOKEN


Example 

http://<ACTIVITYTIMELINE_INSTANCE>/rest/api/1/eventType/list?auth_token=YOUR_AUTH_TOKEN


Responses


status 200 application/json Returns json representation of event types.

Example

[
	{
		"id":240025532758377186,
		"name":"Booking",
		"eventType":"BOOKING",
		"eventTypeIconUrl":"../images/jira/icons/eventTypes/at_booking.png",
		"isSystemEventType":true,
		"isMilestoneEventType":false
	},
    {
		"id":143598346239228823,
		"name":"Vacation",
		"eventType":"VACATION",
		"eventTypeIconUrl":"../images/jira/icons/eventTypes/at_vacation.png",
		"isSystemEventType":true,
		"isMilestoneEventType":false
	},
	{
		"id":308729741261950787,
		"name":"Placeholder",
		"eventType":"PLACEHOLDER",
		"eventTypeIconUrl":"../images/jira/icons/eventTypes/at_placeholder.png",
		"isSystemEventType":true,
		"isMilestoneEventType":false
	}
]

status 401 Returns if user was not logged in

status 403 Returns if user didn't have permissions

status 500 Returns if errors occurred during request



Teams   v8.3.0+

GET /rest/api/1/team/list?auth-token=YOUR_AUTH_TOKEN (since v4.5.5)

Returns list of Activity Timeline teams.

Request

GET /rest/api/1/team/list?auth-token=YOUR_AUTH_TOKEN


Responses

status 200  application/json Returns json representation of the result if request performed successfully.

Example

[{
	"id": "1107507732947945188",
	"name": "External Team"
}, {
	"id": "387281612195971911",
	"name": "Developers Team"
}, {
	"id": "7756417552636331634",
	"name": "QA Team"
}]

status 401 Returns if user was not logged in

status 403 Returns if user didn't have permissions

status 500 Returns if errors occurred during request


GET /rest/api/1/team/$teamId?auth-token=YOUR_AUTH_TOKEN

Returns information about team and users in a specified team.


Request 

GET /rest/api/1/team/$teamId?auth-token=YOUR_AUTH_TOKEN


QUERY PARAMETERS

Parameter

Type

Description

teamId *

long

id of specific team

* indicates required parameters


Example 

http://<ACTIVITYTIMELINE_INSTANCE>/rest/api/1/team/1107507732947945188?auth_token=YOUR_AUTH_TOKEN


Responses


status 200 application/json Returns json representation of the result if request performed successfully.

Example

{
    "id": "1107507732947945188",
    "name": "External Team",
    "members": [
        {
            "id": "3786270175247354575",
            "involvement": 8,
            "personPosition": {
                "id": "8582213406392863840",
                "positionNameLong": "QA",
                "positionDescription": "QA Engineer"
            },
            "userRealName": "Amy Kartel",
            "email": "amy.kartel@company.com",
            "enabled": true,
            "username": "amy.kartel",
            "skills": [
                {
                    "skill": {
                        "id": "6696288071248397937",
                        "skillName": "TESTING"
                    },
                    "level": {
                        "id": "2845444854505357930",
                        "levelName": "Advanced",
                        "levelColor": "#419B28",
                        "defaultLevel": false
                    }
                },
                {
                    "skill": {
                        "id": "9007657690122438304",
                        "skillName": "QA"
                    },
                    "level": {
                        "id": "2845444854505357930",
                        "levelName": "Advanced",
                        "levelColor": "#419B28",
                        "defaultLevel": false
                    }
                },
                {
                    "skill": {
                        "id": "5423046373371626385",
                        "skillName": "JIRA"
                    },
                    "level": {
                        "id": "8309150234355319522",
                        "levelName": "Intermediate",
                        "levelColor": "#FCA800",
                        "defaultLevel": true
                    }
                },
                {
                    "skill": {
                        "id": "495820420823861967",
                        "skillName": "TEST CASES"
                    },
                    "level": {
                        "id": "8309150234355319522",
                        "levelName": "Intermediate",
                        "levelColor": "#FCA800",
                        "defaultLevel": true
                    }
                },
                {
                    "skill": {
                        "id": "5159432958879026484",
                        "skillName": "TEST PLAN"
                    },
                    "level": {
                        "id": "7372549001497429227",
                        "levelName": "Basic",
                        "levelColor": "#C2D2E8",
                        "defaultLevel": false
                    }
                }
            ]
        },
        {
            "id": "4759616025136811794",
            "involvement": 4,
            "personPosition": {
                "id": "3712124335976172354",
                "positionNameLong": "Consultant",
                "positionDescription": null
            },
            "userRealName": "Bob Robinson",
            "email": "bob.robinson@company.com",
            "enabled": true,
            "username": "bob.robinson",
            "skills": [
                {
                    "skill": {
                        "id": "6393636176441000868",
                        "skillName": "CONSULTING"
                    },
                    "level": {
                        "id": "7372549001497429227",
                        "levelName": "Basic",
                        "levelColor": "#C2D2E8",
                        "defaultLevel": false
                    }
                },
                {
                    "skill": {
                        "id": "6433704713829763909",
                        "skillName": "EMAIL"
                    },
                    "level": {
                        "id": "8309150234355319522",
                        "levelName": "Intermediate",
                        "levelColor": "#FCA800",
                        "defaultLevel": true
                    }
                },
                {
                    "skill": {
                        "id": "2081234984920762007",
                        "skillName": "COMMUNICATION"
                    },
                    "level": {
                        "id": "2845444854505357930",
                        "levelName": "Advanced",
                        "levelColor": "#419B28",
                        "defaultLevel": false
                    }
                }
            ]
        },
        {
            "id": "2612086174493854452",
            "involvement": 8,
            "personPosition": null,
            "userRealName": "Janny Miller",
            "email": "janny.miller@company.com",
            "enabled": true,
            "username": "janny.miller",
            "skills": [
                {
                    "skill": {
                        "id": "4881094816891751527",
                        "skillName": "DESIGN"
                    },
                    "level": {
                        "id": "7372549001497429227",
                        "levelName": "Basic",
                        "levelColor": "#C2D2E8",
                        "defaultLevel": false
                    }
                },
                {
                    "skill": {
                        "id": "2918480463760540781",
                        "skillName": "PHOTOSHOP"
                    },
                    "level": {
                        "id": "8309150234355319522",
                        "levelName": "Intermediate",
                        "levelColor": "#FCA800",
                        "defaultLevel": true
                    }
                }
            ]
        }
    ]
}


status 401 Returns if user was not logged in

status 403 Returns if user didn't have permissions

status 500 Returns if errors occurred during request


POST /rest/api/1/team?auth-token=YOUR_AUTH_TOKEN (since v10.8.0)

Create a Team in ActivityTimeline.


Request 

POST /rest/api/1/team?auth-token=YOUR_AUTH_TOKEN


QUERY PARAMETERS

Parameter

Type

Description

name *

string

Name for the new team. Must be unique.

members *

string

Comma separated list of usernames (accountIds for Jira Cloud) that should be added as team members.
Example: members=username1,username2,username3

* indicates required parameters


Example 

https://<ACTIVITYTIMELINE_INSTANCE>/rest/api/1/team?auth_token=YOUR_AUTH_TOKEN


Responses


status 200 application/json Returns json representation of the result along with id of a newly created team if request performed successfully.

Example

{
    "id": "235434507732947945188",
    "message": "Team has been successfully created."
}


status 400 Returns if invalid input parameters of the team already exists.

status 401 Returns if user was not logged in

status 403 Returns if user didn't have permissions

status 500 Returns if errors occurred during request


DELETE /rest/api/1/team/$id?auth-token=YOUR_AUTH_TOKEN

Deletes team.


Request

DELETE /rest/api/1/team/$id?auth-token=YOUR_AUTH_TOKEN


QUERY PARAMETERS

Parameter

Type

Description

id *

long

id of team

  • indicates required parameters

Example

http://<ACTIVITYTIMELINE_INSTANCE>/rest/api/1/team/2782591321647696504?auth_token=YOUR_AUTH_TOKEN


Responses


status 200 application/json Returns success message.

Example

{
    "message": "Team successfully deleted"
}


status 400 Returns if incorrect input parameters were supplied

status 401 Returns if user was not logged in

status 403 Returns if user didn't have permissions

status 500 Returns if errors occurred during request


POST /rest/api/1/team/$id/member?auth-token=YOUR_AUTH_TOKEN

Add user to the team.


Request 

POST /rest/api/1/team/$id/member?auth-token=YOUR_AUTH_TOKEN


QUERY PARAMETERS

Parameter

Type

Description

id *

long

Id of team

username *

string

Username of user who will be added to the team

* indicates required parameters


Example 

http://<ACTIVITYTIMELINE_INSTANCE>/rest/api/1/team/2782591321647696504/member?auth_token=YOUR_AUTH_TOKEN&username=admin


Responses


status 200 application/json Returns success message.

Example

{
	'message':'User successfully added to Team [BP] Business Project Team'
}


status 400 Returns if incorrect input parameters were supplied

status 401 Returns if user was not logged in

status 403 Returns if user didn't have permissions

status 500 Returns if errors occurred during request


DELETE /rest/api/1/team/$id/member?auth-token=YOUR_AUTH_TOKEN

Remove user from the team.


Request 

DELETE /rest/api/1/team/$id/member?auth-token=YOUR_AUTH_TOKEN


QUERY PARAMETERS

Parameter

Type

Description

id *

long

id of team

username *

string

Username of user who will be removed from the team

* indicates required parameters


Example 

http://<ACTIVITYTIMELINE_INSTANCE>/rest/api/1/team/2782591321647696504/member?auth_token=YOUR_AUTH_TOKEN&username=admin


Responses


status 200 application/json Returns success message.

Example

{
	'message':'User successfully removed from Team [BP] Business Project  Team'
}


status 400 Returns if incorrect input parameters were supplied

status 401 Returns if user was not logged in

status 403 Returns if user didn't have permissions

status 500 Returns if errors occurred during request


GET /rest/api/1/team/$id/manager?auth-token=YOUR_AUTH_TOKEN

Get the list of team managers.


Request 

GET /rest/api/1/team/$id/manager?auth-token=YOUR_AUTH_TOKEN


QUERY PARAMETERS

Parameter

Type

Description

id *

long

id of team

* indicates required parameters


Example 

http://<ACTIVITYTIMELINE_INSTANCE>/rest/api/1/team/2782591321647696504/manager?auth_token=YOUR_AUTH_TOKEN


Responses


status 200 application/json Returns success message.

Example

[{
    "fullName": "Administrator",
    "username": "admin"
}]


status 400 Returns if incorrect input parameters were supplied

status 401 Returns if user was not logged in

status 403 Returns if user didn't have permissions

status 500 Returns if errors occurred during request


POST /rest/api/1/team/$id/manager?auth-token=YOUR_AUTH_TOKEN

Add team manager to the team.


Request 

POST /rest/api/1/team/$id/manager?auth-token=YOUR_AUTH_TOKEN


QUERY PARAMETERS

Parameter

Type

Description

id *

long

id of team

username *

string

Username of user who will be added to the team managers

* indicates required parameters


Example 

http://<ACTIVITYTIMELINE_INSTANCE>/rest/api/1/team/2782591321647696504/manager?auth_token=YOUR_AUTH_TOKEN&username=admin


Responses


status 200 application/json Returns success message.

Example

{
    "message": "User successfully added to Team Managers"
}


status 400 Returns if incorrect input parameters were supplied

status 401 Returns if user was not logged in

status 403 Returns if user didn't have permissions

status 500 Returns if errors occurred during request



DELETE /rest/api/1/team/$id/manager?auth-token=YOUR_AUTH_TOKEN

Remove user from the team managers.


Request

DELETE /rest/api/1/team/$id/manager?auth-token=YOUR_AUTH_TOKEN


QUERY PARAMETERS

Parameter

Type

Description

id *

long

id of team

username *

string

Username of user who will be removed from the team managers

* indicates required parameters


Example 

http://<ACTIVITYTIMELINE_INSTANCE>/rest/api/1/team/2782591321647696504/manager?auth_token=YOUR_AUTH_TOKEN&username=admin


Responses


status 200 application/json Returns success message.

Example

{
    "message": "User successfully removed from Team Managers."
}


status 400 Returns if incorrect input parameters were supplied

status 401 Returns if user was not logged in

status 403 Returns if user didn't have permissions

status 500 Returns if errors occurred during request



Projects    v8.3.0+

GET /rest/api/1/project/list?auth-token=YOUR_AUTH_TOKEN

Returns list of Activity Timeline projects by portions of 100.


Request 

GET /rest/api/1/project/list?auth-token=YOUR_AUTH_TOKEN


QUERY PARAMETERS

Parameter

Type

Description

startOffset

integer

Offset for the first project, default is 0

state v9.2.0+

string

If specified then only projects of specified state will be returned. Should be either "active" or "inactive"

* indicates required parameters


Responses

status 200  application/json Returns json representation of the result if request performed successfully.

Example

[{
    "id": 230762418407883660,
    "name": "Sprint project",
    "projectKey": "SPRINT",
    "state": "inactive"
}, {
    "id": 385656806786155406,
    "name": "Agile adaptation",
    "projectKey": "AGILE",
    "state": "active"
}, {
    "id": 466697191147325533,
    "name": "New Features Proj",
    "projectKey": "NFP",
    "state": "active"
},  {
    "id": 847848775082921846,
    "name": "Project Managment",
    "projectKey": "PM",
    "state": "active"
},  {
    "id": 1074321572696248313,
    "name": "Automation Project",
    "projectKey": "AP",
    "state": "active"
}, {
    "id": 1414612396227578312,
    "name": "Business Project ",
    "projectKey": "BP",
    "state": "active"
}]

status 401 Returns if user was not logged in

status 403 Returns if user didn't have permissions

status 500 Returns if errors occurred during request


POST /rest/api/1/project/$id/state?auth-token=YOUR_AUTH_TOKEN

Change the project state between active (enabled in the app) and inactive (disabled in the app).


Request 

POST /rest/api/1/project/$id/state?auth-token=YOUR_AUTH_TOKEN


QUERY PARAMETERS

Parameter

Type

Description

id *

long

id of project

state *

string

Project state. Should be either "active" or "inactive"

* indicates required parameters

Example

http://<ACTIVITYTIMELINE_INSTANCE>/rest/api/1/project/1074321572696248313/state?auth_token=YOUR_AUTH_TOKEN&state=inactive


Responses


status 200 application/json Returns success message.

Example

{
    "message": "Project successfully updated",
    "projectId": "1074321572696248313",
    "state": "inactive"
}


status 400 Returns if incorrect input parameters were supplied

status 401 Returns if user was not logged in

status 403 Returns if user didn't have permissions

status 500 Returns if errors occurred during request



Users    v8.3.0+

GET /rest/api/1/user?auth-token=YOUR_AUTH_TOKEN

Get paginated user list. Returns 100 users.


Request 

GET /rest/api/1/user?auth-token=YOUR_AUTH_TOKEN


QUERY PARAMETERS

Parameter

Type

Description

startOffset *

string

Offset for first user, default is 0

  • indicates required parameters


Example 

http://<ACTIVITYTIMELINE_INSTANCE>/rest/api/1/user?auth_token=YOUR_AUTH_TOKEN


Responses


status 200 application/json Returns created event id and new assignee username.

Example

[{
    "fullName": "Administrator",
    "username": "admin"
}, {
    "fullName": "Anna Jons",
    "username": "anna"
}, {
    "fullName": "Erik Plain",
    "username": "erik"
}]


status 400 Returns if incorrect input parameters were supplied

status 401 Returns if user was not logged in

status 403 Returns if user didn't have permissions

status 500 Returns if errors occurred during request


GET /rest/api/1/user/$username?auth-token=YOUR_AUTH_TOKEN

Get detailed user data.


Request 

GET /rest/api/1/user/$username?auth-token=YOUR_AUTH_TOKEN


QUERY PARAMETERS

Parameter

Type

Description

username *

string

Username or accountId of specific user

* indicates required parameters


Example 

http://<ACTIVITYTIMELINE_INSTANCE>/rest/api/1/user/admin?auth_token=YOUR_AUTH_TOKEN


Responses


status 200 application/json Returns created event id and new assignee username.

Example

{
    "fullName": "Administrator",
    "position": {
        "id": 6343917500869986762,
        "positionDescription": null,
        "positionNameLong": "Developer"
    },
    "skillLevels": [{
        "level": {
            "defaultLevel": false,
            "id": 3239422491610663746,
            "levelColor": "#FCA800",
            "levelName": "Intermediate"
        },
        "skill": {
            "id": "5038994036906348198",
            "skillName": "JAVA"
        }
    }],
    "username": "admin"
}


status 400 Returns if incorrect input parameters were supplied

status 401 Returns if user was not logged in

status 403 Returns if user didn't have permissions

status 500 Returns if errors occurred during request


GET /rest/api/1/user/$username/role?auth-token=YOUR_AUTH_TOKEN (since v11.8)

Get specific user’s role.


Request 

GET /rest/api/1/user/$username/role?auth-token=YOUR_AUTH_TOKEN


QUERY PARAMETERS

Parameter

Type

Description

username *

string

Username or accountId of specific user

* indicates required parameters


Example 

http://<ACTIVITYTIMELINE_INSTANCE>/rest/api/1/user/johnsmith/role?auth_token=YOUR_AUTH_TOKEN


Responses


status 200 application/json Returns created event id and new assignee username.

Example

{
  "username": "johnsmith",
  "fullName": "John Smith",
  "roles": [
    {
      "role": "Administrator"
      "type": "role"
    }
  ]
}


status 400 Returns if incorrect input parameters were supplied

status 401 Returns if user was not logged in

status 403 Returns if user didn't have permissions

status 500 Returns if errors occurred during request


POST /rest/api/1/user/$username/role?auth_token=YOUR_AUTH_TOKEN (since v11.8)

Set a new role or restriction to user.


Request

POST /rest/api/1/user/$username/role?auth-token=YOUR_AUTH_TOKEN


QUERY PARAMETERS

Parameter

Type

Description

username *

string

Username or accountId of specific user

role *

string

New user role or restriction. It removes all other roles and sets the new one but keeping previous user’s restrictions if any applied.

managedTeamId *

long

Required only for Team Lead and Power Team Lead roles

If specified then this user will be added to the list of managers of that team. All previously managed teams of this user will be preserved.

  • indicates required parameters


Example

http://<ACTIVITYTIMELINE_INSTANCE>/rest/api/1/user/johnsmith/role?auth_token=YOUR_AUTH_TOKEN&role=Semi Read Only


Responses


status 200 application/json Returns created event id and new assignee username.

Example

{
    "message": "Role successfully set to the user.",
    "username": "johnsmith"
}


status 400 Returns if incorrect input parameters were supplied

status 401 Returns if user was not logged in

status 403 Returns if user didn't have permissions

status 500 Returns if errors occurred during request


DELETE /rest/api/1/user/$username/role?auth_token=YOUR_AUTH_TOKEN (since v11.8)

Removes role or restriction from a user.


Request

DELETE /rest/api/1/user/$username/role?auth_token=YOUR_AUTH_TOKEN


QUERY PARAMETERS

Parameter

Type

Description

username *

string

Username or accountId of specific user

role

string

Optional

To delete a restriction, the role parameter must be provided with one of the following values: Read Only or Semi Read Only (If you’re removing an actual role (not a restriction), there’s no need to specify this parameter)

  • indicates required parameters


Example

http://<ACTIVITYTIMELINE_INSTANCE>/rest/api/1/user/johnsmith/role?auth_token=YOUR_AUTH_TOKEN&role=Semi Read Only


Responses


status 200 application/json Returns created event id and new assignee username.

Example

{
    "message": "Role successfully removed from user.",
    "username": "johnsmith"
}


status 400 Returns if incorrect input parameters were supplied

status 401 Returns if user was not logged in

status 403 Returns if user didn't have permissions

status 500 Returns if errors occurred during request


GET /rest/api/1/user/role/list?auth_token=YOUR_AUTH_TOKEN (since v11.8)

Returns a list of available user roles and restrictions.


Request

GET /rest/api/1/user/role/list?auth_token=YOUR_AUTH_TOKEN


Example

http://<ACTIVITYTIMELINE_INSTANCE>/rest/api/1/user/role/list?auth_token=YOUR_AUTH_TOKEN


Responses


status 200 application/json Returns created event id and new assignee username.

Example

{
    "roles": [
        {
            "role": "Administrator",
            "type": "role"
        },
        {
            "role": "Manager",
            "type": "role"
        },
        {
            "role": "Power Team Lead",
            "type": "role"
        },
        {
            "role": "Team Lead",
            "type": "role"
        },
        {
            "role": "Power Employee",
            "type": "role"
        },
        {
            "role": "Employee",
            "type": "role"
        },
        {
            "role": "Limited Employee",
            "type": "role"
        },
        {
            "role": "No Access",
            "type": "role"
        },
        {
            "role": "Semi Read Only",
            "type": "restriction"
        },
        {
            "role": "Read Only",
            "type": "restriction"
        }
    ]
}


status 400 Returns if incorrect input parameters were supplied

status 401 Returns if user was not logged in

status 403 Returns if user didn't have permissions

status 500 Returns if errors occurred during request


GET /rest/api/1/user/$username/skill?auth-token=YOUR_AUTH_TOKEN

Get user's skills.


Request

GET /rest/api/1/user/$username/skill?auth-token=YOUR_AUTH_TOKEN


QUERY PARAMETERS

Parameter

Type

Description

username *

string

Username or accountId of specific user

  • indicates required parameters


Example 

http://<ACTIVITYTIMELINE_INSTANCE>/rest/api/1/user/admin/skill?auth_token=YOUR_AUTH_TOKEN


Responses


status 200 application/json Returns created event id and new assignee username.

Example

[{
    "level": {
        "defaultLevel": false,
        "id": 3239422491610663746,
        "levelColor": "#FCA800",
        "levelName": "Intermediate"
    },
    "skill": {
        "id": "5038994036906348198",
        "skillName": "JAVA"
    }
}]


status 400 Returns if incorrect input parameters were supplied

status 401 Returns if user was not logged in

status 403 Returns if user didn't have permissions

status 500 Returns if errors occurred during request


DELETE /rest/api/1/user/$username/skill?auth-token=YOUR_AUTH_TOKEN

Remove all skills from the user.


Request 

DELETE /rest/api/1/user/$username/skill?auth-token=YOUR_AUTH_TOKEN


QUERY PARAMETERS

Parameter

Type

Description

username *

string

Username or accountId of specific user

  • indicates required parameters


Example 

http://<ACTIVITYTIMELINE_INSTANCE>/rest/api/1/user/admin/skill?auth_token=YOUR_AUTH_TOKEN


Responses


status 200 application/json Returns created event id and new assignee username.

Example

{
    "message": "Skills successfully removed from user.",
    "username": "admin"
}


status 400 Returns if incorrect input parameters were supplied

status 401 Returns if user was not logged in

status 403 Returns if user didn't have permissions

status 500 Returns if errors occurred during request


POST /rest/api/1/user/$username/skill/$skillId?auth-token=YOUR_AUTH_TOKEN

Assign a skill to user.


Request

POST /rest/api/1/user/$username/skill/$skillId?auth-token=YOUR_AUTH_TOKEN


QUERY PARAMETERS

Parameter

Type

Description

username *

string

Username or accountId of specific user

skillId

long

Skill ID

levelId

long

Level for assigned skill

  • indicates required parameters


Example 

http://<ACTIVITYTIMELINE_INSTANCE>/rest/api/1/user/admin/skill/356054081858522338?auth_token=YOUR_AUTH_TOKEN


Responses


status 200 application/json Returns created event id and new assignee username.

Example

{
    "message": "Skill successfully assigned to user.",
    "skillId": 356054081858522338,
    "username": "admin"
}


status 400 Returns if incorrect input parameters were supplied

status 401 Returns if user was not logged in

status 403 Returns if user didn't have permissions

status 500 Returns if errors occurred during request


DELETE /rest/api/1/user/$username/skill/$skillId?auth-token=YOUR_AUTH_TOKEN

Remove a skill from the user.


Request 

DELETE /rest/api/1/user/$username/skill/$skillId?auth-token=YOUR_AUTH_TOKEN


QUERY PARAMETERS

Parameter

Type

Description

username *

string

Username or accountId of specific user

skillId

long

Skill ID

  • indicates required parameters


Example 

http://<ACTIVITYTIMELINE_INSTANCE>/rest/api/1/user/admin/skill/356054081858522338?auth_token=YOUR_AUTH_TOKEN


Responses


status 200 application/json Returns created event id and new assignee username.

Example

{
    "message": "Skill successfully removed from user.",
    "username": "admin"
}


status 400 Returns if incorrect input parameters were supplied

status 401 Returns if user was not logged in

status 403 Returns if user didn't have permissions

status 500 Returns if errors occurred during request


POST /rest/api/1/user/$username/position?auth-token=YOUR_AUTH_TOKEN

Add a position for the user.


Request 

POST /rest/api/1/user/$username/position?auth-token=YOUR_AUTH_TOKEN


QUERY PARAMETERS

Parameter

Type

Description

username *

string

Username or accountId of specific user

positionId

long

Position D

* indicates required parameters


Example 

http://<ACTIVITYTIMELINE_INSTANCE>/rest/api/1/user/admin/position?positionId=8219751323950402194&auth_token=YOUR_AUTH_TOKEN

Responses


status 200 application/json Returns created event id and new assignee username.

Example

{
    "message": "Position successfully assigned to user",
    "username": "admin",
    "positionId": 8219751323950402194
}


status 400 Returns if incorrect input parameters were supplied

status 401 Returns if user was not logged in

status 403 Returns if user didn't have permissions

status 500 Returns if errors occurred during request


DELETE /rest/api/1/user/$username/position?auth-token=YOUR_AUTH_TOKEN

Remove position from a user.


Request 

DELETE /rest/api/1/user/$username/position?auth-token=YOUR_AUTH_TOKEN


QUERY PARAMETERS

Parameter

Type

Description

username *

string

Username or accountId of specific user

positionId

long

Position Id

* indicates required parameters


Example 

http://<ACTIVITYTIMELINE_INSTANCE>/rest/api/1/user/admin/position?positionId=8219751323950402194&auth_token=YOUR_AUTH_TOKEN


Responses


status 200 application/json Returns created event id and new assignee username.

Example

{
    "message": "Position successfully removed from user",
    "positionId": 8219751323950402194
}


status 400 Returns if incorrect input parameters were supplied

status 401 Returns if user was not logged in

status 403 Returns if user didn't have permissions

status 500 Returns if errors occurred during request



Skills    v8.3.0+

POST /rest/api/1/skill?auth-token=YOUR_AUTH_TOKEN

Creates a new skill.


Request

POST /rest/api/1/skill?auth-token=YOUR_AUTH_TOKEN


QUERY PARAMETERS

Parameter

Type

Description

name *

string

Skill name

* indicates required parameters


Example 

http://<ACTIVITYTIMELINE_INSTANCE>/rest/api/1/skill?name=skillName&auth_token=YOUR_AUTH_TOKEN


Responses


status 200 application/json Returns created event id and new assignee username.

Example

{
    "message": "Skill SKILL_NAME successfully created!",
    "skillId": 2217128537518329713
}


status 400 Returns if incorrect input parameters were supplied

status 401 Returns if user was not logged in

status 403 Returns if user didn't have permissions

status 500 Returns if errors occurred during request


GET /rest/api/1/skill?auth-token=YOUR_AUTH_TOKEN

Get paginated list of skills. Returns 100 skills


Request 

GET /rest/api/1/skill?auth-token=YOUR_AUTH_TOKEN


QUERY PARAMETERS

Parameter

Type

Description

startOffset

int

Offset for the first skill, default is 0

* indicates required parameters


Example 

http://<ACTIVITYTIMELINE_INSTANCE>/rest/api/1/skill?startOffSet=0&auth_token=YOUR_AUTH_TOKEN


Responses


status 200 application/json Returns created event id and new assignee username.

Example

[{
    "id": "356054081858522338",
    "skillName": "API"
}, {
    "id": "2047937836421629992",
    "skillName": "JS"
}, {
    "id": "2698045061671109178",
    "skillName": "CSS"
}, {
    "id": "3109049378266500399",
    "skillName": "SQL"
},  {
    "id": "5038994036906348198",
    "skillName": "JAVA"
}]


status 401 Returns if user was not logged in

status 403 Returns if user didn't have permissions

status 500 Returns if errors occurred during request


GET /rest/api/1/skill/$id?auth-token=YOUR_AUTH_TOKEN

Get skill by Id.


Request 

GET /rest/api/1/skill/$id?auth-token=YOUR_AUTH_TOKEN


QUERY PARAMETERS

Parameter

Type

Description

id

long

Skill Id

  • indicates required parameters


Example 

http://<ACTIVITYTIMELINE_INSTANCE>/rest/api/1/skill/5038994036906348198?auth_token=YOUR_AUTH_TOKEN


Responses


status 200application/json Returns updated worklog.

Example

[{
    "level": {
        "id": 3239422491610663746,
        "levelName": "Intermediate"
    },
    "skill": {
        "id": "5038994036906348198",
        "skillName": "JAVA"
    },
    "users": [{
        "fullName": "Administrator",
        "username": "admin"
    }, {
        "fullName": "Erik Jons",
        "username": "erik"
    }]
}, {
    "level": {
        "id": 149100742758843112,
        "levelName": "Advanced"
    },
    "skill": {
        "id": "5038994036906348198",
        "skillName": "JAVA"
    },
    "users": [{
        "fullName": "Ana Lee",
        "username": "anna"
    }]
}]


status 400 Returns if incorrect input parameters were supplied

status 401 Returns if user was not logged in

status 403 Returns if user didn't have permissions

status 500 Returns if errors occurred during request


POST /rest/api/1/skill/level?auth-token=YOUR_AUTH_TOKEN

Creates a new skill proficiency level.


Request 

POST /rest/api/1/skill/level?auth-token=YOUR_AUTH_TOKEN


QUERY PARAMETERS

Parameter

Type

Description

name *

string

Skill proficiency level name

isDefault

boolean

Should it be the default proficiency level for new skills?

color *

string

Level color to display (HEX format), without hash symbol

* indicates required parameters


Example 

http://<ACTIVITYTIMELINE_INSTANCE>/rest/api/1/skill/level?name=Expert&color=FCA800&auth_token=YOUR_AUTH_TOKEN


Responses


status 200application/json Returns updated worklog.

Example

{
    "message": "Level Expert successfully created!",
    "levelId": 8468734445048317988
}


status 400 Returns if incorrect input parameters were supplied

status 401 Returns if user was not logged in

status 403 Returns if user didn't have permissions

status 500 Returns if errors occurred during request


GET /rest/api/1/skill/level?auth-token=YOUR_AUTH_TOKEN

Get paginated list of skill proficiency levels. Returns 100 skill levels


Request 

GET /rest/api/1/skill/level?auth-token=YOUR_AUTH_TOKEN


QUERY PARAMETERS

Parameter

Type

Description

startOffset

int

Offset for the first level, default is 0

* indicates required parameters


Example 

http://<ACTIVITYTIMELINE_INSTANCE>/rest/api/1/skill/level?auth_token=YOUR_AUTH_TOKEN
 


Responses


status 200application/json Returns updated worklog.

Example

[{
    "defaultLevel": false,
    "id": 149100742758843112,
    "levelColor": "#419B28",
    "levelName": "Advanced"
}, {
    "defaultLevel": false,
    "id": 2281499161498896296,
    "levelColor": "#03439C",
    "levelName": "Basic"
}, {
    "defaultLevel": false,
    "id": 3239422491610663746,
    "levelColor": "#FCA800",
    "levelName": "Intermediate"
}, {
    "defaultLevel": true,
    "id": 4033501717766817092,
    "levelColor": "#FCA800",
    "levelName": "Low"
}, {
    "defaultLevel": null,
    "id": 8468734445048317988,
    "levelColor": "#FCA800",
    "levelName": "Expert"
}]


status 400 Returns if incorrect input parameters were supplied

status 401 Returns if user was not logged in

status 403 Returns if user didn't have permissions

status 500 Returns if errors occurred during request




Positions   v8.3.0+

POST /rest/api/1/position?auth-token=YOUR_AUTH_TOKEN

Creates a new user position.


Request 

POST /rest/api/1/position?auth-token=YOUR_AUTH_TOKEN


QUERY PARAMETERS

Parameter

Type

Description

name *

string

User position name

* indicates required parameters


Example 

http://<ACTIVITYTIMELINE_INSTANCE>/rest/api/1/position?name=Manager&auth_token=YOUR_AUTH_TOKEN


Responses


status 200application/json Returns updated worklog.

Example

{
    "message": "Position Manager successfully created!",
    "positionId": 3000053725301066422
}


status 400 Returns if incorrect input parameters were supplied

status 401 Returns if user was not logged in

status 403 Returns if user didn't have permissions

status 500 Returns if errors occurred during request


GET /rest/api/1/position?auth-token=YOUR_AUTH_TOKEN

Get paginated list of positions. Returns 100 positions


Request 

GET /rest/api/1/position?auth-token=YOUR_AUTH_TOKEN


QUERY PARAMETERS

Parameter

Type

Description

startOffset

int

Offset for the first position, default is 0

* indicates required parameters


Example 

http://<ACTIVITYTIMELINE_INSTANCE>/rest/api/1/position?auth_token=YOUR_AUTH_TOKEN


Responses


status 200application/json Returns updated worklog.

Example

[{
    "id": 3000053725301066422,
    "positionDescription": "",
    "positionNameLong": "Manager"
}, {
    "id": 6265207833807701265,
    "positionDescription": "",
    "positionNameLong": "CEO"
}, {
    "id": 6343917500869986762,
    "positionDescription": null,
    "positionNameLong": "Developer"
}, {
    "id": 7828428543988420376,
    "positionDescription": null,
    "positionNameLong": "QA"
}, {
    "id": 8219751323950402194,
    "positionDescription": "",
    "positionNameLong": "Tester"
}]


status 400 Returns if incorrect input parameters were supplied

status 401 Returns if user was not logged in

status 403 Returns if user didn't have permissions

status 500 Returns if errors occurred during request


GET /rest/api/1/position/$id?auth-token=YOUR_AUTH_TOKEN

Get user position by ID


Request 

GET /rest/api/1/position/$id?auth-token=YOUR_AUTH_TOKEN


QUERY PARAMETERS

Parameter

Type

Description

id

long

Position ID

* indicates required parameters


Example 

http://<ACTIVITYTIMELINE_INSTANCE>/rest/api/1/position/5038994036906348198?auth_token=YOUR_AUTH_TOKEN


Responses


status 200application/json Returns updated worklog.

Example

{
   "id": 6343917500869986762,
   "persons": [{
        "fullName": "Administrator",
        "username": "admin"
         }],
   "positionDescription": null,
   "positionNameLong": "Developer"
}


status 400 Returns if incorrect input parameters were supplied

status 401 Returns if user was not logged in

status 403 Returns if user didn't have permissions

status 500 Returns if errors occurred during request

Worklogs   V8.3.0+

POST /rest/api/1/worklog?auth-token=YOUR_AUTH_TOKEN

Add work log for current user or on behalf of other user.


Request 

POST /rest/api/1/worklog?auth-token=YOUR_AUTH_TOKEN


QUERY PARAMETERS

Parameter

Type

Description

date *

string

Log work date in "yyyy-MM-dd HH:mm:ss Z" format.

Example: "2025-06-30 14:30:00 +0000”, "2025-06-30 14:30:00 -0700”

username *

string

Username (Jira Server) or accountId (Jira Cloud) of the user who logs work hours

issueKey *

string

issueKey of issue

timeSpent *

string

The time spent working on the issue.
Examples:"1h", "4h 30m", "30m”

comment

string

A comment for the worklog

category

number

Worklog category. Default: Billable (“0”).
 If not specified, returns worklogs from all categories. If specified, returns worklogs of that category only.

attribute_{attribute_id}

string

Available from v11.4.0 . This dynamic parameter allows setting a custom attribute value for the newly created worklog. The {attribute_id} part should be replaced with the unique ID of the worklog attribute configured in the system.

For checkbox input types:

Use true for checked

Use false for unchecked

For select input types:

Use the option key (not the label or value) to represent the selected choice.

You can pass multiple such parameters to assign values to multiple attributes.

* indicates required parameters


Example 

https://<ACTIVITYTIMELINE_INSTANCE>/rest/api/1/worklog?username=Adam&date=2021-04-15 01:14:00 %2B0300&issueKey=KAN-175&timeSpent=1h&auth_token=YOUR_AUTH_TOKEN&attribute_81501614300284212=1

Responses


status 200application/json Returns updated worklog.

Example

{
    "approved": false,
    "approvedBy": "",
    "category": 0,
    "comment": "worklog comment",
    "date": "2021-04-15T01:14:00.000+03:00",
    "issueId": 12597,
    "issueKey": "KAN-175",
    "projectKey": "KAN",
    "timeSpent": 3600,
    "username": "557058:af2f543d-d6f7-4abc-a673-12355112323",
    "worklogId": 11667,
    "attributes": {
        "81501614300284212": "1"
    }
}

 

status 400 Returns if incorrect input parameters were supplied

status 401 Returns if user was not logged in

status 403 Returns if user didn't have permissions

status 500 Returns if errors occurred during request


PUT /rest/api/1/worklog/$id?auth-token=YOUR_AUTH_TOKEN

Updates existing worklog record.


Request 

PUT /rest/api/1/worklog/$id?auth-token=YOUR_AUTH_TOKEN


QUERY PARAMETERS

Parameter

Type

Description

id *

long

Jira’s Worklog id

date

string

Log work date in "yyyy-MM-dd HH:mm:ss Z" format.

Example: "2025-06-30 14:30:00 +0000”, "2025-06-30 14:30:00 -0700”

username *

string

Username (Jira Server) or accountId (Jira Cloud) of the user who updates worklog

timeSpent

string

The time spent working on the issue.

comment

string

A comment for the worklog

category

number

Worklog category. Default: Billable (“0”).
 If not specified, returns worklogs from all categories. If specified, returns worklogs of that category only.

attribute_{attribute_id}

string

Available from v11.4.0 . This dynamic parameter is used to update the value of a custom attribute associated with an existing worklog entry. The {attribute_id} must match the unique ID of a predefined worklog attribute in the system.

  • For checkbox input types:

    • Use true for checked

    • Use false for unchecked

  • For select input types:

    • Use the option key (not the label or value) to represent the selected choice.

Any attribute_{attribute_id} parameters included in the request will update the corresponding attribute values of the target worklog.

* indicates required parameters


Example 

http://<ACTIVITYTIMELINE_INSTANCE>/rest/api/1/worklog/11667?username=Adam&date=2021-04-15 01:14:00 %2B0300&issueKey=KAN-175&timeSpent=1h&auth_token=YOUR_AUTH_TOKEN&attribute_81501614300284212=1


Responses


status 200application/json Returns updated worklog.

Example

{
    "approved": false,
    "approvedBy": "",
    "category": 0,
    "comment": "",
    "date": "2021-04-15T01:14:00.000+03:00",
    "issueId": 12597,
    "issueKey": "KAN-175",
    "projectKey": "KAN",
    "timeSpent": 3600,
    "username": "557058:af2f543d-d6f7-4abc-a673-12355112323",
    "worklogId": 11667,
    "attributes": {
        "81501614300284212": "1"
    }
}

 

status 400 Returns if incorrect input parameters were supplied

status 401 Returns if user was not logged in

status 403 Returns if user didn't have permissions

status 500 Returns if errors occurred during request


DELETE /rest/api/1/worklog/$id?auth-token=YOUR_AUTH_TOKEN

Deletes a worklog record.


Request 

DELETE /rest/api/1/worklog/$id?auth-token=YOUR_AUTH_TOKEN


QUERY PARAMETERS

Parameter

Type

Description

id *

long

Jira’s Worklog id

* indicates required parameters


Example 

http://<ACTIVITYTIMELINE_INSTANCE>/rest/api/1/worklog/312463?auth_token=YOUR_AUTH_TOKEN


Responses


status 200application/json Returns updated worklog.

Example

{
	"message":"Worklog has been successfully deleted!"
}


status 400 Returns if incorrect input parameters were supplied

status 401 Returns if user was not logged in

status 403 Returns if user didn't have permissions

status 500 Returns if errors occurred during request


GET /rest/api/1/worklog/$id?auth-token=YOUR_AUTH_TOKEN (since v10.8.0+)

Retrieve existing worklog record.


Request 

GET /rest/api/1/worklog/$id?auth-token=YOUR_AUTH_TOKEN


QUERY PARAMETERS

Parameter

Type

Description

id *

long

Jira’s Worklog id

* indicates required parameters


Example 

https://<ACTIVITYTIMELINE_INSTANCE>/rest/api/1/worklog/31667?auth_token=YOUR_AUTH_TOKEN


Responses


status 200application/json Returns updated worklog.

Example

{
    "approved": false,
    "approvedBy": "",
    "category": 0,
    "comment": "My worklog comment",
    "date": "2025-01-15T01:14:00.000+03:00",
    "issueId": 32597,
    "issueKey": "KAN-275",
    "projectKey": "KAN",
    "timeSpent": 3600,
    "username": "557058:af2f543d-d6f7-4abc-a673-12355112323",
    "worklogId": 31667
}


status 400 Returns if incorrect input parameters were supplied

status 401 Returns if user was not logged in

status 404 Returns if worklog does not exist


GET /rest/api/1/worklog/list?auth-token=YOUR_AUTH_TOKEN

Return a list of worklog records. Maximum 1000 worklog records per request.

Pass startOffset parameter to load the next portions of worklog records.



Request 

GET /rest/api/1/worklog/list?auth-token=YOUR_AUTH_TOKEN


QUERY PARAMETERS

Parameter

Type

Description

start *

string

Start of the period formatted in "yyyy-MM-dd" format

end *

string

End of the period formatted in "yyyy-MM-dd" format

username

string

Username or Accountld of specific user.
If specified then returns worklogs from specific user only.

teamld

long

Id of specific team.
If specified then returns worklogs of specific team members only.

projectKey

string

Project Key of Jira project.
If specified then the system would return worklogs from specific project only.

issueKey

string

V10.8.0+ Issue Key of any Jira issue like ABC-1234.
If specified then the system would return worklogs logged to the specific issue only.

startOffset

int

Offset for the first worklog in portion, default is 0.

category

byte

Worklog category. Default: Billable (“0”).
 If not specified, returns worklogs from all categories. If specified, returns worklogs of that category only.

expand

string

Available from v12.3.0 . Use

expand=attributes

to include the worklog attributes block in the response. By default, attributes are not returned.

* indicates required parameters


Example 

http://<ACTIVITYTIMELINE_INSTANCE>/rest/api/1/worklog/list?start=2021-04-12&end=2021-04-20&auth_token=YOUR_AUTH_TOKEN


Responses


status 200application/json Returns updated worklog.

Example

[{
    "approved": false,
    "approvedBy": "",
    "category": 0,
    "comment": "",
    "date": "2021-04-13T03:14:00.000+03:00",
    "issueId": 12637,
    "issueKey": "BT-11",
    "projectKey": "BT",
    "timeSpent": 7200,
    "username": "557058:009e0ad2-70b5-4b95-862c-12355112323",
    "worklogId": 11649
}, {
    "approved": false,
    "approvedBy": "",
    "category": 0,
    "comment": "",
    "date": "2021-04-14T00:00:00.000+03:00",
    "issueId": 12637,
    "issueKey": "BT-11",
    "projectKey": "BT",
    "timeSpent": 7200,
    "username": "557058:009e0ad2-70b5-4b95-862c-12355112323",
    "worklogId": 11641
}, {
    "approved": false,
    "approvedBy": "",
    "category": 0,
    "comment": "",
    "date": "2021-04-14T00:00:00.000+03:00",
    "issueId": 12707,
    "issueKey": "KAN-259",
    "projectKey": "KAN",
    "timeSpent": 7200,
    "username": "557058:009e0ad2-70b5-4b95-862c-12355112323",
    "worklogId": 11639
}, {
    "approved": false,
    "approvedBy": "",
    "category": 0,
    "comment": "",
    "date": "2021-04-14T00:00:00.000+03:00",
    "issueId": 12637,
    "issueKey": "BT-11",
    "projectKey": "BT",
    "timeSpent": 7200,
    "username": "557058:009e0ad2-70b5-4b95-862c-12355112323",
    "worklogId": 11640
}]


status 400 Returns if incorrect input parameters were supplied

status 401 Returns if user was not logged in

status 403 Returns if user didn't have permissions

status 500 Returns if errors occurred during request


PUT /rest/api/1/worklog/approve/$id?auth-token=YOUR_AUTH_TOKEN (since v9.7.9)

Approve a worklog record by a System.


Request 

PUT /rest/api/1/worklog/approve/$id?auth-token=YOUR_AUTH_TOKEN


QUERY PARAMETERS

Parameter

Type

Description

id *

long

Worklog id

* indicates required parameters


Example 

http://<ACTIVITYTIMELINE_INSTANCE>/rest/api/1/worklog/approve/11667?auth_token=YOUR_AUTH_TOKEN


Responses

  status 200 application/json Returns updated worklog.

Example

{
    "approved": true,
    "approvedBy": "",
    "category": 0,
    "comment": "",
    "date": "2021-04-15T01:14:00.000+03:00",
    "issueId": 12597,
    "issueKey": "KAN-175",
    "projectKey": "KAN",
    "timeSpent": 3600,
    "username": "557058:af2f543d-d6f7-4abc-a673-12355112323",
    "worklogId": 11667
}


status 400 Returns if incorrect input parameters were supplied

status 401 Returns if user was not logged in

status 403 Returns if user didn't have permissions or the Timesheets Approval process is turned off in the settings

status 404 Returns if worklog record is not found

status 500 Returns if errors occurred during request


PUT /rest/api/1/worklog/unapprove/$id?auth-token=YOUR_AUTH_TOKEN (since v9.7.9)

Unapprove a worklog record.


Request 

PUT /rest/api/1/worklog/unapprove/$id?auth-token=YOUR_AUTH_TOKEN


QUERY PARAMETERS

Parameter

Type

Description

id *

long

Worklog id

* indicates required parameters


Example 

http://<ACTIVITYTIMELINE_INSTANCE>/rest/api/1/worklog/unapprove/11667?auth_token=YOUR_AUTH_TOKEN


Responses

status 200  application/json Returns updated worklog.

Example

{
    "approved": false,
    "approvedBy": "",
    "category": 0,
    "comment": "",
    "date": "2021-04-15T01:14:00.000+03:00",
    "issueId": 12597,
    "issueKey": "KAN-175",
    "projectKey": "KAN",
    "timeSpent": 3600,
    "username": "557058:af2f543d-d6f7-4abc-a673-12355112323",
    "worklogId": 11667
}


status 400 Returns if incorrect input parameters were supplied

status 401 Returns if user was not logged in

status 403 Returns if user didn't have permissions or the Timesheets Approval process is turned off in the settings

status 404 Returns if worklog record is not found

status 500 Returns if errors occurred during request


GET /rest/api/1/worklog/categories?auth-token=YOUR_AUTH_TOKEN

Return a list of worklog categories.


Request 

GET /rest/api/1/worklog/categories?auth-token=YOUR_AUTH_TOKEN


Example

http://<ACTIVITYTIMELINE_INSTANCE>/rest/api/1/worklog/categories?auth_token=YOUR_AUTH_TOKEN


Responses

status 200  application/json Returns list of worklog categories.

Example

[{
    "active": true,
    "id": 1,
    "name": "Non-Billable"
}, {
    "active": true,
    "id": 0,
    "name": "Billable"
}]


status 400 Returns if incorrect input parameters were supplied

status 401 Returns if user was not logged in

status 403 Returns if user didn't have permissions

status 500 Returns if errors occurred during request


GET /rest/api/1/worklog/attributes?auth_token=YOUR_AUTH_TOKEN (since v11.4.0)

Get Worklog Attributes List.


Request 

GET /rest/api/1/worklog/attributes?auth_token=YOUR_AUTH_TOKEN


Example 

http://<ACTIVITYTIMELINE_INSTANCE>/rest/api/1/worklog/attributes?auth_token=YOUR_AUTH_TOKEN


Responses

status 200  application/json Returns worklog attributes list.

Example

[
    {
        "id": 81501614300284212,
        "name": "Customer",
        "externalAttributeId": null,
        "isLinked": null,
        "options": {
            "Adam": "Adam",
            "Oli": "Oli",
            "Anna: "Anna"
        },
        "visibility": "REQUIRED",
        "type": "STATIC_LIST"
    }
]


status 400 Returns if incorrect input parameters were supplied

status 401 Returns if user was not logged in

status 403 Returns if user didn't have permissions

status 500 Returns if errors occurred during request