---
title: "Get a workflow"
method: GET
path: "/repos/{owner}/{repo}/actions/workflows/{workflow_id}"
tags: ["repository"]
---

# Get a workflow

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

## Request

- Base URL: `https://demo.gitea.com/api/v1`
- URL: `https://demo.gitea.com/api/v1/repos/{owner}/{repo}/actions/workflows/{workflow_id}`
- Auth: one of:
  - HTTP basic
  - API key in query parameter `token`
  - API key in query parameter `access_token`
  - API key in header `Authorization`
  - API key in query parameter `sudo`
  - API key in header `Sudo`
  - API key in header `X-GITEA-OTP`
- TypeScript: <https://skmtc.dev/gitea/apis/gitea-api/docs/repos/:owner/:repo/actions/workflows/:workflow_id/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `owner` string, required
- `repo` string, required
- `workflow_id` string, required

## Response `200`

ActionWorkflow

- ActionWorkflow: ActionWorkflow represents a ActionWorkflow
  - `badge_url` string: BadgeURL is the URL for the workflow badge
  - `created_at` string, date-time
  - `deleted_at` string, date-time
  - `html_url` string: HTMLURL is the web URL for viewing the workflow
  - `id` string: ID is the unique identifier for the workflow
  - `name` string: Name is the name of the workflow
  - `path` string: Path is the file path of the workflow
  - `state` string: State indicates if the workflow is active or disabled
  - `updated_at` string, date-time
  - `url` string: URL is the API URL for this workflow

## Other responses

- `default`: APIError is error format response

## Changes

- **2026-10-28** `7ef50c4c527f`: 5 info
  - removed the non-success response with the status `400`
  - removed the non-success response with the status `403`
  - removed the non-success response with the status `404`
  - removed the non-success response with the status `422`
  - …1 more
- **2025-05-20** `4ff3544d6eb3`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/gitea/apis/gitea-api/changes/repos/:owner/:repo/actions/workflows/:workflow_id/get.md)

---

[API](https://skmtc.dev/gitea/apis/gitea-api.md) - [All operations](https://skmtc.dev/gitea/apis/gitea-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gitea/apis/gitea-api/revisions/7ef50c4c527f?raw)