Versions Compared

Version Old Version 7 New Version Current
Changes made by

Attila Bordás

Norbert Soós

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Code Block
{
    "description": "my description",
    "durationInSeconds": 3600,
    "isBillable": true,
    "issueId": 10182,
    "jiraWorklogId": 230818,
    "workDate": "2023-04-24",
    "worklogId": 155,
    "worklogTagIds": [
        1,
        5
    ],
    "workStartTimeworklogTags": "12:00"
}

400 Invalid parameters:

An object that holds all field and non-field related errors:

Code Block
{[
   // Errors that are{
not tied to any specific field.   "additionalErrorsid": [1,
    {       "errorType"name": "JiraErrordevelopment"
  | "PeriodicLimit" | "PeriodicLoggablePeriod" |},
"PeriodicMaxHoursPerDay" | "TooManyDataForTimesheet" | "TooManyWorklogsToExport" | "NoActiveLicense"{
| "ManualUpgradeNeeded"       "extraid": //5,
A field holding additional information related to the error
"name": "testing"
   }   ],}
  // Error response],
data for fields.  "workStartTime": "fieldErrors": [
    {
   12:00"
}

400 Invalid parameters:

An object that holds all field and non-field related errors:

Code Block
{
  // Errors that are not tied to any specific field.
  "errorTypeadditionalErrors": "Exceed[
    {
      "errorType": "JiraError" | "InvalidPeriodicLimit" | "InvalidByJiraPeriodicLoggablePeriod" | "InvalidFormatPeriodicMaxHoursPerDay" | "LoggablePeriodTooManyDataForTimesheet" | "MaxHoursPerDayTooManyWorklogsToExport" | "RequiredNoActiveLicense" | "TooManyPeriodicIssuesManualUpgradeNeeded",
      "extra": // A Anfield arrayholding ofadditional stringinformation arraysrelated containingto the error
problematic field names.  }
  ],
 "paths": [
     // Error response data for fields.
  "fieldErrors": [
    {
      "errorType": "stringExceed" | "Invalid" | "InvalidByJira" | "InvalidFormat" | "LoggablePeriod" ]| "MaxHoursPerDay" | "Required" | "TooManyPeriodicIssues",
 ]     }// An array ]
}

401 Unauthorized

479 The user does not have one of the necessary Timetracker permissions that can be set in the Global Settings.

Update worklog PATCH /worklog

Header parameters

...

Header Parameter

...

Optional

...

Description

...

of string arrays containing the problematic field names.
      "paths": [
        [
          "string"
        ]
      ]
    }
  ]
}

401 Unauthorized

479 The user does not have one of the necessary Timetracker permissions that can be set in the Global Settings.

Update worklog PATCH /worklog

Header parameters

Header Parameter

Optional

Description

x-everit-api-key

false

Generated Everit authentication token, see: REST API

x-everit-jwt deprecated

false

JWT token (deprecated, use the new x-everit-api-key instead)

x-requested-by

false

CSRF protection paramter.

x-timezone

true

The time zone of the user, for eg.: Europe/Budapest. If not specified defaults to UTC.

x-everit-on-behalf-account

true

The account id of the on behalf user.

...

Parameter

Value type

Optional

Description

worklogId

number

false

The internal ID of the worklog to patch.

jiraWorklogId

number

true

The ID of the worklog as stored in Jira.

partialWorklog

PartialWorklog

false

The patch to apply on the worklog. Only the fields with defined values will be updated.

(info) You either use “worklogId” or “jiraWorklogId”. If both are specified, “worklogId” is stronger.

The available parameters of the PartialWorklog:

...

Code Block
{
    "partialWorklog": {
        "description": "test description",
        "durationInSeconds": 3600,
        "isBillable": true,
        "issueId": 10329,
        "workDate": "2023-04-19",
        "worklogTagIds": [1, 5],
        "workStartTime": "08:15"
    },
    "worklogId": 181
}

...

,
    "jiraWorklogId": 230818,
}

Example response:

200 The patch operation is accepted and processed. The result of the worklog patch can be found in the response body:

  • If there was no error during the patch the error object will be null and the patched worklog is returned:

    • Code Block
      {
    "error": null,
    "worklog": {
        "description": "test description",
        "durationInSeconds": 10800,
        "isBillable": true,
        "issueId": 10329,
        "workDate": "2023-04-19",
        "worklogId": 181,
        "worklogTagIds": [
            1,
            5
        ],
        "workStartTimeworklogTags": "08:15" [
       } }

    If there was an error during the patch the error object will be filled:

    • Code Block
      {  {
  "error": {         "messageid": null1,
            "resultname": "WORKLOG_NOT_FOUND","development"
        "worklogId": 181 },
   },     "worklog": null }

400 Invalid parameters:

An object that holds all field and non-field related errors:

...

    • {

...

    •

...

    •

...

    •

...

    •

...

    •

...

    •

...

    •

...

    •

...

    •

...

    •

...

    •    "

...

    • id": 5,

...

    •

...

    •        "

...

    • name": "

...

    • testing"

...

    •

...

    •

...

    •

...

    •

...

    •

...

    •

...

    •

...

    •

...

    •

...

    •

...

    •

...

    • }

...

    •

...

    •

...

    • ],
        "workStartTime": "08:15"
    }

