List runs for a workflow

GET

/repos/{owner}/{repo}/actions/workflows/{workflow_id}/runs

const url = 'https://gitea.com/api/v1/repos/example/example/actions/workflows/example/runs';
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/actions/workflows/example/runs \
  --header 'Authorization: Basic <credentials>'

Authorizations

Parameters

Path Parameters

owner

required

string

Owner of the repo

repo

required

string

Name of the repo

workflow_id

required

string

Id of the workflow, must be the workflow file name (e.g. build.yml)

Query Parameters

event

string

Workflow event name

branch

string

Workflow branch

status

string

Workflow status (pending, queued, in_progress, failure, success, skipped)

actor

string

Triggered by user

head_sha

string

Triggering sha of the workflow run

exclude_pull_requests

boolean

If true, the pull_requests field on each returned run is emptied

scoped_workflow_source_repo_id

integer format: int64

For a scoped workflow, the ID of the source repository providing it; omit or 0 for a repo-level workflow.

page

integer

Page number of results to return (1-based)

limit

integer

Page size of results

Responses

200

WorkflowRunsList

application/json

ActionWorkflowRunsResponse returns ActionWorkflowRuns

object

total_count

integer format: int64

workflow_runs

Array<object>

ActionWorkflowRun represents a WorkflowRun

object

actor

User represents a user

object

active

Is user active

boolean

avatar_url

URL to the user’s avatar

string

created

string format: date-time

description

The user’s description

string

email

string format: email

followers_count

User counts

integer format: int64

following_count

integer format: int64

full_name

The user’s full name

string

html_url

URL to the user’s gitea page

string

The user’s id

integer format: int64

is_admin

Is the user an administrator

boolean

language

User locale

string

last_login

string format: date-time

location

The user’s location

string

login

string

login_name

Identifier of the user, provided by the external authenticator (if configured)

string

default: empty

prohibit_login

Is user login prohibited

boolean

restricted

Is user restricted

boolean

source_id

The ID of the user’s Authentication Source

integer format: int64

starred_repos_count

integer format: int64

visibility

User visibility level option: public, limited, private public UserVisibilityPublic limited UserVisibilityLimited private UserVisibilityPrivate

string

Allowed values: public limited private

website

The user’s website

string

completed_at

string format: date-time

conclusion

string

display_title

string

event

string

head_branch

string

head_repository

Repository represents a repository

object

allow_fast_forward_only_merge

boolean

allow_manual_merge

boolean

allow_merge_commits

boolean

allow_merge_update

boolean

allow_rebase

boolean

allow_rebase_explicit

boolean

allow_rebase_update

boolean

allow_squash_merge

boolean

archived

boolean

archived_at

string format: date-time

autodetect_manual_merge

boolean

avatar_url

string

branch_count

integer format: int64

clone_url

string

created_at

string format: date-time

default_allow_maintainer_edit

boolean

default_branch

string

default_delete_branch_after_merge

boolean

default_merge_style

string

default_target_branch

string

default_update_style

string

description

string

empty

boolean

external_tracker

ExternalTracker represents settings for external tracker

object

external_tracker_format

External Issue Tracker URL Format. Use the placeholders {user}, {repo} and {index} for the username, repository name and issue index.

string

external_tracker_regexp_pattern

External Issue Tracker issue regular expression

string

external_tracker_style

External Issue Tracker Number Format, either numeric, alphanumeric, or regexp

string

external_tracker_url

URL of external issue tracker.

string

external_wiki

ExternalWiki represents setting for external wiki

object

external_wiki_url

URL of external wiki.

string

fork

boolean

forks_count

integer format: int64

full_name

string

has_actions

boolean

has_code

boolean

has_issues

boolean

has_packages

boolean

has_projects

boolean

has_pull_requests

boolean

has_releases

boolean

has_wiki

boolean

html_url

string

integer format: int64

ignore_whitespace_conflicts

boolean

internal

boolean

internal_tracker

