List all comments and events on an issue
const url = 'https://gitea.com/api/v1/repos/example/example/issues/1/timeline';const options = {method: 'GET', headers: {Authorization: 'Basic <credentials>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url https://gitea.com/api/v1/repos/example/example/issues/1/timeline \ --header 'Authorization: Basic <credentials>'Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”Owner of the repo
Name of the repo
Index of the issue
Query Parameters
Section titled “Query Parameters”If provided, only comments updated since the specified time are returned.
Page number of results to return (1-based)
Page size of results
If provided, only comments updated before the provided time are returned.
Responses
Section titled “Responses”TimelineList
TimelineComment represents a timeline comment (comment of any type) on a commit or issue
object
User represents a user
object
Is user active
URL to the user’s avatar
The user’s description
User counts
The user’s full name
URL to the user’s gitea page
The user’s id
Is the user an administrator
User locale
The user’s location
Login of the user, same as username
Identifier of the user, provided by the external authenticator (if configured)
Is user login prohibited
Is user restricted
The ID of the user’s Authentication Source
User visibility level option: public, limited, private
The user’s website
Team represents a team in an organization
object
Whether the team can create repositories in the organization
The description of the team
The unique identifier of the team
Whether the team has access to all repositories in the organization
The name of the team
Organization represents an organization
object
The URL of the organization’s avatar
The description of the organization
The email address of the organization
The full display name of the organization
The unique identifier of the organization
The location of the organization
The name of the organization
Whether repository administrators can change team access
Username of the organization deprecated
The visibility level of the organization (public, limited, private)
The website URL of the organization
object
Body contains the timeline event content
Issue represents an issue in a repository
object
Attachment a generic attachment
object
DownloadURL is the URL to download the attachment
DownloadCount is the number of times the attachment has been downloaded
ID is the unique identifier for the attachment
Name is the filename of the attachment
Size is the file size in bytes
UUID is the unique identifier for the attachment file
User represents a user
object
Is user active
URL to the user’s avatar
The user’s description
User counts
The user’s full name
URL to the user’s gitea page
The user’s id
Is the user an administrator
User locale
The user’s location
Login of the user, same as username
Identifier of the user, provided by the external authenticator (if configured)
Is user login prohibited
Is user restricted
The ID of the user’s Authentication Source
User visibility level option: public, limited, private
The user’s website
User represents a user
object
Is user active
URL to the user’s avatar
The user’s description
User counts
The user’s full name
URL to the user’s gitea page
The user’s id
Is the user an administrator
User locale
The user’s location
Login of the user, same as username
Identifier of the user, provided by the external authenticator (if configured)
Is user login prohibited
Is user restricted
The ID of the user’s Authentication Source
User visibility level option: public, limited, private
The user’s website
The version of the issue content for optimistic locking
Label a label to an issue or a pr
object
Description provides additional context about the label’s purpose
ID is the unique identifier for the label
Name is the display name of the label
URL is the API endpoint for accessing this label
Milestone milestone is a collection of issues on one repository
object
ClosedIssues is the number of closed issues in this milestone
Description provides details about the milestone
ID is the unique identifier for the milestone
OpenIssues is the number of open issues in this milestone
State indicates if the milestone is open or closed open StateOpen StateOpen pr is opened closed StateClosed StateClosed pr is closed
Title is the title of the milestone
PullRequestMeta PR info if an issue is a PR
object
RepositoryMeta basic repository information
object
User represents a user
object
Is user active
URL to the user’s avatar
The user’s description
User counts
The user’s full name
URL to the user’s gitea page
The user’s id
Is the user an administrator
User locale
The user’s location
Login of the user, same as username
Identifier of the user, provided by the external authenticator (if configured)
Is user login prohibited
Is user restricted
The ID of the user’s Authentication Source
User visibility level option: public, limited, private
The user’s website
HTMLURL is the web URL for viewing the comment
ID is the unique identifier for the timeline comment
IssueURL is the API URL for the issue
Label a label to an issue or a pr
object
Description provides additional context about the label’s purpose
ID is the unique identifier for the label
Name is the display name of the label
URL is the API endpoint for accessing this label
Milestone milestone is a collection of issues on one repository
object
ClosedIssues is the number of closed issues in this milestone
Description provides details about the milestone
ID is the unique identifier for the milestone
OpenIssues is the number of open issues in this milestone
State indicates if the milestone is open or closed open StateOpen StateOpen pr is opened closed StateClosed StateClosed pr is closed
Title is the title of the milestone
Milestone milestone is a collection of issues on one repository
object
ClosedIssues is the number of closed issues in this milestone
Description provides details about the milestone
ID is the unique identifier for the milestone
OpenIssues is the number of open issues in this milestone
State indicates if the milestone is open or closed open StateOpen StateOpen pr is opened closed StateClosed StateClosed pr is closed
Title is the title of the milestone
PRURL is the API URL for the pull request (if applicable)
Comment represents a comment on a commit or issue
object
Attachments contains files attached to the comment
Attachment a generic attachment
object
DownloadURL is the URL to download the attachment
DownloadCount is the number of times the attachment has been downloaded
ID is the unique identifier for the attachment
Name is the filename of the attachment
Size is the file size in bytes
UUID is the unique identifier for the attachment file
Body contains the comment text content
HTMLURL is the web URL for viewing the comment
ID is the unique identifier for the comment
IssueURL is the API URL for the issue
OriginalAuthor is the original author name (for imported comments)
OriginalAuthorID is the original author ID (for imported comments)
PRURL is the API URL for the pull request (if applicable)
User represents a user
object
Is user active
URL to the user’s avatar
The user’s description
User counts
The user’s full name
URL to the user’s gitea page
The user’s id
Is the user an administrator
User locale
The user’s location
Login of the user, same as username
Identifier of the user, provided by the external authenticator (if configured)
Is user login prohibited
Is user restricted
The ID of the user’s Authentication Source
User visibility level option: public, limited, private
The user’s website
Commit SHA where issue/PR was referenced
Issue represents an issue in a repository
object
Attachment a generic attachment
object
DownloadURL is the URL to download the attachment
DownloadCount is the number of times the attachment has been downloaded
ID is the unique identifier for the attachment
Name is the filename of the attachment
Size is the file size in bytes
UUID is the unique identifier for the attachment file
User represents a user
object
Is user active
URL to the user’s avatar
The user’s description
User counts
The user’s full name
URL to the user’s gitea page
The user’s id
Is the user an administrator
User locale
The user’s location
Login of the user, same as username
Identifier of the user, provided by the external authenticator (if configured)
Is user login prohibited
Is user restricted
The ID of the user’s Authentication Source
User visibility level option: public, limited, private
The user’s website
User represents a user
object
Is user active
URL to the user’s avatar
The user’s description
User counts
The user’s full name
URL to the user’s gitea page
The user’s id
Is the user an administrator
User locale
The user’s location
Login of the user, same as username
Identifier of the user, provided by the external authenticator (if configured)
Is user login prohibited
Is user restricted
The ID of the user’s Authentication Source
User visibility level option: public, limited, private
The user’s website
The version of the issue content for optimistic locking
Label a label to an issue or a pr
object
Description provides additional context about the label’s purpose
ID is the unique identifier for the label
Name is the display name of the label
URL is the API endpoint for accessing this label
Milestone milestone is a collection of issues on one repository
object
ClosedIssues is the number of closed issues in this milestone
Description provides details about the milestone
ID is the unique identifier for the milestone
OpenIssues is the number of open issues in this milestone
State indicates if the milestone is open or closed open StateOpen StateOpen pr is opened closed StateClosed StateClosed pr is closed
Title is the title of the milestone
PullRequestMeta PR info if an issue is a PR
object
RepositoryMeta basic repository information
object
User represents a user
object
Is user active
URL to the user’s avatar
The user’s description
User counts
The user’s full name
URL to the user’s gitea page
The user’s id
Is the user an administrator
User locale
The user’s location
Login of the user, same as username
Identifier of the user, provided by the external authenticator (if configured)
Is user login prohibited
Is user restricted
The ID of the user’s Authentication Source
User visibility level option: public, limited, private
The user’s website
Whether the assignees were removed or added
User represents a user
object
Is user active
URL to the user’s avatar
The user’s description
User counts
The user’s full name
URL to the user’s gitea page
The user’s id
Is the user an administrator
User locale
The user’s location
Login of the user, same as username
Identifier of the user, provided by the external authenticator (if configured)
Is user login prohibited
Is user restricted
The ID of the user’s Authentication Source
User visibility level option: public, limited, private
The user’s website
TrackedTime worked time for an issue / pr
object
ID is the unique identifier for the tracked time entry
Issue represents an issue in a repository
object
Attachment a generic attachment
object
DownloadURL is the URL to download the attachment
DownloadCount is the number of times the attachment has been downloaded
ID is the unique identifier for the attachment
Name is the filename of the attachment
Size is the file size in bytes
UUID is the unique identifier for the attachment file
User represents a user
object
Is user active
URL to the user’s avatar
The user’s description
User counts
The user’s full name
URL to the user’s gitea page
The user’s id
Is the user an administrator
User locale
The user’s location
Login of the user, same as username
Identifier of the user, provided by the external authenticator (if configured)
Is user login prohibited
Is user restricted
The ID of the user’s Authentication Source
User visibility level option: public, limited, private
The user’s website
User represents a user
object
Is user active
URL to the user’s avatar
The user’s description
User counts
The user’s full name
URL to the user’s gitea page
The user’s id
Is the user an administrator
User locale
The user’s location
Login of the user, same as username
Identifier of the user, provided by the external authenticator (if configured)
Is user login prohibited
Is user restricted
The ID of the user’s Authentication Source
User visibility level option: public, limited, private
The user’s website
The version of the issue content for optimistic locking
Label a label to an issue or a pr
object
Description provides additional context about the label’s purpose
ID is the unique identifier for the label
Name is the display name of the label
URL is the API endpoint for accessing this label
Milestone milestone is a collection of issues on one repository
object
ClosedIssues is the number of closed issues in this milestone
Description provides details about the milestone
ID is the unique identifier for the milestone
OpenIssues is the number of open issues in this milestone
State indicates if the milestone is open or closed open StateOpen StateOpen pr is opened closed StateClosed StateClosed pr is closed
Title is the title of the milestone
PullRequestMeta PR info if an issue is a PR
object
RepositoryMeta basic repository information
object
User represents a user
object
Is user active
URL to the user’s avatar
The user’s description
User counts
The user’s full name
URL to the user’s gitea page
The user’s id
Is the user an administrator
User locale
The user’s location
Login of the user, same as username
Identifier of the user, provided by the external authenticator (if configured)
Is user login prohibited
Is user restricted
The ID of the user’s Authentication Source
User visibility level option: public, limited, private
The user’s website
Deprecated (only for backwards compatibility)
Time in seconds
Deprecated (only for backwards compatibility)
Username of the user
Type indicates the type of timeline event
User represents a user
object
Is user active
URL to the user’s avatar
The user’s description
User counts
The user’s full name
URL to the user’s gitea page
The user’s id
Is the user an administrator
User locale
The user’s location
Login of the user, same as username
Identifier of the user, provided by the external authenticator (if configured)
Is user login prohibited
Is user restricted
The ID of the user’s Authentication Source
User visibility level option: public, limited, private
The user’s website
Example
[ { "assignee": { "login_name": "empty" }, "assignee_team": { "permission": "none", "units": [ "repo.code", "repo.issues", "repo.ext_issues", "repo.wiki", "repo.pulls", "repo.releases", "repo.projects", "repo.ext_wiki" ], "units_map": { "repo.code": "read", "repo.ext_issues": "none", "repo.ext_wiki": "none", "repo.issues": "write", "repo.projects": "none", "repo.pulls": "owner", "repo.releases": "none", "repo.wiki": "admin" } }, "dependent_issue": { "assignee": { "login_name": "empty" }, "assignees": [ { "login_name": "empty" } ], "labels": [ { "color": "00aabb", "exclusive": false, "is_archived": false } ], "milestone": { "state": "open" }, "state": "open", "user": { "login_name": "empty" } }, "label": { "color": "00aabb", "exclusive": false, "is_archived": false }, "milestone": { "state": "open" }, "old_milestone": { "state": "open" }, "ref_comment": { "user": { "login_name": "empty" } }, "ref_issue": { "assignee": { "login_name": "empty" }, "assignees": [ { "login_name": "empty" } ], "labels": [ { "color": "00aabb", "exclusive": false, "is_archived": false } ], "milestone": { "state": "open" }, "state": "open", "user": { "login_name": "empty" } }, "resolve_doer": { "login_name": "empty" }, "tracked_time": { "issue": { "assignee": { "login_name": "empty" }, "assignees": [ { "login_name": "empty" } ], "labels": [ { "color": "00aabb", "exclusive": false, "is_archived": false } ], "milestone": { "state": "open" }, "state": "open", "user": { "login_name": "empty" } } }, "user": { "login_name": "empty" } }]APINotFound is a not found empty response