...

    • }

  • If there was an error during the patch the error object will be filled:

    • Code Block
      {
    "error": {
        "

...

    • message":

...

    • null,

...

    •        "

...

    • result": "

...

    • WORKLOG_NOT_FOUND",
        "worklogId": 181
    },
    "worklog": null
}

400 Invalid parameters:

An object that holds all field and non-field related errors:

Code Block
{
  // AnErrors arraythat ofare stringnot arraystied containingto theany problematicspecific field names.
   
  "pathsadditionalErrors": [
    {
    [  "errorType": "JiraError" | "PeriodicLimit" | "PeriodicLoggablePeriod" | "PeriodicMaxHoursPerDay" | "stringTooManyDataForTimesheet" | "TooManyWorklogsToExport" | "NoActiveLicense" | "ManualUpgradeNeeded"
  ]    "extra": // A ]field holding additional information  }
  ]
}

401 Unauthorized

479 The user does not have one of the necessary Timetracker permissions that can be set in the Global Settings.

Get worklog GET /worklog

Header parameters

...

Header Parameter

...

Optional

...

Description

...

x-everit-api-key

...

false

...

Generated Everit authentication token, see: REST API

...

x-everit-jwt deprecated

...

false

...

JWT token (deprecated, use the new x-everit-api-key instead)

...

x-timezone

...

true

...

The time zone of the user, for eg.: Europe/Budapest. If not specified defaults to UTC.

Query Parameters

The available query parameters for the request:

...

Query Parameter

...

Value type

...

Optional

...

Description

...

worklogId

...

number

...

false

...

The internal app ID of the worklog.

Example: /public/worklog?worklogId=107

...

jiraWorklogId

...

number

...

true

...

The ID of the worklog as stored in Jira.

Example: /public/worklog?jiraWorklogId=230818

Examples

  • GET URL: TIME_TRACKER_BASE_URL/timetracker/api/latest/public/worklog?worklogId=155

  • GET URL: TIME_TRACKER_BASE_URL/timetracker/api/latest/public/worklog?jiraWorklogId=230818

Example response:

200 Successful operation:

Code Block
{
    "description": "my description",
    "durationInSeconds": 3600,
    "isBillable": true,
    "issueId": 10182,
    "jiraWorklogId": 230818,
    "workDate": "2023-04-24",
    "worklogId": 155,
    "worklogTagIds": [related to the error
    }
  ],
  // Error response data for fields.
  "fieldErrors": [
    {
      "errorType": "Exceed" | "Invalid" | "InvalidByJira" | "InvalidFormat" | "LoggablePeriod" | "MaxHoursPerDay" | "Required" | "TooManyPeriodicIssues",
      // An array of string arrays containing the problematic field names.
      "paths": [
        [
          "string"
        ]
      ]
    }
  ]
}

401 Unauthorized

479 The user does not have one of the necessary Timetracker permissions that can be set in the Global Settings.

Get worklog GET /worklog

Header parameters

Header Parameter

Optional

Description

x-everit-api-key

false

Generated Everit authentication token, see: REST API

x-everit-jwt deprecated

false

JWT token (deprecated, use the new x-everit-api-key instead)

x-timezone

true

The time zone of the user, for eg.: Europe/Budapest. If not specified defaults to UTC.

Query Parameters

The available query parameters for the request:

Query Parameter

Value type

Optional

Description

worklogId

number

false

The internal app ID of the worklog.

Example: /public/worklog?worklogId=107

jiraWorklogId

number

true

The ID of the worklog as stored in Jira.

Example: /public/worklog?jiraWorklogId=230818

(info) You either use “worklogId” or “jiraWorklogId”. If both are specified, “worklogId” is stronger.

Examples

  • GET URL: TIME_TRACKER_BASE_URL/timetracker/api/latest/public/worklog?worklogId=155

  • GET URL: TIME_TRACKER_BASE_URL/timetracker/api/latest/public/worklog?jiraWorklogId=230818

Example response:

200 Successful operation:

Code Block
{
    "description": "my description",
    "durationInSeconds": 3600,
    "isBillable": true,
    "issueId": 10182,
    "jiraWorklogId": 230818,
    "workDate": "2023-04-24",
    "worklogId": 155,
    "worklogTagIds": [
        1,
        5
    ],
    "worklogTags": [
      {
        "id": 1,
        "name": "development"
      },
      {
        "id": 5,
        1,
"name": "testing"
       5}
    ],
    "workStartTime": "12:00"
}

...

Query Parameter

Value type

Optional

Description

worklogId

number

false

The ID of the worklog.

Example: /public/worklog?worklogId=107

jiraWorklogId

number

true

The ID of the worklog as stored in Jira.

Example: /public/worklog?jiraWorklogId=230818

(info) You either use “worklogId” or “jiraWorklogId”. If both are specified, “worklogId” is stronger.

Examples

  • DELETE URL: TIME_TRACKER_BASE_URL/timetracker/api/latest/public/worklog?worklogId=123

  • DELETE URL: TIME_TRACKER_BASE_URL/timetracker/api/latest/public/worklog?jiraWorklogId=230818

...