InternalTracker represents settings for internal tracker

object

allow_only_contributors_to_track_time

Let only contributors track time (Built-in issue tracker)

boolean

enable_issue_dependencies

Enable dependencies for issues and pull requests (Built-in issue tracker)

boolean

enable_time_tracker

Enable time tracking (Built-in issue tracker)

boolean

language

string

languages_url

string

licenses

Array<string>

link

string

mirror

boolean

mirror_interval

string

mirror_last_sync_at

string format: date-time

mirror_updated

string format: date-time

name

string

object_format_name

ObjectFormatName of the underlying git repository sha1 ObjectFormatSHA1 sha256 ObjectFormatSHA256

string

Allowed values: sha1 sha256

open_issues_count

integer format: int64

open_pr_counter

integer format: int64

original_url

string

owner

User represents a user

object

active

Is user active

boolean

avatar_url

URL to the user’s avatar

string

created

string format: date-time

description

The user’s description

string

email

string format: email

followers_count

User counts

integer format: int64

following_count

integer format: int64

full_name

The user’s full name

string

html_url

URL to the user’s gitea page

string

The user’s id

integer format: int64

is_admin

Is the user an administrator

boolean

language

User locale

string

last_login

string format: date-time

location

The user’s location

string

login

string

login_name

Identifier of the user, provided by the external authenticator (if configured)

string

default: empty

prohibit_login

Is user login prohibited

boolean

restricted

Is user restricted

boolean

source_id

The ID of the user’s Authentication Source

integer format: int64

starred_repos_count

integer format: int64

visibility

User visibility level option: public, limited, private public UserVisibilityPublic limited UserVisibilityLimited private UserVisibilityPrivate

string

Allowed values: public limited private

website

The user’s website

string

parent

object recursive

permissions

Permission represents a set of permissions

object

admin

boolean

pull

boolean

push

boolean

private

boolean

projects_mode

string

release_counter

integer format: int64

repo_transfer

RepoTransfer represents a pending repo transfer

object

doer

User represents a user

object

active

Is user active

boolean

avatar_url

URL to the user’s avatar

string

created

string format: date-time

description

The user’s description

string

email

string format: email

followers_count

User counts

integer format: int64

following_count

integer format: int64

full_name

The user’s full name

string

html_url

URL to the user’s gitea page

string

The user’s id

integer format: int64

is_admin

Is the user an administrator

boolean

language

User locale

string

last_login

string format: date-time

location

The user’s location

string

login

string

login_name

Identifier of the user, provided by the external authenticator (if configured)

string

default: empty

prohibit_login

Is user login prohibited

boolean

restricted

Is user restricted

boolean

source_id

The ID of the user’s Authentication Source

integer format: int64

starred_repos_count

integer format: int64

visibility

User visibility level option: public, limited, private public UserVisibilityPublic limited UserVisibilityLimited private UserVisibilityPrivate

string

Allowed values: public limited private

website

The user’s website

string

recipient

User represents a user

object

active

Is user active

boolean

avatar_url

URL to the user’s avatar

string

created

string format: date-time

description

The user’s description

string

email

string format: email

followers_count

User counts

integer format: int64

following_count

integer format: int64

full_name

The user’s full name

string

html_url

URL to the user’s gitea page

string

The user’s id

integer format: int64

is_admin

Is the user an administrator

boolean

language

User locale

string

last_login

string format: date-time

location

The user’s location

string

login

string

login_name

Identifier of the user, provided by the external authenticator (if configured)

string

default: empty

prohibit_login

Is user login prohibited

boolean

restricted

Is user restricted

boolean

source_id

The ID of the user’s Authentication Source

integer format: int64

starred_repos_count

integer format: int64

visibility

User visibility level option: public, limited, private public UserVisibilityPublic limited UserVisibilityLimited private UserVisibilityPrivate

string

Allowed values: public limited private

website

The user’s website

string

teams

Array<object>

Team represents a team in an organization

object

can_create_org_repo

Whether the team can create repositories in the organization

boolean

description

The description of the team

string

The unique identifier of the team

integer format: int64

includes_all_repositories

Whether the team has access to all repositories in the organization

boolean

name

The name of the team

string

organization

Organization represents an organization

object

avatar_url

The URL of the organization’s avatar

string

description

The description of the organization

string

email

The email address of the organization

string

full_name

The full display name of the organization

string

The unique identifier of the organization

integer format: int64

location

The location of the organization

string

name

The name of the organization

string

repo_admin_change_team_access

Whether repository administrators can change team access

boolean

username

Username of the organization deprecated

string

visibility

The visibility level of the organization (public, limited, private) public UserVisibilityPublic limited UserVisibilityLimited private UserVisibilityPrivate

string

Allowed values: public limited private

website

The website URL of the organization

string

permission

string

Allowed values: none read write admin owner

units

Array<string>

units_map

object

key

additional properties

string

visibility

Team visibility within the organization. “private” teams are only listable by members and org owners; “limited” teams are listable by any organization member; “public” teams are listable by any signed-in user. public TeamVisibilityPublic limited TeamVisibilityLimited private TeamVisibilityPrivate

string

Allowed values: public limited private

size

integer format: int64

ssh_url

string

stars_count

integer format: int64

template

boolean

topics

Array<string>

updated_at

string format: date-time

url

string

watchers_count

integer format: int64

website

string

head_sha

string

html_url

string

integer format: int64

path

string

previous_attempt_url

PreviousAttemptURL is the API URL of the previous attempt of this run, e.g. “…/actions/runs/{run_id}/attempts/{attempt-1}”. It is set only when the current attempt is > 1 (i.e. a rerun). For the first attempt, or for legacy runs that pre-date ActionRunAttempt, it is null.

string

pull_requests

Array<object>

PullRequestMinimal is the minimal information about a pull request, as returned in the pull_requests field of a workflow run.

object

base

PullRequestMinimalHead is a minimal description of one side of a pull request.

object

ref

string

repo

PullRequestMinimalHeadRepo is a minimal description of the repository on one side of a pull request.

object

integer format: int64

name

string

url

string

sha

string

head

PullRequestMinimalHead is a minimal description of one side of a pull request.

object

ref

string

repo

PullRequestMinimalHeadRepo is a minimal description of the repository on one side of a pull request.

object

integer format: int64

name

string

url

string

sha

string

integer format: int64

number

integer format: int64

url

string

repository

Repository represents a repository

object

allow_fast_forward_only_merge

boolean

allow_manual_merge

boolean

allow_merge_commits

boolean

allow_merge_update

boolean

allow_rebase

boolean

allow_rebase_explicit

boolean

allow_rebase_update

boolean

allow_squash_merge

boolean

archived

boolean

archived_at

string format: date-time

autodetect_manual_merge

boolean

avatar_url

string

branch_count

integer format: int64

clone_url

string

created_at

string format: date-time

default_allow_maintainer_edit

boolean

default_branch

string

default_delete_branch_after_merge

boolean

default_merge_style

string

default_target_branch

string

default_update_style

string

description

string

empty

boolean

external_tracker

ExternalTracker represents settings for external tracker

object

external_tracker_format

External Issue Tracker URL Format. Use the placeholders {user}, {repo} and {index} for the username, repository name and issue index.

string

external_tracker_regexp_pattern

External Issue Tracker issue regular expression

string

external_tracker_style

External Issue Tracker Number Format, either numeric, alphanumeric, or regexp

string

external_tracker_url

URL of external issue tracker.

string

external_wiki

ExternalWiki represents setting for external wiki

object

external_wiki_url

URL of external wiki.

string

fork

boolean

forks_count

integer format: int64

full_name

string

has_actions

boolean

has_code

boolean

has_issues

boolean

has_packages

boolean

has_projects

boolean

has_pull_requests

boolean

has_releases

boolean

has_wiki

boolean

html_url

string

