Query issue change logs

POST 
/project/issueFields/changeLog/query

Query change logs from issue_version, grouped by issue and paged by issue.

Key behavior:

• create_time and update_time filter issue fields, not issue_version fields.
• Pagination is based on issue (cursor + limit).
• limit defaults to 50, max 1000.
• Returned change records are capped at 10000; when capped, records_truncated = true.

Request

Query Parameters

teamID stringrequired

The team ID

application/json

Body

project_uuids string[]

Project UUIDs. Optional. Empty means all projects.

issue_uuids string[]required

Possible values: >= 1, <= 1000

Issue UUIDs. Required. Provide at least 1 and at most 1000 issue UUIDs.

field_uuids string[]

Field UUIDs. Optional. Empty means all changed fields.

limit integer

Possible values: >= 1 and <= 1000

Issue page size. Defaults to 50. Maximum 1000.

cursor string

Issue pagination cursor. Use an empty string for the first page.

create_time

object

Millisecond timestamp range.

start int64

Inclusive start timestamp in milliseconds.

end int64

Inclusive end timestamp in milliseconds.

update_time

object

Millisecond timestamp range.

start int64

Inclusive start timestamp in milliseconds.

end int64

Inclusive end timestamp in milliseconds.

Responses

200

Request successful

application/json

Schema

Schema

data

object

required

records

object[]

required

Array [

issue_uuid string

name string

Issue name.

records

object[]

Array [

version_uuid string

create_time int64

Version creation time in milliseconds.

field_uuid string

field_type string

field_name string

old_value

object

nullable

oneOf

MOD1

string

MOD2

integer

MOD3

number

MOD4

boolean

MOD6

object

new_value

object

nullable

oneOf

MOD1

string

MOD2

integer

MOD3

number

MOD4

boolean

MOD6

object

author

object

nullable

uuid string

name string

]

record_count integer

Count of change records for the issue.

]

page_info

object

has_next_page boolean

Whether there is a next issue page.

start_cursor string

Start cursor of the current issue page.

end_cursor string

End cursor of the current issue page.

page_count integer

Issue count in the current page.

records_truncated booleanrequired

Whether records were truncated due to the 10000 record cap.

record_count integerrequired

Total count of change records returned in this response.

Example (from schema)

{
  "data": {
    "records": [
      {
        "issue_uuid": "string",
        "name": "string",
        "records": [
          {
            "version_uuid": "string",
            "create_time": 0,
            "field_uuid": "string",
            "field_type": "string",
            "field_name": "string",
            "old_value": "string",
            "new_value": "string",
            "author": {
              "uuid": "string",
              "name": "string"
            }
          }
        ],
        "record_count": 0
      }
    ],
    "page_info": {
      "has_next_page": true,
      "start_cursor": "string",
      "end_cursor": "string",
      "page_count": 0
    },
    "records_truncated": true,
    "record_count": 0
  }
}

Example

{
  "data": {
    "records": [
      {
        "issue_uuid": "CwQKxDfF",
        "name": "Updated issue title",
        "record_count": 2,
        "records": [
          {
            "version_uuid": "ver001",
            "create_time": 1737000000123,
            "field_uuid": "field001",
            "field_type": "text",
            "field_name": "Summary",
            "old_value": "Legacy summary",
            "new_value": "Updated summary",
            "author": {
              "uuid": "user001",
              "name": "Alice"
            }
          },
          {
            "version_uuid": "ver001",
            "create_time": 1737000000123,
            "field_uuid": "field005",
            "field_type": "status",
            "field_name": "Status",
            "old_value": "status_in_progress",
            "new_value": "status_done",
            "author": {
              "uuid": "user001",
              "name": "Alice"
            }
          }
        ]
      }
    ],
    "page_info": {
      "has_next_page": true,
      "start_cursor": "0",
      "end_cursor": "50",
      "page_count": 50
    },
    "records_truncated": false,
    "record_count": 2
  }
}

401

Returned if the authentication credentials are incorrect or missing.

application/json

Schema

Schema

result string

The result of this request.

errorCode string

The error code of this request.

errorMsg string

Error message for this request.

Example (from schema)

{
  "result": "FAIL",
  "errorCode": "Unauthorized",
  "errorMsg": "Access token is invalid"
}

403

Returns if the scope check fails.

application/json

Schema

Schema

result string

The result of this request.

errorCode string

The error code of this request.

errorMsg string

Error message for this request.

Example (from schema)

{
  "result": "FAIL",
  "errorCode": "Forbidden",
  "errorMsg": "Scope is invalid"
}

404

Returned if the resource object was not found.

application/json

Schema

Schema

result string

The result of this request.

errorCode string

The error code of this request.

errorMsg string

Error message for this request.

Example (from schema)

{
  "result": "FAIL",
  "errorCode": "NotFound",
  "errorMsg": "Not Found"
}

500

Internal Server Error.

application/json

Schema

Schema

result string

The result of this request.

errorCode string

The error code of this request.

errorMsg string

Error message for this request.

Example (from schema)

{
  "result": "FAIL",
  "errorCode": "Internal Server Error",
  "errorMsg": "Internal Server Error"
}

Loading...