tenseleyflow/shithub / 044f739

Browse files

Document actions workflow route literals

Authored by mfwolffe <wolffemf@dukes.jmu.edu>
SHA
044f739606025e0f33f3c7f23eaa89d114a83b16
Parents
49234c8
Tree
7b9dc8f

1 changed file

StatusFile+-
M docs/public/api/actions-workflows.md 3 2
docs/public/api/actions-workflows.mdmodified
@@ -15,8 +15,8 @@ Scopes:
1515
 
1616
 ```
1717
 GET  /api/v1/repos/{owner}/{repo}/actions/workflows                          list discovered workflows
18
-GET  /api/v1/repos/{owner}/{repo}/actions/workflows/{id_or_file}             single workflow
19
-POST /api/v1/repos/{owner}/{repo}/actions/workflows/{file}/dispatches        workflow_dispatch
18
+GET  /api/v1/repos/{owner}/{repo}/actions/workflows/{workflow}               single workflow
19
+POST /api/v1/repos/{owner}/{repo}/actions/workflows/{workflow}/dispatches    workflow_dispatch
2020
 ```
2121
 
2222
 ## Discovery model
@@ -29,6 +29,7 @@ in the listing — with their basename as the name — so the listing
2929
 reflects ground truth rather than silently dropping broken
3030
 workflows.
3131
 
32
+The `{workflow}` path segment is the workflow id or file selector.
3233
 The `id` field on each entry is a deterministic 64-bit hash of the
3334
 file path so gh-shaped clients that pass `workflow_id` still work:
3435
 both `ci.yml` (basename), `.shithub/workflows/ci.yml` (full path),