integer format: int64

ignore_whitespace_conflicts

boolean

internal

boolean

internal_tracker

InternalTracker represents settings for internal tracker

object

allow_only_contributors_to_track_time

Let only contributors track time (Built-in issue tracker)

boolean

enable_issue_dependencies

Enable dependencies for issues and pull requests (Built-in issue tracker)

boolean

enable_time_tracker

Enable time tracking (Built-in issue tracker)

boolean

language

string

languages_url

string

licenses

Array<string>

link

string

mirror

boolean

mirror_interval

string

mirror_last_sync_at

string format: date-time

mirror_updated

string format: date-time

name

string

object_format_name

ObjectFormatName of the underlying git repository sha1 ObjectFormatSHA1 sha256 ObjectFormatSHA256

string

Allowed values: sha1 sha256

open_issues_count

integer format: int64

open_pr_counter

integer format: int64

original_url

string

owner

User represents a user

object

active

Is user active

boolean

avatar_url

URL to the user’s avatar

string

created

string format: date-time

description

The user’s description

string

email

string format: email

followers_count

User counts

integer format: int64

following_count

integer format: int64

full_name

The user’s full name

string

html_url

URL to the user’s gitea page

string

The user’s id

integer format: int64

is_admin

Is the user an administrator

boolean

language

User locale

string

last_login

string format: date-time

location

The user’s location

string

login

string

login_name

Identifier of the user, provided by the external authenticator (if configured)

string

default: empty

prohibit_login

Is user login prohibited

boolean

restricted

Is user restricted

boolean

source_id

The ID of the user’s Authentication Source

integer format: int64

starred_repos_count

integer format: int64

visibility

User visibility level option: public, limited, private public UserVisibilityPublic limited UserVisibilityLimited private UserVisibilityPrivate

string

Allowed values: public limited private

website

The user’s website

string

parent

object recursive

permissions

Permission represents a set of permissions

object

admin

boolean

pull

boolean

push

boolean

private

boolean

projects_mode

string

release_counter

integer format: int64

repo_transfer

RepoTransfer represents a pending repo transfer

object

doer

User represents a user

object

active

Is user active

boolean

avatar_url

URL to the user’s avatar

string

created

string format: date-time

description

The user’s description

string

email

string format: email

followers_count

User counts

integer format: int64

following_count

integer format: int64

full_name

The user’s full name

string

html_url

URL to the user’s gitea page

string

The user’s id

integer format: int64

is_admin

Is the user an administrator

boolean

language

User locale

string

last_login

string format: date-time

location

The user’s location

string

login

string

login_name

Identifier of the user, provided by the external authenticator (if configured)

string

default: empty

prohibit_login

Is user login prohibited

boolean

restricted

Is user restricted

boolean

source_id

The ID of the user’s Authentication Source

integer format: int64

starred_repos_count

integer format: int64

visibility

User visibility level option: public, limited, private public UserVisibilityPublic limited UserVisibilityLimited private UserVisibilityPrivate

string

Allowed values: public limited private

website

The user’s website

string

recipient

User represents a user

object

active

Is user active

boolean

avatar_url

URL to the user’s avatar

string

created

string format: date-time

description

The user’s description

string

email

string format: email

followers_count

User counts

integer format: int64

following_count

integer format: int64

full_name

The user’s full name

string

html_url

URL to the user’s gitea page

string

The user’s id

integer format: int64

is_admin

Is the user an administrator

boolean

language

User locale

string

last_login

string format: date-time

location

The user’s location

string

login

string

login_name

Identifier of the user, provided by the external authenticator (if configured)

string

default: empty

prohibit_login

Is user login prohibited

boolean

restricted

Is user restricted

boolean

source_id

The ID of the user’s Authentication Source

integer format: int64

starred_repos_count

integer format: int64

visibility

User visibility level option: public, limited, private public UserVisibilityPublic limited UserVisibilityLimited private UserVisibilityPrivate

string

Allowed values: public limited private

