Skip to content

get-workflow-run-usage is listed as going away but seems to be alive and kicking #43098

@jsoref

Description

@jsoref

Code of Conduct

What article on docs.github.com is affected?

https://docs.github.com/en/rest/actions/workflow-runs?apiVersion=2022-11-28#get-workflow-run-usage

What part(s) of the article would you like to see updated?

Get workflow run usage
⚠️ Warning

This endpoint is in the process of closing down. Refer to "Actions Get workflow usage and Get workflow run usage endpoints closing down" for more information.

...

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

Additional information

https://github.blog/changelog/2025-02-02-actions-get-workflow-usage-and-get-workflow-run-usage-endpoints-closing-down/

As part of the ongoing transition of Enterprise customers and Team plan customers to our new billing platform, the Actions Get workflow usage and Get workflow run usage endpoints will be closing down. The transition of Enterprise and Team plan customers to the new billing platform will complete by April 1, 2025.

If the API was gone as of April 1, 2025, then why is it still documented in https://docs.github.com/en/rest/actions/workflow-runs?apiVersion=2022-11-28#get-workflow-run-usage ??

I see that it's also documented for GHEC:
https://docs.github.com/en/enterprise-cloud@latest/rest/actions/workflow-runs?apiVersion=2022-11-28#get-workflow-run-usage

But it doesn't appear present in any version of GHES.


A quick check shows that the api appears to still work:

gh api /repos/check-spelling-sandbox/nyc/actions/runs/22286685153/timing
{
  "billable": {
    "UBUNTU": {
      "total_ms": 0,
      "jobs": 2,
      "job_runs": [
        {
          "job_id": 64466301047,
          "duration_ms": 0
        },
        {
          "job_id": 64466301057,
          "duration_ms": 0
        }
      ]
    },
    "WINDOWS": {
      "total_ms": 0,
      "jobs": 1,
      "job_runs": [
        {
          "job_id": 64466301065,
          "duration_ms": 0
        }
      ]
    }
  },
  "run_duration_ms": 191000
}

Metadata

Metadata

Assignees

No one assigned

    Labels

    contentThis issue or pull request belongs to the Docs Content teamtriageDo not begin working on this issue until triaged by the team

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions