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

# Get a workflow

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

Gets a specific workflow. You can replace `workflow_id` with the workflow
file name. For example, you could use `main.yaml`.

Anyone with read access to the repository can use this endpoint.

OAuth app tokens and personal access tokens (classic) need the `repo` scope to use this endpoint with a private repository.

## Path parameters

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

## Response `200`

Response

- Workflow — A GitHub Actions workflow
  - `id` integer, required
  - `node_id` string, required
  - `name` string, required
  - `path` string, required
  - `state` 'active' | 'deleted' | 'disabled_fork' | 'disabled_inactivity' | 'disabled_manually', required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `url` string, required
  - `html_url` string, required
  - `badge_url` string, required
  - `deleted_at` string, date-time

---

[API](https://skmtc.net/github/apis/api-github-com.md) · [All operations](https://skmtc.net/github/apis/api-github-com/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/github/api-github-com/revisions/a367f7028301/schema)