Add worklog

POST

/rest/api/3/issue/{issueIdOrKey}/worklog

Adds a worklog to an issue.

Time tracking must be enabled in Jira, otherwise this operation returns an error. For more information, see Configuring time tracking.

This operation can be accessed anonymously.

Permissions required:

Browse projects and Work on issues project permission for the project that the issue is in.

If issue-level security is configured, issue-level security permission to view the issue.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/rest/api/3/issue//worklog' \
--header 'Content-Type: application/json' \
--data-raw '{
    "comment": {
        "content": [
            {
                "content": [
                    {
                        "text": "I did some work here.",
                        "type": "text"
                    }
                ],
                "type": "paragraph"
            }
        ],
        "type": "doc",
        "version": 1
    },
    "started": "2021-01-17T12:34:00.000+0000",
    "timeSpentSeconds": 12000,
    "visibility": {
        "identifier": "276f955c-63d7-42c8-9520-92d01dca0625",
        "type": "group"
    }
}'

Response Example

{
    "author": {
        "accountId": "string",
        "accountType": "string",
        "active": true,
        "avatarUrls": {
            "16x16": "http://example.com",
            "24x24": "http://example.com",
            "32x32": "http://example.com",
            "48x48": "http://example.com"
        },
        "displayName": "string",
        "emailAddress": "string",
        "key": "string",
        "name": "string",
        "self": "string",
        "timeZone": "string"
    },
    "comment": null,
    "created": "2019-08-24T14:15:22Z",
    "id": "string",
    "issueId": "string",
    "properties": [
        {
            "key": "string",
            "value": null
        }
    ],
    "self": "http://example.com",
    "started": "2019-08-24T14:15:22Z",
    "timeSpent": "string",
    "timeSpentSeconds": 0,
    "updateAuthor": {
        "accountId": "string",
        "accountType": "string",
        "active": true,
        "avatarUrls": {
            "16x16": "http://example.com",
            "24x24": "http://example.com",
            "32x32": "http://example.com",
            "48x48": "http://example.com"
        },
        "displayName": "string",
        "emailAddress": "string",
        "key": "string",
        "name": "string",
        "self": "string",
        "timeZone": "string"
    },
    "updated": "2019-08-24T14:15:22Z",
    "visibility": {
        "identifier": "string",
        "type": "group",
        "value": "string"
    }
}

Request

Path Params

Query Params

Body Params application/json

Examples

Responses

🟢201Created

application/json

Returned if the request is successful.

Body

🟠400Bad Request

🟠401Unauthorized

🟠404Record Not Found

🟠413413

Modified at 2025-07-16 07:18:01

Get issue worklogs

Bulk move worklogs