Get a workflow

GET

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

curl --request GET \
  --url https://gitea.example.com/api/v1/repos/example/example/actions/workflows/example \
  --header 'Authorization: Basic <credentials>'

Authorizations

• BasicAuth
• Token
• AccessToken
• AuthorizationHeaderToken
• SudoParam
• SudoHeader
• TOTPHeader

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

Responses

200

ActionWorkflow

Media typeapplication/json

ActionWorkflow represents a ActionWorkflow

object

badge_url

BadgeURL is the URL for the workflow badge

string

created_at

string format: date-time

deleted_at

string format: date-time

html_url

HTMLURL is the web URL for viewing the workflow

string

id

ID is the unique identifier for the workflow

string

name

Name is the name of the workflow

string

path

Path is the file path of the workflow

string

state

State indicates if the workflow is active or disabled

string

updated_at

string format: date-time

url

URL is the API URL for this workflow

string

Example^generated

{
  "badge_url": "example",
  "created_at": "2026-04-15T12:00:00Z",
  "deleted_at": "2026-04-15T12:00:00Z",
  "html_url": "example",
  "id": "example",
  "name": "example",
  "path": "example",
  "state": "example",
  "updated_at": "2026-04-15T12:00:00Z",
  "url": "example"
}

400

APIError is error format response

Media typeapplication/json

Headers

message

string

url

string

403

APIForbiddenError is a forbidden error response

Media typeapplication/json

Headers

message

string

url

string

404

APINotFound is a not found empty response

Media typeapplication/json

422

APIValidationError is error format response related to input validation

Media typeapplication/json

Headers

message

string

url

string

500

APIError is error format response

Media typeapplication/json

Headers

message

string

url

string