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 'http://jira.local:8080/jira/rest//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

201 - Example 1

{
    "author": {},
    "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": {},
    "updated": "2019-08-24T14:15:22Z",
    "visibility": {
        "identifier": "string",
        "type": "group",
        "value": "string"
    }
}

Request

Path Params

Query Params

Body Params application/json

Examples

Responses

🟢201Returned if the request is successful.

application/json

Body

🟠400Returned if: * `adjustEstimate` is set to `new` but `newEstimate` is not provided or is invalid. * `adjustEstimate` is set to `manual` but `reduceBy` is not provided or is invalid. * the user does not have permission to add the worklog. * the req

🟠401Returned if the authentication credentials are incorrect.

🟠404Returned if the issue is not found or the user does not have permission to view it.

Modified at 2023-07-13 03:27:27

Get issue worklogs

Get worklog