website

The user’s website

string

teams

Array<object>

Team represents a team in an organization

object

can_create_org_repo

Whether the team can create repositories in the organization

boolean

description

The description of the team

string

The unique identifier of the team

integer format: int64

includes_all_repositories

Whether the team has access to all repositories in the organization

boolean

name

The name of the team

string

organization

Organization represents an organization

object

avatar_url

The URL of the organization’s avatar

string

description

The description of the organization

string

email

The email address of the organization

string

full_name

The full display name of the organization

string

The unique identifier of the organization

integer format: int64

location

The location of the organization

string

name

The name of the organization

string

repo_admin_change_team_access

Whether repository administrators can change team access

boolean

username

Username of the organization deprecated

string

visibility

The visibility level of the organization (public, limited, private) public UserVisibilityPublic limited UserVisibilityLimited private UserVisibilityPrivate

string

Allowed values: public limited private

website

The website URL of the organization

string

permission

string

Allowed values: none read write admin owner

units

Array<string>

units_map

object

key

additional properties

string

visibility

string

Allowed values: public limited private

size

integer format: int64

ssh_url

string

stars_count

integer format: int64

template

boolean

topics

Array<string>

updated_at

string format: date-time

url

string

watchers_count

integer format: int64

website

string

repository_id

integer format: int64

run_attempt

RunAttempt is 1-based for runs created after ActionRunAttempt was introduced. A value of 0 is a legacy-only sentinel for runs created before attempts existed and indicates no corresponding /attempts/{n} resource is available.

integer format: int64

run_number

integer format: int64

started_at

string format: date-time

status

string

trigger_actor

User represents a user

object

active

Is user active

boolean

avatar_url

URL to the user’s avatar

string

created

string format: date-time

description

The user’s description

string

email

string format: email

followers_count

User counts

integer format: int64

following_count

integer format: int64

full_name

The user’s full name

string

html_url

URL to the user’s gitea page

string

The user’s id

integer format: int64

is_admin

Is the user an administrator

boolean

language

User locale

string

last_login

string format: date-time

location

The user’s location

string

login

string

login_name

Identifier of the user, provided by the external authenticator (if configured)

string

default: empty

prohibit_login

Is user login prohibited

boolean

restricted

Is user restricted

boolean

source_id

The ID of the user’s Authentication Source

integer format: int64

starred_repos_count

integer format: int64

visibility

User visibility level option: public, limited, private public UserVisibilityPublic limited UserVisibilityLimited private UserVisibilityPrivate

string

Allowed values: public limited private

website

The user’s website

string

url

string

Example

{
  "workflow_runs": [
    {
      "actor": {
        "login_name": "empty",
        "visibility": "public"
      },
      "head_repository": {
        "object_format_name": "sha1",
        "owner": {
          "login_name": "empty",
          "visibility": "public"
        },
        "repo_transfer": {
          "doer": {
            "login_name": "empty",
            "visibility": "public"
          },
          "recipient": {
            "login_name": "empty",
            "visibility": "public"
          },
          "teams": [
            {
              "organization": {
                "visibility": "public"
              },
              "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"
              },
              "visibility": "public"
            }
          ]
        }
      },
      "repository": {
        "object_format_name": "sha1",
        "owner": {
          "login_name": "empty",
          "visibility": "public"
        },
        "repo_transfer": {
          "doer": {
            "login_name": "empty",
            "visibility": "public"
          },
          "recipient": {
            "login_name": "empty",
            "visibility": "public"
          },
          "teams": [
            {
              "organization": {
                "visibility": "public"
              },
              "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"
              },
              "visibility": "public"
            }
          ]
        }
      },
      "trigger_actor": {
        "login_name": "empty",
        "visibility": "public"
      }
    }
  ]
}

400

APIError is error format response

application/json

Headers

message

string

url

string

403

APIForbiddenError is a forbidden error response

application/json

Headers

message

string

url

string

404

APINotFound is a not found empty response

application/json