skillfullstack 0.0.0-stage → 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (775) hide show
  1. package/.skillsRegistry/catalog.json +231 -0
  2. package/AGENTS.md +89 -0
  3. package/README.md +210 -2
  4. package/bin/index.js +508 -0
  5. package/package.json +57 -4
  6. package/skills/backend/apiEngineering/SKILL.md +102 -0
  7. package/skills/backend/apiEngineering/evals/evalApiEngineering.py +81 -0
  8. package/skills/backend/apiEngineering/evals/fixtures/invalid/sampleInvalidOpenApi.json +40 -0
  9. package/skills/backend/apiEngineering/evals/fixtures/valid/sampleValidOpenApi.json +47 -0
  10. package/skills/backend/apiEngineering/policies/compatibility.md +42 -0
  11. package/skills/backend/apiEngineering/policies/mandatory.md +48 -0
  12. package/skills/backend/apiEngineering/policies/performance.md +39 -0
  13. package/skills/backend/apiEngineering/policies/security.md +36 -0
  14. package/skills/backend/apiEngineering/references/apiObservability.md +39 -0
  15. package/skills/backend/apiEngineering/references/apiReference.md +3 -0
  16. package/skills/backend/apiEngineering/references/apiSecurityOwasp.md +47 -0
  17. package/skills/backend/apiEngineering/references/contractCompatibility.md +26 -0
  18. package/skills/backend/apiEngineering/references/databaseTransactions.md +40 -0
  19. package/skills/backend/apiEngineering/references/distributedReliability.md +26 -0
  20. package/skills/backend/apiEngineering/references/multiTenancy.md +27 -0
  21. package/skills/backend/apiEngineering/references/openApi32Standards.md +58 -0
  22. package/skills/backend/apiEngineering/references/paginationVersioning.md +57 -0
  23. package/skills/backend/apiEngineering/references/responseStandards.md +94 -0
  24. package/skills/backend/apiEngineering/scripts/auditApiContract.py +123 -0
  25. package/skills/backend/apiEngineering/scripts/checkBreakingChanges.py +77 -0
  26. package/skills/backend/apiEngineering/scripts/generateResponseEnvelope.py +88 -0
  27. package/skills/backend/apiEngineering/templates/apiChecklist.md +27 -0
  28. package/skills/backend/apiEngineering/templates/openapi.yaml +125 -0
  29. package/skills/backend/apiEngineering/templates/problemDetails.json +44 -0
  30. package/skills/backend/databaseArchitecture/SKILL.md +118 -0
  31. package/skills/backend/databaseArchitecture/evals/evalDatabaseArchitecture.py +85 -0
  32. package/skills/backend/databaseArchitecture/evals/fixtures/dangerousMigration.sql +4 -0
  33. package/skills/backend/databaseArchitecture/evals/fixtures/invalidSchema.sql +23 -0
  34. package/skills/backend/databaseArchitecture/evals/fixtures/safeMigration.sql +3 -0
  35. package/skills/backend/databaseArchitecture/evals/fixtures/validSchema.sql +37 -0
  36. package/skills/backend/databaseArchitecture/policies/integrity.md +25 -0
  37. package/skills/backend/databaseArchitecture/policies/mandatory.md +32 -0
  38. package/skills/backend/databaseArchitecture/policies/migration.md +22 -0
  39. package/skills/backend/databaseArchitecture/policies/normalization.md +25 -0
  40. package/skills/backend/databaseArchitecture/policies/performance.md +26 -0
  41. package/skills/backend/databaseArchitecture/policies/recovery.md +23 -0
  42. package/skills/backend/databaseArchitecture/policies/security.md +26 -0
  43. package/skills/backend/databaseArchitecture/policies/tableCreationChecklist.md +70 -0
  44. package/skills/backend/databaseArchitecture/references/analyticsWarehousing.md +32 -0
  45. package/skills/backend/databaseArchitecture/references/apiReference.md +3 -0
  46. package/skills/backend/databaseArchitecture/references/backupDisasterRecovery.md +27 -0
  47. package/skills/backend/databaseArchitecture/references/dataModelingLifecycle.md +30 -0
  48. package/skills/backend/databaseArchitecture/references/databaseTaxonomy.md +32 -0
  49. package/skills/backend/databaseArchitecture/references/indexingOptimization.md +32 -0
  50. package/skills/backend/databaseArchitecture/references/normalizationTheory.md +61 -0
  51. package/skills/backend/databaseArchitecture/references/scalabilitySharding.md +37 -0
  52. package/skills/backend/databaseArchitecture/references/transactionConcurrency.md +39 -0
  53. package/skills/backend/databaseArchitecture/scripts/analyzeMigration.py +99 -0
  54. package/skills/backend/databaseArchitecture/scripts/auditDatabaseSchema.py +177 -0
  55. package/skills/backend/databaseArchitecture/scripts/inspectDatabaseIndexes.py +149 -0
  56. package/skills/backend/databaseArchitecture/templates/adrTemplate.md +32 -0
  57. package/skills/backend/databaseArchitecture/templates/databaseChecklist.md +29 -0
  58. package/skills/backend/databaseArchitecture/templates/migrationPlan.md +40 -0
  59. package/skills/backend/durableBackgroundJobs/SKILL.md +112 -0
  60. package/skills/backend/durableBackgroundJobs/evals/durableJobVerification.json +14 -0
  61. package/skills/backend/durableBackgroundJobs/references/apiReference.md +3 -0
  62. package/skills/backend/durableBackgroundJobs/references/durableStepPatterns.md +6 -0
  63. package/skills/backend/durableBackgroundJobs/references/idempotencyKeys.md +5 -0
  64. package/skills/backend/durableBackgroundJobs/scripts/testWorkflowDispatch.py +24 -0
  65. package/skills/backend/golangStandard/SKILL.md +155 -0
  66. package/skills/backend/golangStandard/evals/goVerification.json +14 -0
  67. package/skills/backend/golangStandard/references/apiReference.md +3 -0
  68. package/skills/backend/golangStandard/references/layoutGuide.md +26 -0
  69. package/skills/backend/golangStandard/references/slogPatterns.md +26 -0
  70. package/skills/backend/golangStandard/scripts/scaffoldGoModule.py +105 -0
  71. package/skills/backend/pythonStandard/SKILL.md +138 -0
  72. package/skills/backend/pythonStandard/evals/pythonVerification.json +14 -0
  73. package/skills/backend/pythonStandard/references/apiReference.md +3 -0
  74. package/skills/backend/pythonStandard/references/pydanticPatterns.md +16 -0
  75. package/skills/backend/pythonStandard/references/pyprojectSpecs.md +37 -0
  76. package/skills/backend/pythonStandard/scripts/scaffoldUvProject.py +79 -0
  77. package/skills/backend/upstash/SKILL.md +98 -0
  78. package/skills/backend/upstash/evals/upstashVerification.json +14 -0
  79. package/skills/backend/upstash/references/apiReference.md +3 -0
  80. package/skills/backend/upstash/references/qstashFlowControl.md +34 -0
  81. package/skills/backend/upstash/references/ratelimitPatterns.md +53 -0
  82. package/skills/backend/upstash/references/workflowPatterns.md +35 -0
  83. package/skills/backend/upstash/scripts/testRedisConnection.py +36 -0
  84. package/skills/cicdDevops/cicdPipeline/SKILL.md +148 -0
  85. package/skills/cicdDevops/cicdPipeline/evals/evalCicd.py +37 -0
  86. package/skills/cicdDevops/cicdPipeline/references/apiReference.md +3 -0
  87. package/skills/cicdDevops/cicdPipeline/references/cicdDeploymentPatterns.md +27 -0
  88. package/skills/cicdDevops/cicdPipeline/scripts/auditDockerfileSecurity.py +56 -0
  89. package/skills/dataAi/mcpServerDevelopment/SKILL.md +123 -0
  90. package/skills/dataAi/mcpServerDevelopment/evals/mcpVerification.json +14 -0
  91. package/skills/dataAi/mcpServerDevelopment/references/apiReference.md +3 -0
  92. package/skills/dataAi/mcpServerDevelopment/references/mcpClientConfigs.md +38 -0
  93. package/skills/dataAi/mcpServerDevelopment/references/toolSchemaDesign.md +6 -0
  94. package/skills/dataAi/mcpServerDevelopment/scripts/runFastMcpBoilerplate.py +36 -0
  95. package/skills/dataAi/ragPipelineProduction/SKILL.md +113 -0
  96. package/skills/dataAi/ragPipelineProduction/evals/ragVerification.json +14 -0
  97. package/skills/dataAi/ragPipelineProduction/references/apiReference.md +3 -0
  98. package/skills/dataAi/ragPipelineProduction/references/chunkingStrategies.md +10 -0
  99. package/skills/dataAi/ragPipelineProduction/references/rrfAlgorithm.md +13 -0
  100. package/skills/dataAi/ragPipelineProduction/scripts/runHybridRrfSearch.py +33 -0
  101. package/skills/devopsCloud/cloudflare/SKILL.md +282 -0
  102. package/skills/devopsCloud/cloudflare/assets/README.md +48 -0
  103. package/skills/devopsCloud/cloudflare/assets/ai/agents-sdk.md +118 -0
  104. package/skills/devopsCloud/cloudflare/assets/ai/ai-gateway.md +105 -0
  105. package/skills/devopsCloud/cloudflare/assets/ai/ai-search.md +129 -0
  106. package/skills/devopsCloud/cloudflare/assets/ai/workers-ai.md +127 -0
  107. package/skills/devopsCloud/cloudflare/assets/cli/c3.md +292 -0
  108. package/skills/devopsCloud/cloudflare/assets/cli/cf-cli.md +90 -0
  109. package/skills/devopsCloud/cloudflare/assets/cli/wrangler.md +43 -0
  110. package/skills/devopsCloud/cloudflare/assets/compute/cron-triggers.md +486 -0
  111. package/skills/devopsCloud/cloudflare/assets/compute/service-bindings.md +251 -0
  112. package/skills/devopsCloud/cloudflare/assets/compute/smart-placement.md +435 -0
  113. package/skills/devopsCloud/cloudflare/assets/compute/static-assets.md +220 -0
  114. package/skills/devopsCloud/cloudflare/assets/compute/workers.md +129 -0
  115. package/skills/devopsCloud/cloudflare/assets/database-storage/d1.md +105 -0
  116. package/skills/devopsCloud/cloudflare/assets/database-storage/durable-objects.md +122 -0
  117. package/skills/devopsCloud/cloudflare/assets/database-storage/hyperdrive.md +210 -0
  118. package/skills/devopsCloud/cloudflare/assets/database-storage/kv.md +198 -0
  119. package/skills/devopsCloud/cloudflare/assets/database-storage/queues.md +105 -0
  120. package/skills/devopsCloud/cloudflare/assets/database-storage/r2.md +105 -0
  121. package/skills/devopsCloud/cloudflare/assets/database-storage/vectorize.md +97 -0
  122. package/skills/devopsCloud/cloudflare/assets/database-storage/workflows.md +141 -0
  123. package/skills/devopsCloud/cloudflare/assets/llms.txt +143 -0
  124. package/skills/devopsCloud/cloudflare/assets/networking-security/cache-cdn.md +109 -0
  125. package/skills/devopsCloud/cloudflare/assets/networking-security/dns.md +71 -0
  126. package/skills/devopsCloud/cloudflare/assets/networking-security/rate-limiting.md +130 -0
  127. package/skills/devopsCloud/cloudflare/assets/networking-security/tunnels.md +57 -0
  128. package/skills/devopsCloud/cloudflare/assets/networking-security/waf.md +143 -0
  129. package/skills/devopsCloud/cloudflare/assets/troubleshooting/1xxx-errors.md +209 -0
  130. package/skills/devopsCloud/cloudflare/assets/troubleshooting/5xx-errors.md +111 -0
  131. package/skills/devopsCloud/cloudflare/assets/troubleshooting/http-status-codes.md +38 -0
  132. package/skills/devopsCloud/cloudflare/evals/evals.json +75 -0
  133. package/skills/devopsCloud/cloudflare/references/ai-gateway/README.md +27 -0
  134. package/skills/devopsCloud/cloudflare/references/ai-gateway/configuration.md +18 -0
  135. package/skills/devopsCloud/cloudflare/references/ai-gateway/dynamic-routing.md +15 -0
  136. package/skills/devopsCloud/cloudflare/references/ai-gateway/features.md +22 -0
  137. package/skills/devopsCloud/cloudflare/references/ai-gateway/sdk-integration.md +19 -0
  138. package/skills/devopsCloud/cloudflare/references/ai-gateway/troubleshooting.md +16 -0
  139. package/skills/devopsCloud/cloudflare/references/ai-search/README.md +25 -0
  140. package/skills/devopsCloud/cloudflare/references/ai-search/api.md +13 -0
  141. package/skills/devopsCloud/cloudflare/references/ai-search/configuration.md +16 -0
  142. package/skills/devopsCloud/cloudflare/references/ai-search/gotchas.md +13 -0
  143. package/skills/devopsCloud/cloudflare/references/ai-search/patterns.md +15 -0
  144. package/skills/devopsCloud/cloudflare/references/bindings/README.md +16 -0
  145. package/skills/devopsCloud/cloudflare/references/bindings/api.md +19 -0
  146. package/skills/devopsCloud/cloudflare/references/bindings/configuration.md +20 -0
  147. package/skills/devopsCloud/cloudflare/references/bindings/gotchas.md +18 -0
  148. package/skills/devopsCloud/cloudflare/references/bindings/patterns.md +20 -0
  149. package/skills/devopsCloud/cloudflare/references/browser-rendering/README.md +18 -0
  150. package/skills/devopsCloud/cloudflare/references/browser-rendering/api.md +12 -0
  151. package/skills/devopsCloud/cloudflare/references/browser-rendering/configuration.md +12 -0
  152. package/skills/devopsCloud/cloudflare/references/browser-rendering/gotchas.md +15 -0
  153. package/skills/devopsCloud/cloudflare/references/browser-rendering/patterns.md +12 -0
  154. package/skills/devopsCloud/cloudflare/references/cliComparison.md +93 -0
  155. package/skills/devopsCloud/cloudflare/references/containers/README.md +23 -0
  156. package/skills/devopsCloud/cloudflare/references/containers/api.md +13 -0
  157. package/skills/devopsCloud/cloudflare/references/containers/configuration.md +15 -0
  158. package/skills/devopsCloud/cloudflare/references/containers/gotchas.md +16 -0
  159. package/skills/devopsCloud/cloudflare/references/containers/patterns.md +18 -0
  160. package/skills/devopsCloud/cloudflare/references/cron-triggers/README.md +20 -0
  161. package/skills/devopsCloud/cloudflare/references/cron-triggers/api.md +16 -0
  162. package/skills/devopsCloud/cloudflare/references/cron-triggers/configuration.md +16 -0
  163. package/skills/devopsCloud/cloudflare/references/cron-triggers/gotchas.md +17 -0
  164. package/skills/devopsCloud/cloudflare/references/cron-triggers/patterns.md +18 -0
  165. package/skills/devopsCloud/cloudflare/references/d1/README.md +15 -0
  166. package/skills/devopsCloud/cloudflare/references/d1/api.md +18 -0
  167. package/skills/devopsCloud/cloudflare/references/d1/configuration.md +18 -0
  168. package/skills/devopsCloud/cloudflare/references/d1/gotchas.md +18 -0
  169. package/skills/devopsCloud/cloudflare/references/d1/patterns.md +21 -0
  170. package/skills/devopsCloud/cloudflare/references/frameworkCompatibility.md +110 -0
  171. package/skills/devopsCloud/cloudflare/references/hyperdrive/README.md +28 -0
  172. package/skills/devopsCloud/cloudflare/references/hyperdrive/api.md +26 -0
  173. package/skills/devopsCloud/cloudflare/references/hyperdrive/configuration.md +34 -0
  174. package/skills/devopsCloud/cloudflare/references/hyperdrive/gotchas.md +20 -0
  175. package/skills/devopsCloud/cloudflare/references/hyperdrive/patterns.md +15 -0
  176. package/skills/devopsCloud/cloudflare/references/images/README.md +12 -0
  177. package/skills/devopsCloud/cloudflare/references/images/api.md +13 -0
  178. package/skills/devopsCloud/cloudflare/references/images/configuration.md +17 -0
  179. package/skills/devopsCloud/cloudflare/references/images/gotchas.md +16 -0
  180. package/skills/devopsCloud/cloudflare/references/images/patterns.md +16 -0
  181. package/skills/devopsCloud/cloudflare/references/kv/README.md +15 -0
  182. package/skills/devopsCloud/cloudflare/references/kv/api.md +18 -0
  183. package/skills/devopsCloud/cloudflare/references/kv/configuration.md +16 -0
  184. package/skills/devopsCloud/cloudflare/references/kv/gotchas.md +17 -0
  185. package/skills/devopsCloud/cloudflare/references/kv/patterns.md +21 -0
  186. package/skills/devopsCloud/cloudflare/references/miniflare/README.md +22 -0
  187. package/skills/devopsCloud/cloudflare/references/miniflare/api.md +16 -0
  188. package/skills/devopsCloud/cloudflare/references/miniflare/configuration.md +16 -0
  189. package/skills/devopsCloud/cloudflare/references/miniflare/gotchas.md +15 -0
  190. package/skills/devopsCloud/cloudflare/references/miniflare/patterns.md +19 -0
  191. package/skills/devopsCloud/cloudflare/references/observability/README.md +27 -0
  192. package/skills/devopsCloud/cloudflare/references/observability/api.md +20 -0
  193. package/skills/devopsCloud/cloudflare/references/observability/configuration.md +23 -0
  194. package/skills/devopsCloud/cloudflare/references/observability/gotchas.md +25 -0
  195. package/skills/devopsCloud/cloudflare/references/observability/patterns.md +14 -0
  196. package/skills/devopsCloud/cloudflare/references/pages/README.md +20 -0
  197. package/skills/devopsCloud/cloudflare/references/pages/api.md +13 -0
  198. package/skills/devopsCloud/cloudflare/references/pages/configuration.md +16 -0
  199. package/skills/devopsCloud/cloudflare/references/pages/gotchas.md +19 -0
  200. package/skills/devopsCloud/cloudflare/references/pages/patterns.md +15 -0
  201. package/skills/devopsCloud/cloudflare/references/pages-functions/README.md +20 -0
  202. package/skills/devopsCloud/cloudflare/references/pages-functions/api.md +13 -0
  203. package/skills/devopsCloud/cloudflare/references/pages-functions/configuration.md +14 -0
  204. package/skills/devopsCloud/cloudflare/references/pages-functions/gotchas.md +17 -0
  205. package/skills/devopsCloud/cloudflare/references/pages-functions/patterns.md +16 -0
  206. package/skills/devopsCloud/cloudflare/references/productSelectionMatrix.md +54 -0
  207. package/skills/devopsCloud/cloudflare/references/queues/README.md +24 -0
  208. package/skills/devopsCloud/cloudflare/references/queues/api.md +16 -0
  209. package/skills/devopsCloud/cloudflare/references/queues/configuration.md +20 -0
  210. package/skills/devopsCloud/cloudflare/references/queues/gotchas.md +18 -0
  211. package/skills/devopsCloud/cloudflare/references/queues/patterns.md +21 -0
  212. package/skills/devopsCloud/cloudflare/references/r2/README.md +26 -0
  213. package/skills/devopsCloud/cloudflare/references/r2/api.md +16 -0
  214. package/skills/devopsCloud/cloudflare/references/r2/configuration.md +19 -0
  215. package/skills/devopsCloud/cloudflare/references/r2/gotchas.md +17 -0
  216. package/skills/devopsCloud/cloudflare/references/r2/patterns.md +18 -0
  217. package/skills/devopsCloud/cloudflare/references/secrets-store/README.md +22 -0
  218. package/skills/devopsCloud/cloudflare/references/secrets-store/api.md +21 -0
  219. package/skills/devopsCloud/cloudflare/references/secrets-store/configuration.md +25 -0
  220. package/skills/devopsCloud/cloudflare/references/secrets-store/gotchas.md +19 -0
  221. package/skills/devopsCloud/cloudflare/references/secrets-store/patterns.md +27 -0
  222. package/skills/devopsCloud/cloudflare/references/skill-feedback.md +41 -0
  223. package/skills/devopsCloud/cloudflare/references/static-assets/README.md +21 -0
  224. package/skills/devopsCloud/cloudflare/references/static-assets/api.md +16 -0
  225. package/skills/devopsCloud/cloudflare/references/static-assets/configuration.md +16 -0
  226. package/skills/devopsCloud/cloudflare/references/static-assets/gotchas.md +18 -0
  227. package/skills/devopsCloud/cloudflare/references/static-assets/patterns.md +17 -0
  228. package/skills/devopsCloud/cloudflare/references/stream/README.md +22 -0
  229. package/skills/devopsCloud/cloudflare/references/stream/api-live.md +18 -0
  230. package/skills/devopsCloud/cloudflare/references/stream/api.md +21 -0
  231. package/skills/devopsCloud/cloudflare/references/stream/configuration.md +18 -0
  232. package/skills/devopsCloud/cloudflare/references/stream/gotchas.md +18 -0
  233. package/skills/devopsCloud/cloudflare/references/stream/patterns.md +22 -0
  234. package/skills/devopsCloud/cloudflare/references/tail-workers/README.md +21 -0
  235. package/skills/devopsCloud/cloudflare/references/tail-workers/api.md +13 -0
  236. package/skills/devopsCloud/cloudflare/references/tail-workers/configuration.md +15 -0
  237. package/skills/devopsCloud/cloudflare/references/tail-workers/gotchas.md +16 -0
  238. package/skills/devopsCloud/cloudflare/references/tail-workers/patterns.md +15 -0
  239. package/skills/devopsCloud/cloudflare/references/tunnel/README.md +20 -0
  240. package/skills/devopsCloud/cloudflare/references/tunnel/api.md +14 -0
  241. package/skills/devopsCloud/cloudflare/references/tunnel/configuration.md +14 -0
  242. package/skills/devopsCloud/cloudflare/references/tunnel/gotchas.md +15 -0
  243. package/skills/devopsCloud/cloudflare/references/tunnel/networking.md +14 -0
  244. package/skills/devopsCloud/cloudflare/references/tunnel/patterns.md +15 -0
  245. package/skills/devopsCloud/cloudflare/references/vectorize/README.md +22 -0
  246. package/skills/devopsCloud/cloudflare/references/vectorize/api.md +18 -0
  247. package/skills/devopsCloud/cloudflare/references/vectorize/configuration.md +19 -0
  248. package/skills/devopsCloud/cloudflare/references/vectorize/gotchas.md +15 -0
  249. package/skills/devopsCloud/cloudflare/references/vectorize/patterns.md +24 -0
  250. package/skills/devopsCloud/cloudflare/references/waf/README.md +21 -0
  251. package/skills/devopsCloud/cloudflare/references/waf/api.md +17 -0
  252. package/skills/devopsCloud/cloudflare/references/waf/configuration.md +18 -0
  253. package/skills/devopsCloud/cloudflare/references/waf/gotchas.md +19 -0
  254. package/skills/devopsCloud/cloudflare/references/waf/patterns.md +17 -0
  255. package/skills/devopsCloud/cloudflare/references/workers-ai/README.md +24 -0
  256. package/skills/devopsCloud/cloudflare/references/workers-ai/api.md +13 -0
  257. package/skills/devopsCloud/cloudflare/references/workers-ai/configuration.md +16 -0
  258. package/skills/devopsCloud/cloudflare/references/workers-ai/gotchas.md +15 -0
  259. package/skills/devopsCloud/cloudflare/references/workers-ai/patterns.md +14 -0
  260. package/skills/devopsCloud/cloudflare/references/workflows/README.md +23 -0
  261. package/skills/devopsCloud/cloudflare/references/workflows/api.md +17 -0
  262. package/skills/devopsCloud/cloudflare/references/workflows/configuration.md +18 -0
  263. package/skills/devopsCloud/cloudflare/references/workflows/gotchas.md +19 -0
  264. package/skills/devopsCloud/cloudflare/references/workflows/patterns.md +30 -0
  265. package/skills/devopsCloud/cloudflare/scripts/auditCloudflareProduction.py +95 -0
  266. package/skills/foundation/promptEvalTesting/SKILL.md +114 -0
  267. package/skills/foundation/promptEvalTesting/evals/promptEvalVerification.json +14 -0
  268. package/skills/foundation/promptEvalTesting/references/apiReference.md +3 -0
  269. package/skills/foundation/promptEvalTesting/references/evalMetricsCatalog.md +7 -0
  270. package/skills/foundation/promptEvalTesting/references/promptfooConfigSpecs.md +16 -0
  271. package/skills/foundation/promptEvalTesting/scripts/runPromptEvalSuite.py +29 -0
  272. package/skills/frontend/astro/SKILL.md +327 -0
  273. package/skills/frontend/astro/assets/README.md +71 -0
  274. package/skills/frontend/astro/assets/add-content-to-your-site/content-collections.md +1061 -0
  275. package/skills/frontend/astro/assets/add-content-to-your-site/data-fetching.md +109 -0
  276. package/skills/frontend/astro/assets/add-content-to-your-site/images.md +719 -0
  277. package/skills/frontend/astro/assets/add-content-to-your-site/markdown.md +725 -0
  278. package/skills/frontend/astro/assets/build-your-ui/components.md +402 -0
  279. package/skills/frontend/astro/assets/build-your-ui/fonts.md +437 -0
  280. package/skills/frontend/astro/assets/build-your-ui/front-end-frameworks.md +245 -0
  281. package/skills/frontend/astro/assets/build-your-ui/layouts.md +267 -0
  282. package/skills/frontend/astro/assets/build-your-ui/scripts-and-event-handling.md +229 -0
  283. package/skills/frontend/astro/assets/build-your-ui/styles-and-css.md +782 -0
  284. package/skills/frontend/astro/assets/build-your-ui/syntax-highlighting.md +269 -0
  285. package/skills/frontend/astro/assets/configuration/build-with-ai.md +389 -0
  286. package/skills/frontend/astro/assets/configuration/configuration-overview.md +122 -0
  287. package/skills/frontend/astro/assets/configuration/dev-toolbar.md +86 -0
  288. package/skills/frontend/astro/assets/configuration/editor-setup.md +166 -0
  289. package/skills/frontend/astro/assets/configuration/environment-variables.md +352 -0
  290. package/skills/frontend/astro/assets/configuration/typescript.md +379 -0
  291. package/skills/frontend/astro/assets/configuration/working-with-integrations.md +606 -0
  292. package/skills/frontend/astro/assets/reference/adapter-reference.md +1242 -0
  293. package/skills/frontend/astro/assets/reference/cli-reference.md +575 -0
  294. package/skills/frontend/astro/assets/reference/configuration-reference.md +3144 -0
  295. package/skills/frontend/astro/assets/reference/content-loader-reference.md +1682 -0
  296. package/skills/frontend/astro/assets/reference/directives-reference.md +324 -0
  297. package/skills/frontend/astro/assets/reference/image-service-reference.md +346 -0
  298. package/skills/frontend/astro/assets/reference/integrations-reference.md +2813 -0
  299. package/skills/frontend/astro/assets/reference/modules/astro-actions.md +604 -0
  300. package/skills/frontend/astro/assets/reference/modules/astro-app.md +460 -0
  301. package/skills/frontend/astro/assets/reference/modules/astro-assets.md +1657 -0
  302. package/skills/frontend/astro/assets/reference/modules/astro-config.md +395 -0
  303. package/skills/frontend/astro/assets/reference/modules/astro-content.md +720 -0
  304. package/skills/frontend/astro/assets/reference/modules/astro-env.md +46 -0
  305. package/skills/frontend/astro/assets/reference/modules/astro-fetch.md +346 -0
  306. package/skills/frontend/astro/assets/reference/modules/astro-hono.md +37 -0
  307. package/skills/frontend/astro/assets/reference/modules/astro-i18n.md +462 -0
  308. package/skills/frontend/astro/assets/reference/modules/astro-middleware.md +292 -0
  309. package/skills/frontend/astro/assets/reference/modules/astro-static-paths.md +74 -0
  310. package/skills/frontend/astro/assets/reference/modules/astro-transitions.md +595 -0
  311. package/skills/frontend/astro/assets/reference/modules/astro-zod.md +120 -0
  312. package/skills/frontend/astro/assets/reference/session-driver-reference.md +205 -0
  313. package/skills/frontend/astro/assets/routing-and-navigation/endpoints.md +251 -0
  314. package/skills/frontend/astro/assets/routing-and-navigation/internationalization.md +374 -0
  315. package/skills/frontend/astro/assets/routing-and-navigation/middleware.md +288 -0
  316. package/skills/frontend/astro/assets/routing-and-navigation/pages.md +205 -0
  317. package/skills/frontend/astro/assets/routing-and-navigation/prefetch.md +273 -0
  318. package/skills/frontend/astro/assets/routing-and-navigation/routing.md +760 -0
  319. package/skills/frontend/astro/assets/routing-and-navigation/view-transitions.md +792 -0
  320. package/skills/frontend/astro/assets/server-rendering/actions.md +770 -0
  321. package/skills/frontend/astro/assets/server-rendering/caching.md +255 -0
  322. package/skills/frontend/astro/assets/server-rendering/on-demand-rendering.md +289 -0
  323. package/skills/frontend/astro/assets/server-rendering/server-islands.md +126 -0
  324. package/skills/frontend/astro/assets/server-rendering/sessions.md +270 -0
  325. package/skills/frontend/astro/assets/start-a-new-project/develop-and-build.md +147 -0
  326. package/skills/frontend/astro/assets/start-a-new-project/installation.md +342 -0
  327. package/skills/frontend/astro/assets/start-a-new-project/project-structure.md +137 -0
  328. package/skills/frontend/astro/assets/upgrade-and-troubleshooting/testing.md +412 -0
  329. package/skills/frontend/astro/assets/upgrade-and-troubleshooting/troubleshooting.md +229 -0
  330. package/skills/frontend/astro/assets/upgrade-and-troubleshooting/upgrade-astro.md +205 -0
  331. package/skills/frontend/astro/assets/welcome/courses.md +46 -0
  332. package/skills/frontend/astro/assets/welcome/islands-architecture.md +135 -0
  333. package/skills/frontend/astro/assets/welcome/why-astro.md +90 -0
  334. package/skills/frontend/astro/evals/evals.json +66 -0
  335. package/skills/frontend/astro/references/contentCollections.md +164 -0
  336. package/skills/frontend/astro/references/islandsArchitecture.md +128 -0
  337. package/skills/frontend/astro/references/serverIslandsAndActions.md +187 -0
  338. package/skills/frontend/astro/scripts/auditAstroProduction.py +78 -0
  339. package/skills/frontend/generativeUi/SKILL.md +128 -0
  340. package/skills/frontend/generativeUi/evals/generativeUiVerification.json +14 -0
  341. package/skills/frontend/generativeUi/references/apiReference.md +3 -0
  342. package/skills/frontend/generativeUi/references/clientToolComponentMapping.md +8 -0
  343. package/skills/frontend/generativeUi/references/dataStreamProtocol.md +10 -0
  344. package/skills/frontend/generativeUi/scripts/generateUiComponentStub.py +46 -0
  345. package/skills/frontend/nextjs/SKILL.md +138 -0
  346. package/skills/frontend/nextjs/assets/README.md +67 -0
  347. package/skills/frontend/nextjs/assets/api-reference/cli/create-next-app.md +210 -0
  348. package/skills/frontend/nextjs/assets/api-reference/cli/next.md +484 -0
  349. package/skills/frontend/nextjs/assets/api-reference/components/font.md +952 -0
  350. package/skills/frontend/nextjs/assets/api-reference/components/form.md +387 -0
  351. package/skills/frontend/nextjs/assets/api-reference/components/image.md +1372 -0
  352. package/skills/frontend/nextjs/assets/api-reference/components/link.md +954 -0
  353. package/skills/frontend/nextjs/assets/api-reference/components/script.md +421 -0
  354. package/skills/frontend/nextjs/assets/api-reference/directives/use-cache-private.md +211 -0
  355. package/skills/frontend/nextjs/assets/api-reference/directives/use-cache-remote.md +652 -0
  356. package/skills/frontend/nextjs/assets/api-reference/directives/use-cache.md +848 -0
  357. package/skills/frontend/nextjs/assets/api-reference/directives/use-client.md +149 -0
  358. package/skills/frontend/nextjs/assets/api-reference/directives/use-server.md +234 -0
  359. package/skills/frontend/nextjs/assets/api-reference/edge-runtime.md +188 -0
  360. package/skills/frontend/nextjs/assets/api-reference/file-conventions/default.md +80 -0
  361. package/skills/frontend/nextjs/assets/api-reference/file-conventions/dynamic-routes.md +417 -0
  362. package/skills/frontend/nextjs/assets/api-reference/file-conventions/error.md +361 -0
  363. package/skills/frontend/nextjs/assets/api-reference/file-conventions/forbidden.md +75 -0
  364. package/skills/frontend/nextjs/assets/api-reference/file-conventions/instrumentation-client.md +308 -0
  365. package/skills/frontend/nextjs/assets/api-reference/file-conventions/instrumentation.md +177 -0
  366. package/skills/frontend/nextjs/assets/api-reference/file-conventions/intercepting-routes.md +78 -0
  367. package/skills/frontend/nextjs/assets/api-reference/file-conventions/layout.md +803 -0
  368. package/skills/frontend/nextjs/assets/api-reference/file-conventions/loading.md +209 -0
  369. package/skills/frontend/nextjs/assets/api-reference/file-conventions/mdx-components.md +84 -0
  370. package/skills/frontend/nextjs/assets/api-reference/file-conventions/metadata/app-icons.md +302 -0
  371. package/skills/frontend/nextjs/assets/api-reference/file-conventions/metadata/manifest.md +90 -0
  372. package/skills/frontend/nextjs/assets/api-reference/file-conventions/metadata/opengraph-image.md +580 -0
  373. package/skills/frontend/nextjs/assets/api-reference/file-conventions/metadata/robots.md +234 -0
  374. package/skills/frontend/nextjs/assets/api-reference/file-conventions/metadata/sitemap.md +459 -0
  375. package/skills/frontend/nextjs/assets/api-reference/file-conventions/not-found.md +278 -0
  376. package/skills/frontend/nextjs/assets/api-reference/file-conventions/page.md +283 -0
  377. package/skills/frontend/nextjs/assets/api-reference/file-conventions/parallel-routes.md +517 -0
  378. package/skills/frontend/nextjs/assets/api-reference/file-conventions/proxy.md +857 -0
  379. package/skills/frontend/nextjs/assets/api-reference/file-conventions/public-folder.md +47 -0
  380. package/skills/frontend/nextjs/assets/api-reference/file-conventions/route-groups.md +40 -0
  381. package/skills/frontend/nextjs/assets/api-reference/file-conventions/route-segment-config/dynamicParams.md +40 -0
  382. package/skills/frontend/nextjs/assets/api-reference/file-conventions/route-segment-config/ensureStatic.md +195 -0
  383. package/skills/frontend/nextjs/assets/api-reference/file-conventions/route-segment-config/instant.md +204 -0
  384. package/skills/frontend/nextjs/assets/api-reference/file-conventions/route-segment-config/maxDuration.md +42 -0
  385. package/skills/frontend/nextjs/assets/api-reference/file-conventions/route-segment-config/preferredRegion.md +55 -0
  386. package/skills/frontend/nextjs/assets/api-reference/file-conventions/route-segment-config/prefetch.md +113 -0
  387. package/skills/frontend/nextjs/assets/api-reference/file-conventions/route-segment-config/runtime.md +43 -0
  388. package/skills/frontend/nextjs/assets/api-reference/file-conventions/route.md +772 -0
  389. package/skills/frontend/nextjs/assets/api-reference/file-conventions/src-folder.md +42 -0
  390. package/skills/frontend/nextjs/assets/api-reference/file-conventions/template.md +174 -0
  391. package/skills/frontend/nextjs/assets/api-reference/file-conventions/unauthorized.md +143 -0
  392. package/skills/frontend/nextjs/assets/api-reference/functions/after.md +332 -0
  393. package/skills/frontend/nextjs/assets/api-reference/functions/cacheLife.md +642 -0
  394. package/skills/frontend/nextjs/assets/api-reference/functions/cacheTag.md +272 -0
  395. package/skills/frontend/nextjs/assets/api-reference/functions/catchError.md +267 -0
  396. package/skills/frontend/nextjs/assets/api-reference/functions/connection.md +114 -0
  397. package/skills/frontend/nextjs/assets/api-reference/functions/cookies.md +349 -0
  398. package/skills/frontend/nextjs/assets/api-reference/functions/draft-mode.md +173 -0
  399. package/skills/frontend/nextjs/assets/api-reference/functions/fetch.md +141 -0
  400. package/skills/frontend/nextjs/assets/api-reference/functions/forbidden.md +327 -0
  401. package/skills/frontend/nextjs/assets/api-reference/functions/generate-image-metadata.md +311 -0
  402. package/skills/frontend/nextjs/assets/api-reference/functions/generate-metadata.md +1510 -0
  403. package/skills/frontend/nextjs/assets/api-reference/functions/generate-sitemaps.md +102 -0
  404. package/skills/frontend/nextjs/assets/api-reference/functions/generate-static-params.md +606 -0
  405. package/skills/frontend/nextjs/assets/api-reference/functions/generate-viewport.md +347 -0
  406. package/skills/frontend/nextjs/assets/api-reference/functions/headers.md +92 -0
  407. package/skills/frontend/nextjs/assets/api-reference/functions/image-response.md +225 -0
  408. package/skills/frontend/nextjs/assets/api-reference/functions/io.md +131 -0
  409. package/skills/frontend/nextjs/assets/api-reference/functions/navigation.md +220 -0
  410. package/skills/frontend/nextjs/assets/api-reference/functions/next-request.md +116 -0
  411. package/skills/frontend/nextjs/assets/api-reference/functions/next-response.md +219 -0
  412. package/skills/frontend/nextjs/assets/api-reference/functions/next-root-params.md +479 -0
  413. package/skills/frontend/nextjs/assets/api-reference/functions/not-found.md +269 -0
  414. package/skills/frontend/nextjs/assets/api-reference/functions/permanentRedirect.md +92 -0
  415. package/skills/frontend/nextjs/assets/api-reference/functions/prefetch.md +202 -0
  416. package/skills/frontend/nextjs/assets/api-reference/functions/redirect.md +255 -0
  417. package/skills/frontend/nextjs/assets/api-reference/functions/refresh.md +91 -0
  418. package/skills/frontend/nextjs/assets/api-reference/functions/revalidatePath.md +248 -0
  419. package/skills/frontend/nextjs/assets/api-reference/functions/revalidateTag.md +175 -0
  420. package/skills/frontend/nextjs/assets/api-reference/functions/unauthorized.md +389 -0
  421. package/skills/frontend/nextjs/assets/api-reference/functions/unstable_cache.md +131 -0
  422. package/skills/frontend/nextjs/assets/api-reference/functions/unstable_noStore.md +61 -0
  423. package/skills/frontend/nextjs/assets/api-reference/functions/unstable_rethrow.md +79 -0
  424. package/skills/frontend/nextjs/assets/api-reference/functions/updateTag.md +173 -0
  425. package/skills/frontend/nextjs/assets/api-reference/functions/use-link-status.md +268 -0
  426. package/skills/frontend/nextjs/assets/api-reference/functions/use-offline.md +222 -0
  427. package/skills/frontend/nextjs/assets/api-reference/functions/use-params.md +102 -0
  428. package/skills/frontend/nextjs/assets/api-reference/functions/use-pathname.md +189 -0
  429. package/skills/frontend/nextjs/assets/api-reference/functions/use-report-web-vitals.md +175 -0
  430. package/skills/frontend/nextjs/assets/api-reference/functions/use-router.md +214 -0
  431. package/skills/frontend/nextjs/assets/api-reference/functions/use-search-params.md +416 -0
  432. package/skills/frontend/nextjs/assets/api-reference/functions/use-selected-layout-segment.md +214 -0
  433. package/skills/frontend/nextjs/assets/api-reference/functions/use-selected-layout-segments.md +116 -0
  434. package/skills/frontend/nextjs/assets/api-reference/functions/use-server-inserted-html.md +145 -0
  435. package/skills/frontend/nextjs/assets/api-reference/functions/userAgent.md +95 -0
  436. package/skills/frontend/nextjs/assets/api-reference/turbopack.md +552 -0
  437. package/skills/frontend/nextjs/assets/architecture/accessibility.md +47 -0
  438. package/skills/frontend/nextjs/assets/architecture/fast-refresh.md +122 -0
  439. package/skills/frontend/nextjs/assets/architecture/nextjs-compiler.md +376 -0
  440. package/skills/frontend/nextjs/assets/architecture/supported-browsers.md +146 -0
  441. package/skills/frontend/nextjs/assets/community/contribution-guide.md +459 -0
  442. package/skills/frontend/nextjs/assets/community/rspack.md +25 -0
  443. package/skills/frontend/nextjs/assets/getting-started/caching.md +626 -0
  444. package/skills/frontend/nextjs/assets/getting-started/css.md +336 -0
  445. package/skills/frontend/nextjs/assets/getting-started/deploying.md +115 -0
  446. package/skills/frontend/nextjs/assets/getting-started/error-handling.md +485 -0
  447. package/skills/frontend/nextjs/assets/getting-started/fetching-data.md +743 -0
  448. package/skills/frontend/nextjs/assets/getting-started/fonts.md +232 -0
  449. package/skills/frontend/nextjs/assets/getting-started/images.md +272 -0
  450. package/skills/frontend/nextjs/assets/getting-started/installation.md +446 -0
  451. package/skills/frontend/nextjs/assets/getting-started/layouts-and-pages.md +386 -0
  452. package/skills/frontend/nextjs/assets/getting-started/linking-and-navigating.md +475 -0
  453. package/skills/frontend/nextjs/assets/getting-started/metadata-and-og-images.md +370 -0
  454. package/skills/frontend/nextjs/assets/getting-started/mutating-data.md +679 -0
  455. package/skills/frontend/nextjs/assets/getting-started/project-structure.md +290 -0
  456. package/skills/frontend/nextjs/assets/getting-started/proxy.md +107 -0
  457. package/skills/frontend/nextjs/assets/getting-started/revalidating.md +241 -0
  458. package/skills/frontend/nextjs/assets/getting-started/route-handlers.md +233 -0
  459. package/skills/frontend/nextjs/assets/getting-started/server-and-client-components.md +683 -0
  460. package/skills/frontend/nextjs/assets/getting-started/upgrading.md +137 -0
  461. package/skills/frontend/nextjs/assets/glossary.md +315 -0
  462. package/skills/frontend/nextjs/evals/nextjsVerification.json +14 -0
  463. package/skills/frontend/nextjs/references/apiReference.md +3 -0
  464. package/skills/frontend/nextjs/references/dataAccessLayer.md +39 -0
  465. package/skills/frontend/nextjs/references/nextjsFeatureMap.md +276 -0
  466. package/skills/frontend/nextjs/references/productionChecklist.md +49 -0
  467. package/skills/frontend/nextjs/references/securityHeadersCsp.md +44 -0
  468. package/skills/frontend/nextjs/scripts/auditProductionReadiness.py +85 -0
  469. package/skills/frontend/shadcn-ui/SKILL.md +102 -0
  470. package/skills/frontend/shadcn-ui/assets/README.md +82 -0
  471. package/skills/frontend/shadcn-ui/assets/advanced/javascript.md +44 -0
  472. package/skills/frontend/shadcn-ui/assets/advanced/monorepo.md +254 -0
  473. package/skills/frontend/shadcn-ui/assets/advanced/react-19.md +166 -0
  474. package/skills/frontend/shadcn-ui/assets/advanced/tailwind-v4.md +333 -0
  475. package/skills/frontend/shadcn-ui/assets/ai-elements/chain-of-thought.md +519 -0
  476. package/skills/frontend/shadcn-ui/assets/ai-elements/chat.md +581 -0
  477. package/skills/frontend/shadcn-ui/assets/ai-elements/checkpoint.md +243 -0
  478. package/skills/frontend/shadcn-ui/assets/ai-elements/confirmation.md +382 -0
  479. package/skills/frontend/shadcn-ui/assets/ai-elements/context.md +188 -0
  480. package/skills/frontend/shadcn-ui/assets/ai-elements/file-tree.md +248 -0
  481. package/skills/frontend/shadcn-ui/assets/ai-elements/index.md +307 -0
  482. package/skills/frontend/shadcn-ui/assets/ai-elements/inline-citation.md +219 -0
  483. package/skills/frontend/shadcn-ui/assets/ai-elements/message.md +298 -0
  484. package/skills/frontend/shadcn-ui/assets/ai-elements/model-selector.md +368 -0
  485. package/skills/frontend/shadcn-ui/assets/ai-elements/plan.md +398 -0
  486. package/skills/frontend/shadcn-ui/assets/ai-elements/prompt-input.md +403 -0
  487. package/skills/frontend/shadcn-ui/assets/ai-elements/queue.md +517 -0
  488. package/skills/frontend/shadcn-ui/assets/ai-elements/reasoning.md +349 -0
  489. package/skills/frontend/shadcn-ui/assets/ai-elements/sources.md +303 -0
  490. package/skills/frontend/shadcn-ui/assets/ai-elements/stack-trace.md +514 -0
  491. package/skills/frontend/shadcn-ui/assets/ai-elements/subagent.md +551 -0
  492. package/skills/frontend/shadcn-ui/assets/ai-elements/suggestion.md +246 -0
  493. package/skills/frontend/shadcn-ui/assets/ai-elements/task.md +380 -0
  494. package/skills/frontend/shadcn-ui/assets/ai-elements/terminal.md +463 -0
  495. package/skills/frontend/shadcn-ui/assets/ai-elements/test-results.md +641 -0
  496. package/skills/frontend/shadcn-ui/assets/ai-elements/tool.md +915 -0
  497. package/skills/frontend/shadcn-ui/assets/components/accordion.md +490 -0
  498. package/skills/frontend/shadcn-ui/assets/components/alert-dialog.md +520 -0
  499. package/skills/frontend/shadcn-ui/assets/components/alert.md +351 -0
  500. package/skills/frontend/shadcn-ui/assets/components/aspect-ratio.md +206 -0
  501. package/skills/frontend/shadcn-ui/assets/components/attachment.md +715 -0
  502. package/skills/frontend/shadcn-ui/assets/components/avatar.md +581 -0
  503. package/skills/frontend/shadcn-ui/assets/components/badge.md +276 -0
  504. package/skills/frontend/shadcn-ui/assets/components/breadcrumb.md +556 -0
  505. package/skills/frontend/shadcn-ui/assets/components/bubble.md +706 -0
  506. package/skills/frontend/shadcn-ui/assets/components/button-group.md +969 -0
  507. package/skills/frontend/shadcn-ui/assets/components/button.md +523 -0
  508. package/skills/frontend/shadcn-ui/assets/components/calendar.md +959 -0
  509. package/skills/frontend/shadcn-ui/assets/components/card.md +684 -0
  510. package/skills/frontend/shadcn-ui/assets/components/carousel.md +643 -0
  511. package/skills/frontend/shadcn-ui/assets/components/chart.md +1295 -0
  512. package/skills/frontend/shadcn-ui/assets/components/checkbox.md +553 -0
  513. package/skills/frontend/shadcn-ui/assets/components/code-block.md +2041 -0
  514. package/skills/frontend/shadcn-ui/assets/components/collapsible.md +504 -0
  515. package/skills/frontend/shadcn-ui/assets/components/combobox.md +1102 -0
  516. package/skills/frontend/shadcn-ui/assets/components/command.md +682 -0
  517. package/skills/frontend/shadcn-ui/assets/components/context-menu.md +949 -0
  518. package/skills/frontend/shadcn-ui/assets/components/data-table.md +1667 -0
  519. package/skills/frontend/shadcn-ui/assets/components/date-picker.md +698 -0
  520. package/skills/frontend/shadcn-ui/assets/components/dialog.md +454 -0
  521. package/skills/frontend/shadcn-ui/assets/components/direction.md +205 -0
  522. package/skills/frontend/shadcn-ui/assets/components/drawer.md +806 -0
  523. package/skills/frontend/shadcn-ui/assets/components/dropdown-menu.md +1315 -0
  524. package/skills/frontend/shadcn-ui/assets/components/empty.md +562 -0
  525. package/skills/frontend/shadcn-ui/assets/components/field.md +1321 -0
  526. package/skills/frontend/shadcn-ui/assets/components/hover-card.md +342 -0
  527. package/skills/frontend/shadcn-ui/assets/components/index.md +82 -0
  528. package/skills/frontend/shadcn-ui/assets/components/input-group.md +980 -0
  529. package/skills/frontend/shadcn-ui/assets/components/input-otp.md +551 -0
  530. package/skills/frontend/shadcn-ui/assets/components/input.md +555 -0
  531. package/skills/frontend/shadcn-ui/assets/components/item.md +937 -0
  532. package/skills/frontend/shadcn-ui/assets/components/kbd.md +290 -0
  533. package/skills/frontend/shadcn-ui/assets/components/label.md +327 -0
  534. package/skills/frontend/shadcn-ui/assets/components/marker.md +445 -0
  535. package/skills/frontend/shadcn-ui/assets/components/menubar.md +804 -0
  536. package/skills/frontend/shadcn-ui/assets/components/message-scroller.md +2770 -0
  537. package/skills/frontend/shadcn-ui/assets/components/message.md +618 -0
  538. package/skills/frontend/shadcn-ui/assets/components/native-select.md +321 -0
  539. package/skills/frontend/shadcn-ui/assets/components/navigation-menu.md +568 -0
  540. package/skills/frontend/shadcn-ui/assets/components/pagination.md +425 -0
  541. package/skills/frontend/shadcn-ui/assets/components/popover.md +402 -0
  542. package/skills/frontend/shadcn-ui/assets/components/progress.md +240 -0
  543. package/skills/frontend/shadcn-ui/assets/components/questionnaire.md +2055 -0
  544. package/skills/frontend/shadcn-ui/assets/components/radio-group.md +440 -0
  545. package/skills/frontend/shadcn-ui/assets/components/resizable.md +302 -0
  546. package/skills/frontend/shadcn-ui/assets/components/scroll-area.md +226 -0
  547. package/skills/frontend/shadcn-ui/assets/components/select.md +647 -0
  548. package/skills/frontend/shadcn-ui/assets/components/separator.md +235 -0
  549. package/skills/frontend/shadcn-ui/assets/components/sheet.md +354 -0
  550. package/skills/frontend/shadcn-ui/assets/components/sidebar.md +1156 -0
  551. package/skills/frontend/shadcn-ui/assets/components/skeleton.md +217 -0
  552. package/skills/frontend/shadcn-ui/assets/components/slider.md +253 -0
  553. package/skills/frontend/shadcn-ui/assets/components/spinner.md +352 -0
  554. package/skills/frontend/shadcn-ui/assets/components/switch.md +296 -0
  555. package/skills/frontend/shadcn-ui/assets/components/table.md +572 -0
  556. package/skills/frontend/shadcn-ui/assets/components/tabs.md +425 -0
  557. package/skills/frontend/shadcn-ui/assets/components/textarea.md +218 -0
  558. package/skills/frontend/shadcn-ui/assets/components/toast.md +260 -0
  559. package/skills/frontend/shadcn-ui/assets/components/toggle-group.md +419 -0
  560. package/skills/frontend/shadcn-ui/assets/components/toggle.md +220 -0
  561. package/skills/frontend/shadcn-ui/assets/components/tooltip.md +332 -0
  562. package/skills/frontend/shadcn-ui/assets/components/trace.md +1890 -0
  563. package/skills/frontend/shadcn-ui/assets/components/typography.md +561 -0
  564. package/skills/frontend/shadcn-ui/assets/dark-mode/next.md +108 -0
  565. package/skills/frontend/shadcn-ui/assets/dark-mode/overview.md +75 -0
  566. package/skills/frontend/shadcn-ui/assets/dark-mode/vite.md +144 -0
  567. package/skills/frontend/shadcn-ui/assets/forms/next.md +716 -0
  568. package/skills/frontend/shadcn-ui/assets/forms/overview.md +60 -0
  569. package/skills/frontend/shadcn-ui/assets/forms/react-hook-form.md +2055 -0
  570. package/skills/frontend/shadcn-ui/assets/forms/tanstack-form.md +2236 -0
  571. package/skills/frontend/shadcn-ui/assets/installation/astro.md +252 -0
  572. package/skills/frontend/shadcn-ui/assets/installation/manual.md +255 -0
  573. package/skills/frontend/shadcn-ui/assets/installation/next.md +256 -0
  574. package/skills/frontend/shadcn-ui/assets/installation/react-router.md +226 -0
  575. package/skills/frontend/shadcn-ui/assets/installation/remix.md +52 -0
  576. package/skills/frontend/shadcn-ui/assets/installation/vite.md +314 -0
  577. package/skills/frontend/shadcn-ui/assets/mcp/mcp.md +338 -0
  578. package/skills/frontend/shadcn-ui/assets/overview/changelog.md +6 -0
  579. package/skills/frontend/shadcn-ui/assets/overview/cli.md +738 -0
  580. package/skills/frontend/shadcn-ui/assets/overview/components-json.md +379 -0
  581. package/skills/frontend/shadcn-ui/assets/overview/directory.md +74 -0
  582. package/skills/frontend/shadcn-ui/assets/overview/introduction.md +77 -0
  583. package/skills/frontend/shadcn-ui/assets/overview/skills.md +71 -0
  584. package/skills/frontend/shadcn-ui/assets/overview/theming.md +304 -0
  585. package/skills/frontend/shadcn-ui/assets/overview/typeset.md +242 -0
  586. package/skills/frontend/shadcn-ui/assets/registry/getting-started.md +648 -0
  587. package/skills/frontend/shadcn-ui/assets/registry/overview.md +90 -0
  588. package/skills/frontend/shadcn-ui/assets/registry/registry-item-json.md +483 -0
  589. package/skills/frontend/shadcn-ui/assets/registry/registry-json.md +178 -0
  590. package/skills/frontend/shadcn-ui/evals/componentVerification.json +19 -0
  591. package/skills/frontend/shadcn-ui/references/aiComponentsCatalog.md +51 -0
  592. package/skills/frontend/shadcn-ui/references/apiReference.md +3 -0
  593. package/skills/frontend/shadcn-ui/references/blocksCatalog.md +32 -0
  594. package/skills/frontend/shadcn-ui/references/cliCommands.md +47 -0
  595. package/skills/frontend/shadcn-ui/references/componentMarkdownSources.md +48 -0
  596. package/skills/frontend/shadcn-ui/scripts/fetchComponentDocs.py +43 -0
  597. package/skills/frontend/tsxReactStandard/SKILL.md +150 -0
  598. package/skills/frontend/tsxReactStandard/evals/tsxVerification.json +14 -0
  599. package/skills/frontend/tsxReactStandard/references/apiReference.md +3 -0
  600. package/skills/frontend/tsxReactStandard/references/discriminatedUnions.md +31 -0
  601. package/skills/frontend/tsxReactStandard/references/tsconfigStrict.md +36 -0
  602. package/skills/frontend/tsxReactStandard/scripts/validateTsxTypes.py +44 -0
  603. package/skills/gitVersionControl/gitWorkflow/SKILL.md +128 -0
  604. package/skills/gitVersionControl/gitWorkflow/assets/README.md +23 -0
  605. package/skills/gitVersionControl/gitWorkflow/assets/cli/gh-environment.md +87 -0
  606. package/skills/gitVersionControl/gitWorkflow/assets/cli/gh-formatting.md +156 -0
  607. package/skills/gitVersionControl/gitWorkflow/assets/cli/gh-reference.md +2363 -0
  608. package/skills/gitVersionControl/gitWorkflow/assets/using-git/about-git.md +156 -0
  609. package/skills/gitVersionControl/gitWorkflow/assets/using-git/about-remote-repositories.md +65 -0
  610. package/skills/gitVersionControl/gitWorkflow/assets/using-git/associating-text-editors-with-git.md +93 -0
  611. package/skills/gitVersionControl/gitWorkflow/assets/using-git/caching-your-github-credentials.md +115 -0
  612. package/skills/gitVersionControl/gitWorkflow/assets/using-git/getting-changes-from-a-remote-repository.md +76 -0
  613. package/skills/gitVersionControl/gitWorkflow/assets/using-git/ignoring-files.md +51 -0
  614. package/skills/gitVersionControl/gitWorkflow/assets/using-git/managing-remote-repositories.md +231 -0
  615. package/skills/gitVersionControl/gitWorkflow/assets/using-git/pushing-commits-to-a-remote-repository.md +119 -0
  616. package/skills/gitVersionControl/gitWorkflow/evals/evalGitWorkflow.py +43 -0
  617. package/skills/gitVersionControl/gitWorkflow/references/apiReference.md +3 -0
  618. package/skills/gitVersionControl/gitWorkflow/references/branchingModels.md +32 -0
  619. package/skills/gitVersionControl/gitWorkflow/scripts/diagnoseGitGraph.py +68 -0
  620. package/skills/github/assets/README.md +39 -0
  621. package/skills/github/assets/cli/gh-environment.md +87 -0
  622. package/skills/github/assets/cli/gh-formatting.md +156 -0
  623. package/skills/github/assets/cli/gh-reference.md +2363 -0
  624. package/skills/github/assets/docs-api/github-docs-api.md +60 -0
  625. package/skills/github/assets/rest-api/actions-secrets.md +1272 -0
  626. package/skills/github/assets/rest-api/actions-variables.md +1247 -0
  627. package/skills/github/assets/rest-api/actions-workflow-runs.md +1697 -0
  628. package/skills/github/assets/rest-api/actions-workflows.md +348 -0
  629. package/skills/github/assets/rest-api/authenticating.md +174 -0
  630. package/skills/github/assets/rest-api/branches.md +727 -0
  631. package/skills/github/assets/rest-api/checks-runs.md +1013 -0
  632. package/skills/github/assets/rest-api/checks-suites.md +1142 -0
  633. package/skills/github/assets/rest-api/code-scanning.md +2957 -0
  634. package/skills/github/assets/rest-api/collaborators.md +547 -0
  635. package/skills/github/assets/rest-api/commits.md +957 -0
  636. package/skills/github/assets/rest-api/dependabot-alerts.md +895 -0
  637. package/skills/github/assets/rest-api/orgs.md +1172 -0
  638. package/skills/github/assets/rest-api/overview.md +875 -0
  639. package/skills/github/assets/rest-api/pull-reviews.md +722 -0
  640. package/skills/github/assets/rest-api/pulls.md +1605 -0
  641. package/skills/github/assets/rest-api/quickstart.md +344 -0
  642. package/skills/github/assets/rest-api/releases.md +650 -0
  643. package/skills/github/assets/rest-api/repos.md +2957 -0
  644. package/skills/github/assets/rest-api/rules.md +1507 -0
  645. package/skills/github/assets/rest-api/secret-scanning.md +947 -0
  646. package/skills/github/assets/rest-api/teams.md +1690 -0
  647. package/skills/github/githubAction/SKILL.md +159 -0
  648. package/skills/github/githubAction/assets/README.md +38 -0
  649. package/skills/github/githubAction/assets/reference/contexts.md +918 -0
  650. package/skills/github/githubAction/assets/reference/dependency-caching.md +393 -0
  651. package/skills/github/githubAction/assets/reference/events-that-trigger-workflows.md +1348 -0
  652. package/skills/github/githubAction/assets/reference/expressions.md +441 -0
  653. package/skills/github/githubAction/assets/reference/metadata-syntax.md +803 -0
  654. package/skills/github/githubAction/assets/reference/variables.md +149 -0
  655. package/skills/github/githubAction/assets/reference/workflow-cancellation.md +22 -0
  656. package/skills/github/githubAction/assets/reference/workflow-commands.md +1056 -0
  657. package/skills/github/githubAction/assets/reference/workflow-syntax.md +1721 -0
  658. package/skills/github/githubAction/assets/rest-api/secrets.md +1272 -0
  659. package/skills/github/githubAction/assets/rest-api/workflow-runs.md +1697 -0
  660. package/skills/github/githubAction/assets/rest-api/workflows.md +348 -0
  661. package/skills/github/githubAction/assets/starter-workflows/automation/stale.yml +27 -0
  662. package/skills/github/githubAction/assets/starter-workflows/ci/blank.yml +36 -0
  663. package/skills/github/githubAction/assets/starter-workflows/ci/docker-image.yml +18 -0
  664. package/skills/github/githubAction/assets/starter-workflows/ci/go.yml +28 -0
  665. package/skills/github/githubAction/assets/starter-workflows/ci/maven.yml +35 -0
  666. package/skills/github/githubAction/assets/starter-workflows/ci/node.js.yml +31 -0
  667. package/skills/github/githubAction/assets/starter-workflows/ci/python-app.yml +39 -0
  668. package/skills/github/githubAction/assets/starter-workflows/ci/rust.yml +22 -0
  669. package/skills/github/githubAction/assets/starter-workflows/code-scanning/codeql.yml +97 -0
  670. package/skills/github/githubAction/evals/actionVerification.json +14 -0
  671. package/skills/github/githubAction/references/apiReference.md +3 -0
  672. package/skills/github/githubAction/references/workflowPatterns.md +81 -0
  673. package/skills/github/githubAction/scripts/validateWorkflowYaml.py +53 -0
  674. package/skills/github/githubQuality/SKILL.md +136 -0
  675. package/skills/github/githubQuality/assets/README.md +24 -0
  676. package/skills/github/githubQuality/assets/pull-requests/about-code-owners.md +178 -0
  677. package/skills/github/githubQuality/assets/pull-requests/about-merge-methods.md +48 -0
  678. package/skills/github/githubQuality/assets/pull-requests/creating-a-pull-request.md +170 -0
  679. package/skills/github/githubQuality/assets/pull-requests/giving-reviews.md +48 -0
  680. package/skills/github/githubQuality/assets/pull-requests/managing-a-merge-queue.md +134 -0
  681. package/skills/github/githubQuality/assets/pull-requests/merging-a-pull-request.md +101 -0
  682. package/skills/github/githubQuality/assets/pull-requests/resolving-reviews.md +59 -0
  683. package/skills/github/githubQuality/assets/pull-requests/status-checks.md +135 -0
  684. package/skills/github/githubQuality/assets/rest-api/checks-runs.md +1013 -0
  685. package/skills/github/githubQuality/assets/rest-api/checks-suites.md +1142 -0
  686. package/skills/github/githubQuality/assets/rest-api/commits.md +957 -0
  687. package/skills/github/githubQuality/assets/rest-api/pulls.md +1605 -0
  688. package/skills/github/githubQuality/assets/rest-api/reviews.md +722 -0
  689. package/skills/github/githubQuality/evals/qualityVerification.json +14 -0
  690. package/skills/github/githubQuality/references/apiReference.md +3 -0
  691. package/skills/github/githubQuality/references/codeownersExample.md +26 -0
  692. package/skills/github/githubQuality/references/prTemplate.md +20 -0
  693. package/skills/github/githubQuality/scripts/auditPrQuality.py +52 -0
  694. package/skills/github/githubSecurity/SKILL.md +170 -0
  695. package/skills/github/githubSecurity/assets/README.md +32 -0
  696. package/skills/github/githubSecurity/assets/code-scanning/code-scanning-alerts.md +133 -0
  697. package/skills/github/githubSecurity/assets/code-scanning/code-scanning.md +67 -0
  698. package/skills/github/githubSecurity/assets/code-scanning/codeql-code-scanning.md +79 -0
  699. package/skills/github/githubSecurity/assets/code-scanning/configure-code-scanning.md +121 -0
  700. package/skills/github/githubSecurity/assets/dependabot/about-the-dependabot-yml-file.md +74 -0
  701. package/skills/github/githubSecurity/assets/dependabot/dependabot-alerts.md +133 -0
  702. package/skills/github/githubSecurity/assets/dependabot/dependabot-security-updates.md +95 -0
  703. package/skills/github/githubSecurity/assets/dependabot/dependabot-version-updates.md +80 -0
  704. package/skills/github/githubSecurity/assets/rest-api/code-scanning.md +2957 -0
  705. package/skills/github/githubSecurity/assets/rest-api/dependabot-alerts.md +895 -0
  706. package/skills/github/githubSecurity/assets/rest-api/secret-scanning.md +947 -0
  707. package/skills/github/githubSecurity/assets/secret-scanning/enable-secret-scanning.md +59 -0
  708. package/skills/github/githubSecurity/assets/secret-scanning/secret-scanning.md +105 -0
  709. package/skills/github/githubSecurity/assets/security-advisories/github-advisory-database.md +148 -0
  710. package/skills/github/githubSecurity/evals/securityVerification.json +14 -0
  711. package/skills/github/githubSecurity/references/apiReference.md +3 -0
  712. package/skills/github/githubSecurity/references/codeqlAnalysis.yml +42 -0
  713. package/skills/github/githubSecurity/references/dependabotConfig.yml +27 -0
  714. package/skills/github/githubSecurity/scripts/auditRepoSecurity.py +47 -0
  715. package/skills/github/githubSetup/SKILL.md +137 -0
  716. package/skills/github/githubSetup/assets/README.md +40 -0
  717. package/skills/github/githubSetup/assets/branches/about-protected-branches.md +198 -0
  718. package/skills/github/githubSetup/assets/branches/changing-the-default-branch.md +49 -0
  719. package/skills/github/githubSetup/assets/branches/deleting-and-restoring-branches.md +44 -0
  720. package/skills/github/githubSetup/assets/branches/managing-a-branch-protection-rule.md +115 -0
  721. package/skills/github/githubSetup/assets/branches/renaming-a-branch.md +74 -0
  722. package/skills/github/githubSetup/assets/branches/viewing-branches-in-your-repository.md +30 -0
  723. package/skills/github/githubSetup/assets/repositories/about-repositories.md +127 -0
  724. package/skills/github/githubSetup/assets/repositories/cloning-a-repository.md +114 -0
  725. package/skills/github/githubSetup/assets/repositories/creating-a-new-repository.md +82 -0
  726. package/skills/github/githubSetup/assets/repositories/creating-a-repository-from-a-template.md +51 -0
  727. package/skills/github/githubSetup/assets/repositories/deleting-a-repository.md +34 -0
  728. package/skills/github/githubSetup/assets/repositories/managing-teams-and-people-with-access.md +69 -0
  729. package/skills/github/githubSetup/assets/repositories/renaming-a-repository.md +47 -0
  730. package/skills/github/githubSetup/assets/repositories/restoring-a-deleted-repository.md +61 -0
  731. package/skills/github/githubSetup/assets/repositories/setting-repository-visibility.md +137 -0
  732. package/skills/github/githubSetup/assets/rest-api/branches.md +727 -0
  733. package/skills/github/githubSetup/assets/rest-api/quickstart.md +344 -0
  734. package/skills/github/githubSetup/assets/rest-api/repos.md +2957 -0
  735. package/skills/github/githubSetup/assets/rulesets/about-rulesets.md +72 -0
  736. package/skills/github/githubSetup/assets/rulesets/available-rules-for-rulesets.md +383 -0
  737. package/skills/github/githubSetup/assets/rulesets/converting-branch-protections-to-rulesets.md +92 -0
  738. package/skills/github/githubSetup/assets/rulesets/creating-rulesets-for-a-repository.md +108 -0
  739. package/skills/github/githubSetup/assets/rulesets/managing-rulesets-for-a-repository.md +149 -0
  740. package/skills/github/githubSetup/assets/rulesets/troubleshooting-rules.md +122 -0
  741. package/skills/github/githubSetup/evals/setupVerification.json +14 -0
  742. package/skills/github/githubSetup/references/apiReference.md +3 -0
  743. package/skills/github/githubSetup/references/repoSettingsBlueprint.md +13 -0
  744. package/skills/github/githubSetup/references/rulesetTemplates.json +42 -0
  745. package/skills/github/githubSetup/scripts/configureRepoBaseline.py +46 -0
  746. package/skills/github/githubTeam/SKILL.md +115 -0
  747. package/skills/github/githubTeam/assets/README.md +21 -0
  748. package/skills/github/githubTeam/assets/organizations/about-organizations.md +69 -0
  749. package/skills/github/githubTeam/assets/organizations/repository-roles-for-an-organization.md +94 -0
  750. package/skills/github/githubTeam/assets/rest-api/collaborators.md +547 -0
  751. package/skills/github/githubTeam/assets/rest-api/orgs.md +1172 -0
  752. package/skills/github/githubTeam/assets/rest-api/teams.md +1690 -0
  753. package/skills/github/githubTeam/assets/teams/about-teams.md +82 -0
  754. package/skills/github/githubTeam/assets/teams/adding-members-to-a-team.md +55 -0
  755. package/skills/github/githubTeam/evals/teamVerification.json +14 -0
  756. package/skills/github/githubTeam/references/apiReference.md +3 -0
  757. package/skills/github/githubTeam/references/permissionMatrix.md +17 -0
  758. package/skills/github/githubTeam/references/reviewAssignment.md +17 -0
  759. package/skills/github/githubTeam/scripts/manageTeamSync.py +31 -0
  760. package/skills/securityQa/llmSecurityRedteaming/SKILL.md +86 -0
  761. package/skills/securityQa/llmSecurityRedteaming/evals/securityRedteamVerification.json +14 -0
  762. package/skills/securityQa/llmSecurityRedteaming/references/apiReference.md +3 -0
  763. package/skills/securityQa/llmSecurityRedteaming/references/jailbreakTaxonomy.md +6 -0
  764. package/skills/securityQa/llmSecurityRedteaming/references/owaspLlmTopTen.md +12 -0
  765. package/skills/securityQa/llmSecurityRedteaming/scripts/testPromptInjection.py +34 -0
  766. package/skills/softwareDevelopment/requirementsEngineering/SKILL.md +110 -0
  767. package/skills/softwareDevelopment/requirementsEngineering/evals/evalRequirements.py +33 -0
  768. package/skills/softwareDevelopment/requirementsEngineering/references/apiReference.md +3 -0
  769. package/skills/softwareDevelopment/requirementsEngineering/references/requirementsAnalysisModels.md +34 -0
  770. package/skills/softwareDevelopment/requirementsEngineering/scripts/validateUserStories.py +49 -0
  771. package/skills/testing/testDrivenDevelopment/SKILL.md +122 -0
  772. package/skills/testing/testDrivenDevelopment/evals/evalTdd.py +25 -0
  773. package/skills/testing/testDrivenDevelopment/references/apiReference.md +3 -0
  774. package/skills/testing/testDrivenDevelopment/references/testPyramidDoubles.md +35 -0
  775. package/skills/testing/testDrivenDevelopment/scripts/auditTestPyramid.py +58 -0
@@ -0,0 +1,1697 @@
1
+ # REST API endpoints for workflow runs
2
+
3
+ Use the REST API to interact with workflow runs in GitHub Actions.
4
+
5
+ ## About workflow runs in GitHub Actions
6
+
7
+ You can use the REST API to view, re-run, cancel, and view logs for workflow runs in GitHub Actions. A workflow run is an instance of your workflow that runs when the pre-configured event occurs. For more information, see [Managing workflow runs](/en/actions/how-tos/manage-workflow-runs).
8
+
9
+ > [!NOTE]
10
+ > Most endpoints use `Authorization: Bearer <YOUR-TOKEN>` and `Accept: application/vnd.github+json` headers, plus `X-GitHub-Api-Version: 2026-03-10`. Curl examples below omit these standard headers for brevity.
11
+
12
+ ## Re-run a job from a workflow run
13
+
14
+ ```
15
+ POST /repos/{owner}/{repo}/actions/jobs/{job_id}/rerun
16
+ ```
17
+
18
+ Re-run a job and its dependent jobs in a workflow run.
19
+ OAuth app tokens and personal access tokens (classic) need the repo scope to use this endpoint.
20
+
21
+ ### Parameters
22
+
23
+ #### Headers
24
+
25
+ * **`accept`** (string)
26
+ Setting to `application/vnd.github+json` is recommended.
27
+
28
+ #### Path and query parameters
29
+
30
+ * **`owner`** (string) (required)
31
+ The account owner of the repository. The name is not case sensitive.
32
+
33
+ * **`repo`** (string) (required)
34
+ The name of the repository without the .git extension. The name is not case sensitive.
35
+
36
+ * **`job_id`** (integer) (required)
37
+ The unique identifier of the job.
38
+
39
+ #### Body parameters
40
+
41
+ * **`enable_debug_logging`** (boolean)
42
+ Whether to enable debug logging for the re-run.
43
+ Default: `false`
44
+
45
+ * **`enable_debugger`** (boolean)
46
+ Whether to enable the debugger for the re-run of this job.
47
+ Default: `false`
48
+
49
+ ### HTTP response status codes
50
+
51
+ * **201** - Created
52
+
53
+ * **403** - Forbidden
54
+
55
+ ### Code examples
56
+
57
+ #### Example
58
+
59
+ **Request:**
60
+
61
+ ```curl
62
+ curl -L \
63
+ -X POST \
64
+ https://api.github.com/repos/OWNER/REPO/actions/jobs/JOB_ID/rerun
65
+ ```
66
+
67
+ **Response schema (Status: 201):**
68
+
69
+ ## List workflow runs for a repository
70
+
71
+ ```
72
+ GET /repos/{owner}/{repo}/actions/runs
73
+ ```
74
+
75
+ Lists all workflow runs for a repository. You can use parameters to narrow the list of results. For more information about using parameters, see Parameters.
76
+ Anyone with read access to the repository can use this endpoint.
77
+ OAuth app tokens and personal access tokens (classic) need the repo scope to use this endpoint with a private repository.
78
+ This endpoint will return up to 1,000 results for each search when using the following parameters: actor, branch, check\_suite\_id, created, event, head\_sha, status.
79
+
80
+ ### Parameters
81
+
82
+ #### Headers
83
+
84
+ * **`accept`** (string)
85
+ Setting to `application/vnd.github+json` is recommended.
86
+
87
+ #### Path and query parameters
88
+
89
+ * **`owner`** (string) (required)
90
+ The account owner of the repository. The name is not case sensitive.
91
+
92
+ * **`repo`** (string) (required)
93
+ The name of the repository without the .git extension. The name is not case sensitive.
94
+
95
+ * **`actor`** (string)
96
+ Returns someone's workflow runs. Use the login for the user who created the push associated with the check suite or workflow run.
97
+
98
+ * **`branch`** (string)
99
+ Returns workflow runs associated with a branch. Use the name of the branch of the push.
100
+
101
+ * **`event`** (string)
102
+ Returns workflow run triggered by the event you specify. For example, push, pull\_request or issue. For more information, see "Events that trigger workflows."
103
+
104
+ * **`status`** (string)
105
+ Returns workflow runs with the check run status or conclusion that you specify. For example, a conclusion can be success or a status can be in\_progress. Only GitHub Actions can set a status of waiting, pending, or requested.
106
+ Can be one of: `completed`, `action_required`, `cancelled`, `failure`, `neutral`, `skipped`, `stale`, `success`, `timed_out`, `in_progress`, `queued`, `requested`, `waiting`, `pending`
107
+
108
+ * **`per_page`** (integer)
109
+ The number of results per page (max 100). For more information, see "Using pagination in the REST API."
110
+ Default: `30`
111
+
112
+ * **`page`** (integer)
113
+ The page number of the results to fetch. For more information, see "Using pagination in the REST API."
114
+ Default: `1`
115
+
116
+ * **`created`** (string)
117
+ Returns workflow runs created within the given date-time range. For more information on the syntax, see "Understanding the search syntax."
118
+
119
+ * **`exclude_pull_requests`** (boolean)
120
+ If true pull requests are omitted from the response (empty array).
121
+ Default: `false`
122
+
123
+ * **`check_suite_id`** (integer)
124
+ Returns workflow runs with the check\_suite\_id that you specify.
125
+
126
+ * **`head_sha`** (string)
127
+ Only returns workflow runs that are associated with the specified head\_sha.
128
+
129
+ ### HTTP response status codes
130
+
131
+ * **200** - OK
132
+
133
+ * **304** - Not modified
134
+
135
+ ### Code examples
136
+
137
+ #### Example
138
+
139
+ **Request:**
140
+
141
+ ```curl
142
+ curl -L \
143
+ -X GET \
144
+ https://api.github.com/repos/OWNER/REPO/actions/runs
145
+ ```
146
+
147
+ **Response schema (Status: 200):**
148
+
149
+ * `total_count`: required, integer
150
+ * `workflow_runs`: required, array of `Workflow Run`:
151
+ * `id`: required, integer, format: int64
152
+ * `name`: string or null
153
+ * `node_id`: required, string
154
+ * `check_suite_id`: integer, format: int64
155
+ * `check_suite_node_id`: string
156
+ * `head_branch`: required, string or null
157
+ * `head_sha`: required, string
158
+ * `path`: required, string
159
+ * `run_number`: required, integer
160
+ * `run_attempt`: integer
161
+ * `referenced_workflows`: array of `Referenced workflow` or null:
162
+ * `path`: required, string
163
+ * `sha`: required, string
164
+ * `ref`: string
165
+ * `event`: required, string
166
+ * `status`: required, string or null
167
+ * `conclusion`: required, string or null
168
+ * `workflow_id`: required, integer
169
+ * `url`: required, string
170
+ * `html_url`: required, string
171
+ * `pull_requests`: required, array of `Pull Request Minimal` or null:
172
+ * `id`: required, integer, format: int64
173
+ * `number`: required, integer
174
+ * `url`: required, string
175
+ * `head`: required, object:
176
+ * `ref`: required, string
177
+ * `sha`: required, string
178
+ * `repo`: required, object:
179
+ * `id`: required, integer, format: int64
180
+ * `url`: required, string
181
+ * `name`: required, string
182
+ * `base`: required, object:
183
+ * `ref`: required, string
184
+ * `sha`: required, string
185
+ * `repo`: required, object:
186
+ * `id`: required, integer, format: int64
187
+ * `url`: required, string
188
+ * `name`: required, string
189
+ * `created_at`: required, string, format: date-time
190
+ * `updated_at`: required, string, format: date-time
191
+ * `actor`: `Simple User`:
192
+ * `name`: string or null
193
+ * `email`: string or null
194
+ * `login`: required, string
195
+ * `id`: required, integer, format: int64
196
+ * `node_id`: required, string
197
+ * `avatar_url`: required, string, format: uri
198
+ * `gravatar_id`: required, string or null
199
+ * `url`: required, string, format: uri
200
+ * `html_url`: required, string, format: uri
201
+ * `followers_url`: required, string, format: uri
202
+ * `following_url`: required, string
203
+ * `gists_url`: required, string
204
+ * `starred_url`: required, string
205
+ * `subscriptions_url`: required, string, format: uri
206
+ * `organizations_url`: required, string, format: uri
207
+ * `repos_url`: required, string, format: uri
208
+ * `events_url`: required, string
209
+ * `received_events_url`: required, string, format: uri
210
+ * `type`: required, string
211
+ * `site_admin`: required, boolean
212
+ * `starred_at`: string
213
+ * `user_view_type`: string
214
+ * `triggering_actor`: `Simple User` (see above)
215
+ * `run_started_at`: string, format: date-time
216
+ * `jobs_url`: required, string
217
+ * `logs_url`: required, string
218
+ * `check_suite_url`: required, string
219
+ * `artifacts_url`: required, string
220
+ * `cancel_url`: required, string
221
+ * `rerun_url`: required, string
222
+ * `previous_attempt_url`: string or null
223
+ * `workflow_url`: required, string
224
+ * `head_commit`: required, any of:
225
+ * **null**
226
+ * **Simple Commit**
227
+ * `id`: required, string
228
+ * `tree_id`: required, string
229
+ * `message`: required, string
230
+ * `timestamp`: required, string, format: date-time
231
+ * `author`: required, object or null:
232
+ * `name`: required, string
233
+ * `email`: required, string, format: email
234
+ * `committer`: required, object or null:
235
+ * `name`: required, string
236
+ * `email`: required, string, format: email
237
+ * `repository`: required, `Minimal Repository`:
238
+ * `id`: required, integer, format: int64
239
+ * `node_id`: required, string
240
+ * `name`: required, string
241
+ * `full_name`: required, string
242
+ * `owner`: required, `Simple User` (see above)
243
+ * `private`: required, boolean
244
+ * `html_url`: required, string, format: uri
245
+ * `description`: required, string or null
246
+ * `fork`: required, boolean
247
+ * `url`: required, string, format: uri
248
+ * `archive_url`: required, string
249
+ * `assignees_url`: required, string
250
+ * `blobs_url`: required, string
251
+ * `branches_url`: required, string
252
+ * `collaborators_url`: required, string
253
+ * `comments_url`: required, string
254
+ * `commits_url`: required, string
255
+ * `compare_url`: required, string
256
+ * `contents_url`: required, string
257
+ * `contributors_url`: required, string, format: uri
258
+ * `deployments_url`: required, string, format: uri
259
+ * `downloads_url`: required, string, format: uri
260
+ * `events_url`: required, string, format: uri
261
+ * `forks_url`: required, string, format: uri
262
+ * `git_commits_url`: required, string
263
+ * `git_refs_url`: required, string
264
+ * `git_tags_url`: required, string
265
+ * `git_url`: string
266
+ * `issue_comment_url`: required, string
267
+ * `issue_events_url`: required, string
268
+ * `issues_url`: required, string
269
+ * `keys_url`: required, string
270
+ * `labels_url`: required, string
271
+ * `languages_url`: required, string, format: uri
272
+ * `merges_url`: required, string, format: uri
273
+ * `milestones_url`: required, string
274
+ * `notifications_url`: required, string
275
+ * `pulls_url`: required, string
276
+ * `releases_url`: required, string
277
+ * `ssh_url`: string
278
+ * `stargazers_url`: required, string, format: uri
279
+ * `statuses_url`: required, string
280
+ * `subscribers_url`: required, string, format: uri
281
+ * `subscription_url`: required, string, format: uri
282
+ * `tags_url`: required, string, format: uri
283
+ * `teams_url`: required, string, format: uri
284
+ * `trees_url`: required, string
285
+ * `clone_url`: string
286
+ * `mirror_url`: string or null
287
+ * `hooks_url`: required, string, format: uri
288
+ * `svn_url`: string
289
+ * `homepage`: string or null
290
+ * `language`: string or null
291
+ * `forks_count`: integer
292
+ * `stargazers_count`: integer
293
+ * `watchers_count`: integer
294
+ * `size`: integer
295
+ * `default_branch`: string
296
+ * `open_issues_count`: integer
297
+ * `is_template`: boolean
298
+ * `topics`: array of string
299
+ * `has_issues`: boolean
300
+ * `has_projects`: boolean
301
+ * `has_wiki`: boolean
302
+ * `has_pages`: boolean
303
+ * `has_discussions`: boolean
304
+ * `has_pull_requests`: boolean
305
+ * `pull_request_creation_policy`: string, enum: `all`, `collaborators_only`
306
+ * `archived`: boolean
307
+ * `disabled`: boolean
308
+ * `visibility`: string
309
+ * `pushed_at`: string or null, format: date-time
310
+ * `created_at`: string or null, format: date-time
311
+ * `updated_at`: string or null, format: date-time
312
+ * `permissions`: object:
313
+ * `admin`: boolean
314
+ * `maintain`: boolean
315
+ * `push`: boolean
316
+ * `triage`: boolean
317
+ * `pull`: boolean
318
+ * `role_name`: string
319
+ * `temp_clone_token`: string
320
+ * `delete_branch_on_merge`: boolean
321
+ * `subscribers_count`: integer
322
+ * `network_count`: integer
323
+ * `code_of_conduct`: `Code Of Conduct`:
324
+ * `key`: required, string
325
+ * `name`: required, string
326
+ * `url`: required, string, format: uri
327
+ * `body`: string
328
+ * `html_url`: required, string or null, format: uri
329
+ * `license`: object or null:
330
+ * `key`: string
331
+ * `name`: string
332
+ * `spdx_id`: string
333
+ * `url`: string or null
334
+ * `node_id`: string
335
+ * `forks`: integer
336
+ * `open_issues`: integer
337
+ * `watchers`: integer
338
+ * `allow_forking`: boolean
339
+ * `web_commit_signoff_required`: boolean
340
+ * `security_and_analysis`: object or null:
341
+ * `advanced_security`: object:
342
+ * `status`: string, enum: `enabled`, `disabled`
343
+ * `code_security`: object:
344
+ * `status`: string, enum: `enabled`, `disabled`
345
+ * `dependabot_security_updates`: object:
346
+ * `status`: string, enum: `enabled`, `disabled`
347
+ * `secret_scanning`: object:
348
+ * `status`: string, enum: `enabled`, `disabled`
349
+ * `secret_scanning_push_protection`: object:
350
+ * `status`: string, enum: `enabled`, `disabled`
351
+ * `secret_scanning_non_provider_patterns`: object:
352
+ * `status`: string, enum: `enabled`, `disabled`
353
+ * `secret_scanning_ai_detection`: object:
354
+ * `status`: string, enum: `enabled`, `disabled`
355
+ * `secret_scanning_delegated_alert_dismissal`: object:
356
+ * `status`: string, enum: `enabled`, `disabled`
357
+ * `secret_scanning_delegated_bypass`: object:
358
+ * `status`: string, enum: `enabled`, `disabled`
359
+ * `secret_scanning_delegated_bypass_options`: object:
360
+ * `reviewers`: array of object
361
+ * `custom_properties`: object, additional properties allowed
362
+ * `head_repository`: required, `Minimal Repository` (see above)
363
+ * `head_repository_id`: integer
364
+ * `display_title`: required, string
365
+
366
+ ## Get a workflow run
367
+
368
+ ```
369
+ GET /repos/{owner}/{repo}/actions/runs/{run_id}
370
+ ```
371
+
372
+ Gets a specific workflow run.
373
+ Anyone with read access to the repository can use this endpoint.
374
+ OAuth app tokens and personal access tokens (classic) need the repo scope to use this endpoint with a private repository.
375
+
376
+ ### Parameters
377
+
378
+ #### Headers
379
+
380
+ * **`accept`** (string)
381
+ Setting to `application/vnd.github+json` is recommended.
382
+
383
+ #### Path and query parameters
384
+
385
+ * **`owner`** (string) (required)
386
+ The account owner of the repository. The name is not case sensitive.
387
+
388
+ * **`repo`** (string) (required)
389
+ The name of the repository without the .git extension. The name is not case sensitive.
390
+
391
+ * **`run_id`** (integer) (required)
392
+ The unique identifier of the workflow run.
393
+
394
+ * **`exclude_pull_requests`** (boolean)
395
+ If true pull requests are omitted from the response (empty array).
396
+ Default: `false`
397
+
398
+ ### HTTP response status codes
399
+
400
+ * **200** - OK
401
+
402
+ ### Code examples
403
+
404
+ #### Example
405
+
406
+ **Request:**
407
+
408
+ ```curl
409
+ curl -L \
410
+ -X GET \
411
+ https://api.github.com/repos/OWNER/REPO/actions/runs/RUN_ID
412
+ ```
413
+
414
+ **Response schema (Status: 200):**
415
+
416
+ * `id`: required, integer, format: int64
417
+ * `name`: string or null
418
+ * `node_id`: required, string
419
+ * `check_suite_id`: integer, format: int64
420
+ * `check_suite_node_id`: string
421
+ * `head_branch`: required, string or null
422
+ * `head_sha`: required, string
423
+ * `path`: required, string
424
+ * `run_number`: required, integer
425
+ * `run_attempt`: integer
426
+ * `referenced_workflows`: array of `Referenced workflow` or null:
427
+ * `path`: required, string
428
+ * `sha`: required, string
429
+ * `ref`: string
430
+ * `event`: required, string
431
+ * `status`: required, string or null
432
+ * `conclusion`: required, string or null
433
+ * `workflow_id`: required, integer
434
+ * `url`: required, string
435
+ * `html_url`: required, string
436
+ * `pull_requests`: required, array of `Pull Request Minimal` or null:
437
+ * `id`: required, integer, format: int64
438
+ * `number`: required, integer
439
+ * `url`: required, string
440
+ * `head`: required, object:
441
+ * `ref`: required, string
442
+ * `sha`: required, string
443
+ * `repo`: required, object:
444
+ * `id`: required, integer, format: int64
445
+ * `url`: required, string
446
+ * `name`: required, string
447
+ * `base`: required, object:
448
+ * `ref`: required, string
449
+ * `sha`: required, string
450
+ * `repo`: required, object:
451
+ * `id`: required, integer, format: int64
452
+ * `url`: required, string
453
+ * `name`: required, string
454
+ * `created_at`: required, string, format: date-time
455
+ * `updated_at`: required, string, format: date-time
456
+ * `actor`: `Simple User`:
457
+ * `name`: string or null
458
+ * `email`: string or null
459
+ * `login`: required, string
460
+ * `id`: required, integer, format: int64
461
+ * `node_id`: required, string
462
+ * `avatar_url`: required, string, format: uri
463
+ * `gravatar_id`: required, string or null
464
+ * `url`: required, string, format: uri
465
+ * `html_url`: required, string, format: uri
466
+ * `followers_url`: required, string, format: uri
467
+ * `following_url`: required, string
468
+ * `gists_url`: required, string
469
+ * `starred_url`: required, string
470
+ * `subscriptions_url`: required, string, format: uri
471
+ * `organizations_url`: required, string, format: uri
472
+ * `repos_url`: required, string, format: uri
473
+ * `events_url`: required, string
474
+ * `received_events_url`: required, string, format: uri
475
+ * `type`: required, string
476
+ * `site_admin`: required, boolean
477
+ * `starred_at`: string
478
+ * `user_view_type`: string
479
+ * `triggering_actor`: `Simple User` (see above)
480
+ * `run_started_at`: string, format: date-time
481
+ * `jobs_url`: required, string
482
+ * `logs_url`: required, string
483
+ * `check_suite_url`: required, string
484
+ * `artifacts_url`: required, string
485
+ * `cancel_url`: required, string
486
+ * `rerun_url`: required, string
487
+ * `previous_attempt_url`: string or null
488
+ * `workflow_url`: required, string
489
+ * `head_commit`: required, any of:
490
+ * **null**
491
+ * **Simple Commit**
492
+ * `id`: required, string
493
+ * `tree_id`: required, string
494
+ * `message`: required, string
495
+ * `timestamp`: required, string, format: date-time
496
+ * `author`: required, object or null:
497
+ * `name`: required, string
498
+ * `email`: required, string, format: email
499
+ * `committer`: required, object or null:
500
+ * `name`: required, string
501
+ * `email`: required, string, format: email
502
+ * `repository`: required, `Minimal Repository`:
503
+ * `id`: required, integer, format: int64
504
+ * `node_id`: required, string
505
+ * `name`: required, string
506
+ * `full_name`: required, string
507
+ * `owner`: required, `Simple User` (see above)
508
+ * `private`: required, boolean
509
+ * `html_url`: required, string, format: uri
510
+ * `description`: required, string or null
511
+ * `fork`: required, boolean
512
+ * `url`: required, string, format: uri
513
+ * `archive_url`: required, string
514
+ * `assignees_url`: required, string
515
+ * `blobs_url`: required, string
516
+ * `branches_url`: required, string
517
+ * `collaborators_url`: required, string
518
+ * `comments_url`: required, string
519
+ * `commits_url`: required, string
520
+ * `compare_url`: required, string
521
+ * `contents_url`: required, string
522
+ * `contributors_url`: required, string, format: uri
523
+ * `deployments_url`: required, string, format: uri
524
+ * `downloads_url`: required, string, format: uri
525
+ * `events_url`: required, string, format: uri
526
+ * `forks_url`: required, string, format: uri
527
+ * `git_commits_url`: required, string
528
+ * `git_refs_url`: required, string
529
+ * `git_tags_url`: required, string
530
+ * `git_url`: string
531
+ * `issue_comment_url`: required, string
532
+ * `issue_events_url`: required, string
533
+ * `issues_url`: required, string
534
+ * `keys_url`: required, string
535
+ * `labels_url`: required, string
536
+ * `languages_url`: required, string, format: uri
537
+ * `merges_url`: required, string, format: uri
538
+ * `milestones_url`: required, string
539
+ * `notifications_url`: required, string
540
+ * `pulls_url`: required, string
541
+ * `releases_url`: required, string
542
+ * `ssh_url`: string
543
+ * `stargazers_url`: required, string, format: uri
544
+ * `statuses_url`: required, string
545
+ * `subscribers_url`: required, string, format: uri
546
+ * `subscription_url`: required, string, format: uri
547
+ * `tags_url`: required, string, format: uri
548
+ * `teams_url`: required, string, format: uri
549
+ * `trees_url`: required, string
550
+ * `clone_url`: string
551
+ * `mirror_url`: string or null
552
+ * `hooks_url`: required, string, format: uri
553
+ * `svn_url`: string
554
+ * `homepage`: string or null
555
+ * `language`: string or null
556
+ * `forks_count`: integer
557
+ * `stargazers_count`: integer
558
+ * `watchers_count`: integer
559
+ * `size`: integer
560
+ * `default_branch`: string
561
+ * `open_issues_count`: integer
562
+ * `is_template`: boolean
563
+ * `topics`: array of string
564
+ * `has_issues`: boolean
565
+ * `has_projects`: boolean
566
+ * `has_wiki`: boolean
567
+ * `has_pages`: boolean
568
+ * `has_discussions`: boolean
569
+ * `has_pull_requests`: boolean
570
+ * `pull_request_creation_policy`: string, enum: `all`, `collaborators_only`
571
+ * `archived`: boolean
572
+ * `disabled`: boolean
573
+ * `visibility`: string
574
+ * `pushed_at`: string or null, format: date-time
575
+ * `created_at`: string or null, format: date-time
576
+ * `updated_at`: string or null, format: date-time
577
+ * `permissions`: object:
578
+ * `admin`: boolean
579
+ * `maintain`: boolean
580
+ * `push`: boolean
581
+ * `triage`: boolean
582
+ * `pull`: boolean
583
+ * `role_name`: string
584
+ * `temp_clone_token`: string
585
+ * `delete_branch_on_merge`: boolean
586
+ * `subscribers_count`: integer
587
+ * `network_count`: integer
588
+ * `code_of_conduct`: `Code Of Conduct`:
589
+ * `key`: required, string
590
+ * `name`: required, string
591
+ * `url`: required, string, format: uri
592
+ * `body`: string
593
+ * `html_url`: required, string or null, format: uri
594
+ * `license`: object or null:
595
+ * `key`: string
596
+ * `name`: string
597
+ * `spdx_id`: string
598
+ * `url`: string or null
599
+ * `node_id`: string
600
+ * `forks`: integer
601
+ * `open_issues`: integer
602
+ * `watchers`: integer
603
+ * `allow_forking`: boolean
604
+ * `web_commit_signoff_required`: boolean
605
+ * `security_and_analysis`: object or null:
606
+ * `advanced_security`: object:
607
+ * `status`: string, enum: `enabled`, `disabled`
608
+ * `code_security`: object:
609
+ * `status`: string, enum: `enabled`, `disabled`
610
+ * `dependabot_security_updates`: object:
611
+ * `status`: string, enum: `enabled`, `disabled`
612
+ * `secret_scanning`: object:
613
+ * `status`: string, enum: `enabled`, `disabled`
614
+ * `secret_scanning_push_protection`: object:
615
+ * `status`: string, enum: `enabled`, `disabled`
616
+ * `secret_scanning_non_provider_patterns`: object:
617
+ * `status`: string, enum: `enabled`, `disabled`
618
+ * `secret_scanning_ai_detection`: object:
619
+ * `status`: string, enum: `enabled`, `disabled`
620
+ * `secret_scanning_delegated_alert_dismissal`: object:
621
+ * `status`: string, enum: `enabled`, `disabled`
622
+ * `secret_scanning_delegated_bypass`: object:
623
+ * `status`: string, enum: `enabled`, `disabled`
624
+ * `secret_scanning_delegated_bypass_options`: object:
625
+ * `reviewers`: array of objects:
626
+ * `reviewer_id`: required, integer
627
+ * `reviewer_type`: required, string, enum: `TEAM`, `ROLE`
628
+ * `mode`: string, enum: `ALWAYS`, `EXEMPT`, default: `"ALWAYS"`
629
+ * `custom_properties`: object, additional properties allowed
630
+ * `head_repository`: required, `Minimal Repository` (see above)
631
+ * `head_repository_id`: integer
632
+ * `display_title`: required, string
633
+
634
+ ## Delete a workflow run
635
+
636
+ ```
637
+ DELETE /repos/{owner}/{repo}/actions/runs/{run_id}
638
+ ```
639
+
640
+ Deletes a specific workflow run.
641
+ Anyone with write access to the repository can use this endpoint.
642
+ If the repository is private, OAuth tokens and personal access tokens (classic) need the repo scope to use this endpoint.
643
+
644
+ ### Parameters
645
+
646
+ #### Headers
647
+
648
+ * **`accept`** (string)
649
+ Setting to `application/vnd.github+json` is recommended.
650
+
651
+ #### Path and query parameters
652
+
653
+ * **`owner`** (string) (required)
654
+ The account owner of the repository. The name is not case sensitive.
655
+
656
+ * **`repo`** (string) (required)
657
+ The name of the repository without the .git extension. The name is not case sensitive.
658
+
659
+ * **`run_id`** (integer) (required)
660
+ The unique identifier of the workflow run.
661
+
662
+ ### HTTP response status codes
663
+
664
+ * **204** - No Content
665
+
666
+ ### Code examples
667
+
668
+ #### Example
669
+
670
+ **Request:**
671
+
672
+ ```curl
673
+ curl -L \
674
+ -X DELETE \
675
+ https://api.github.com/repos/OWNER/REPO/actions/runs/RUN_ID
676
+ ```
677
+
678
+ **Response schema (Status: 204):**
679
+
680
+ ## Get the review history for a workflow run
681
+
682
+ ```
683
+ GET /repos/{owner}/{repo}/actions/runs/{run_id}/approvals
684
+ ```
685
+
686
+ Anyone with read access to the repository can use this endpoint.
687
+ OAuth app tokens and personal access tokens (classic) need the repo scope to use this endpoint with a private repository.
688
+
689
+ ### Parameters
690
+
691
+ #### Headers
692
+
693
+ * **`accept`** (string)
694
+ Setting to `application/vnd.github+json` is recommended.
695
+
696
+ #### Path and query parameters
697
+
698
+ * **`owner`** (string) (required)
699
+ The account owner of the repository. The name is not case sensitive.
700
+
701
+ * **`repo`** (string) (required)
702
+ The name of the repository without the .git extension. The name is not case sensitive.
703
+
704
+ * **`run_id`** (integer) (required)
705
+ The unique identifier of the workflow run.
706
+
707
+ ### HTTP response status codes
708
+
709
+ * **200** - OK
710
+
711
+ ### Code examples
712
+
713
+ #### Example
714
+
715
+ **Request:**
716
+
717
+ ```curl
718
+ curl -L \
719
+ -X GET \
720
+ https://api.github.com/repos/OWNER/REPO/actions/runs/RUN_ID/approvals
721
+ ```
722
+
723
+ **Response schema (Status: 200):**
724
+
725
+ Array of `Environment Approval`:
726
+
727
+ * `environments`: required, array of objects:
728
+ * `id`: integer
729
+ * `node_id`: string
730
+ * `name`: string
731
+ * `url`: string
732
+ * `html_url`: string
733
+ * `created_at`: string, format: date-time
734
+ * `updated_at`: string, format: date-time
735
+ * `state`: required, string, enum: `approved`, `rejected`, `pending`
736
+ * `user`: required, `Simple User`:
737
+ * `name`: string or null
738
+ * `email`: string or null
739
+ * `login`: required, string
740
+ * `id`: required, integer, format: int64
741
+ * `node_id`: required, string
742
+ * `avatar_url`: required, string, format: uri
743
+ * `gravatar_id`: required, string or null
744
+ * `url`: required, string, format: uri
745
+ * `html_url`: required, string, format: uri
746
+ * `followers_url`: required, string, format: uri
747
+ * `following_url`: required, string
748
+ * `gists_url`: required, string
749
+ * `starred_url`: required, string
750
+ * `subscriptions_url`: required, string, format: uri
751
+ * `organizations_url`: required, string, format: uri
752
+ * `repos_url`: required, string, format: uri
753
+ * `events_url`: required, string
754
+ * `received_events_url`: required, string, format: uri
755
+ * `type`: required, string
756
+ * `site_admin`: required, boolean
757
+ * `starred_at`: string
758
+ * `user_view_type`: string
759
+ * `comment`: required, string
760
+
761
+ ## Approve a workflow run for a fork pull request
762
+
763
+ ```
764
+ POST /repos/{owner}/{repo}/actions/runs/{run_id}/approve
765
+ ```
766
+
767
+ Approves a workflow run for a pull request from a public fork of a first time contributor. For more information, see "Approving workflow runs from public forks."
768
+ OAuth tokens and personal access tokens (classic) need the repo scope to use this endpoint.
769
+
770
+ ### Parameters
771
+
772
+ #### Headers
773
+
774
+ * **`accept`** (string)
775
+ Setting to `application/vnd.github+json` is recommended.
776
+
777
+ #### Path and query parameters
778
+
779
+ * **`owner`** (string) (required)
780
+ The account owner of the repository. The name is not case sensitive.
781
+
782
+ * **`repo`** (string) (required)
783
+ The name of the repository without the .git extension. The name is not case sensitive.
784
+
785
+ * **`run_id`** (integer) (required)
786
+ The unique identifier of the workflow run.
787
+
788
+ ### HTTP response status codes
789
+
790
+ * **201** - Created
791
+
792
+ * **403** - Forbidden
793
+
794
+ * **404** - Resource not found
795
+
796
+ ### Code examples
797
+
798
+ #### Example
799
+
800
+ **Request:**
801
+
802
+ ```curl
803
+ curl -L \
804
+ -X POST \
805
+ https://api.github.com/repos/OWNER/REPO/actions/runs/RUN_ID/approve
806
+ ```
807
+
808
+ **Response schema (Status: 201):**
809
+
810
+ ## Get a workflow run attempt
811
+
812
+ ```
813
+ GET /repos/{owner}/{repo}/actions/runs/{run_id}/attempts/{attempt_number}
814
+ ```
815
+
816
+ Gets a specific workflow run attempt.
817
+ Anyone with read access to the repository can use this endpoint.
818
+ OAuth app tokens and personal access tokens (classic) need the repo scope to use this endpoint with a private repository.
819
+
820
+ ### Parameters
821
+
822
+ #### Headers
823
+
824
+ * **`accept`** (string)
825
+ Setting to `application/vnd.github+json` is recommended.
826
+
827
+ #### Path and query parameters
828
+
829
+ * **`owner`** (string) (required)
830
+ The account owner of the repository. The name is not case sensitive.
831
+
832
+ * **`repo`** (string) (required)
833
+ The name of the repository without the .git extension. The name is not case sensitive.
834
+
835
+ * **`run_id`** (integer) (required)
836
+ The unique identifier of the workflow run.
837
+
838
+ * **`attempt_number`** (integer) (required)
839
+ The attempt number of the workflow run.
840
+
841
+ * **`exclude_pull_requests`** (boolean)
842
+ If true pull requests are omitted from the response (empty array).
843
+ Default: `false`
844
+
845
+ ### HTTP response status codes
846
+
847
+ * **200** - OK
848
+
849
+ ### Code examples
850
+
851
+ #### Example
852
+
853
+ **Request:**
854
+
855
+ ```curl
856
+ curl -L \
857
+ -X GET \
858
+ https://api.github.com/repos/OWNER/REPO/actions/runs/RUN_ID/attempts/ATTEMPT_NUMBER
859
+ ```
860
+
861
+ **Response schema (Status: 200):**
862
+
863
+ Same response schema as [Get a workflow run](#get-a-workflow-run).
864
+
865
+ ## Download workflow run attempt logs
866
+
867
+ ```
868
+ GET /repos/{owner}/{repo}/actions/runs/{run_id}/attempts/{attempt_number}/logs
869
+ ```
870
+
871
+ Gets a redirect URL to download an archive of log files for a specific workflow run attempt. This link expires after
872
+ 1 minute. Look for Location: in the response header to find the URL for the download.
873
+ Anyone with read access to the repository can use this endpoint.
874
+ If the repository is private, OAuth tokens and personal access tokens (classic) need the repo scope to use this endpoint.
875
+
876
+ ### Parameters
877
+
878
+ #### Headers
879
+
880
+ * **`accept`** (string)
881
+ Setting to `application/vnd.github+json` is recommended.
882
+
883
+ #### Path and query parameters
884
+
885
+ * **`owner`** (string) (required)
886
+ The account owner of the repository. The name is not case sensitive.
887
+
888
+ * **`repo`** (string) (required)
889
+ The name of the repository without the .git extension. The name is not case sensitive.
890
+
891
+ * **`run_id`** (integer) (required)
892
+ The unique identifier of the workflow run.
893
+
894
+ * **`attempt_number`** (integer) (required)
895
+ The attempt number of the workflow run.
896
+
897
+ ### HTTP response status codes
898
+
899
+ * **302** - Found
900
+
901
+ ### Code examples
902
+
903
+ #### Example
904
+
905
+ **Request:**
906
+
907
+ ```curl
908
+ curl -L \
909
+ -X GET \
910
+ https://api.github.com/repos/OWNER/REPO/actions/runs/RUN_ID/attempts/ATTEMPT_NUMBER/logs
911
+ ```
912
+
913
+ **Response schema (Status: 302):**
914
+
915
+ ## Cancel a workflow run
916
+
917
+ ```
918
+ POST /repos/{owner}/{repo}/actions/runs/{run_id}/cancel
919
+ ```
920
+
921
+ Cancels a workflow run using its id.
922
+ OAuth tokens and personal access tokens (classic) need the repo scope to use this endpoint.
923
+
924
+ ### Parameters
925
+
926
+ #### Headers
927
+
928
+ * **`accept`** (string)
929
+ Setting to `application/vnd.github+json` is recommended.
930
+
931
+ #### Path and query parameters
932
+
933
+ * **`owner`** (string) (required)
934
+ The account owner of the repository. The name is not case sensitive.
935
+
936
+ * **`repo`** (string) (required)
937
+ The name of the repository without the .git extension. The name is not case sensitive.
938
+
939
+ * **`run_id`** (integer) (required)
940
+ The unique identifier of the workflow run.
941
+
942
+ ### HTTP response status codes
943
+
944
+ * **202** - Accepted
945
+
946
+ * **409** - Conflict
947
+
948
+ ### Code examples
949
+
950
+ #### Example
951
+
952
+ **Request:**
953
+
954
+ ```curl
955
+ curl -L \
956
+ -X POST \
957
+ https://api.github.com/repos/OWNER/REPO/actions/runs/RUN_ID/cancel
958
+ ```
959
+
960
+ **Response schema (Status: 202):**
961
+
962
+ ## Review custom deployment protection rules for a workflow run
963
+
964
+ ```
965
+ POST /repos/{owner}/{repo}/actions/runs/{run_id}/deployment_protection_rule
966
+ ```
967
+
968
+ Approve or reject custom deployment protection rules provided by a GitHub App for a workflow run. For more information, see "Using environments for deployment."
969
+ Note
970
+
971
+ GitHub Apps can only review their own custom deployment protection rules. To approve or reject pending deployments that are waiting for review from a specific person or team, see POST /repos/{owner}/{repo}/actions/runs/{run\_id}/pending\_deployments.
972
+
973
+ OAuth app tokens and personal access tokens (classic) need the repo scope to use this endpoint with a private repository.
974
+
975
+ ### Parameters
976
+
977
+ #### Headers
978
+
979
+ * **`accept`** (string)
980
+ Setting to `application/vnd.github+json` is recommended.
981
+
982
+ #### Path and query parameters
983
+
984
+ * **`owner`** (string) (required)
985
+ The account owner of the repository. The name is not case sensitive.
986
+
987
+ * **`repo`** (string) (required)
988
+ The name of the repository without the .git extension. The name is not case sensitive.
989
+
990
+ * **`run_id`** (integer) (required)
991
+ The unique identifier of the workflow run.
992
+
993
+ #### Body parameters
994
+
995
+ * **`environment_name`** (string) (required)
996
+ The name of the environment to approve or reject.
997
+
998
+ * **`comment`** (string)
999
+ Comment associated with the pending deployment protection rule. Required when state is not provided.
1000
+
1001
+ * **`state`** (string)
1002
+ Whether to approve or reject deployment to the specified environments.
1003
+ Can be one of: `approved`, `rejected`
1004
+
1005
+ ### HTTP response status codes
1006
+
1007
+ * **204** - No Content
1008
+
1009
+ ### Code examples
1010
+
1011
+ #### Example
1012
+
1013
+ **Request:**
1014
+
1015
+ ```curl
1016
+ curl -L \
1017
+ -X POST \
1018
+ https://api.github.com/repos/OWNER/REPO/actions/runs/RUN_ID/deployment_protection_rule \
1019
+ -d '{
1020
+ "environment_name": "prod-eus",
1021
+ "state": "approved",
1022
+ "comment": "All health checks passed."
1023
+ }'
1024
+ ```
1025
+
1026
+ **Response schema (Status: 204):**
1027
+
1028
+ ## Force cancel a workflow run
1029
+
1030
+ ```
1031
+ POST /repos/{owner}/{repo}/actions/runs/{run_id}/force-cancel
1032
+ ```
1033
+
1034
+ Cancels a workflow run and bypasses conditions that would otherwise cause a workflow execution to continue, such as an always() condition on a job.
1035
+ You should only use this endpoint to cancel a workflow run when the workflow run is not responding to POST /repos/{owner}/{repo}/actions/runs/{run\_id}/cancel.
1036
+ OAuth tokens and personal access tokens (classic) need the repo scope to use this endpoint.
1037
+
1038
+ ### Parameters
1039
+
1040
+ #### Headers
1041
+
1042
+ * **`accept`** (string)
1043
+ Setting to `application/vnd.github+json` is recommended.
1044
+
1045
+ #### Path and query parameters
1046
+
1047
+ * **`owner`** (string) (required)
1048
+ The account owner of the repository. The name is not case sensitive.
1049
+
1050
+ * **`repo`** (string) (required)
1051
+ The name of the repository without the .git extension. The name is not case sensitive.
1052
+
1053
+ * **`run_id`** (integer) (required)
1054
+ The unique identifier of the workflow run.
1055
+
1056
+ ### HTTP response status codes
1057
+
1058
+ * **202** - Accepted
1059
+
1060
+ * **409** - Conflict
1061
+
1062
+ ### Code examples
1063
+
1064
+ #### Example
1065
+
1066
+ **Request:**
1067
+
1068
+ ```curl
1069
+ curl -L \
1070
+ -X POST \
1071
+ https://api.github.com/repos/OWNER/REPO/actions/runs/RUN_ID/force-cancel
1072
+ ```
1073
+
1074
+ **Response schema (Status: 202):**
1075
+
1076
+ ## Download workflow run logs
1077
+
1078
+ ```
1079
+ GET /repos/{owner}/{repo}/actions/runs/{run_id}/logs
1080
+ ```
1081
+
1082
+ Gets a redirect URL to download an archive of log files for a workflow run. This link expires after 1 minute. Look for
1083
+ Location: in the response header to find the URL for the download.
1084
+ Anyone with read access to the repository can use this endpoint.
1085
+ If the repository is private, OAuth tokens and personal access tokens (classic) need the repo scope to use this endpoint.
1086
+
1087
+ ### Parameters
1088
+
1089
+ #### Headers
1090
+
1091
+ * **`accept`** (string)
1092
+ Setting to `application/vnd.github+json` is recommended.
1093
+
1094
+ #### Path and query parameters
1095
+
1096
+ * **`owner`** (string) (required)
1097
+ The account owner of the repository. The name is not case sensitive.
1098
+
1099
+ * **`repo`** (string) (required)
1100
+ The name of the repository without the .git extension. The name is not case sensitive.
1101
+
1102
+ * **`run_id`** (integer) (required)
1103
+ The unique identifier of the workflow run.
1104
+
1105
+ ### HTTP response status codes
1106
+
1107
+ * **302** - Found
1108
+
1109
+ ### Code examples
1110
+
1111
+ #### Example
1112
+
1113
+ **Request:**
1114
+
1115
+ ```curl
1116
+ curl -L \
1117
+ -X GET \
1118
+ https://api.github.com/repos/OWNER/REPO/actions/runs/RUN_ID/logs
1119
+ ```
1120
+
1121
+ **Response schema (Status: 302):**
1122
+
1123
+ ## Delete workflow run logs
1124
+
1125
+ ```
1126
+ DELETE /repos/{owner}/{repo}/actions/runs/{run_id}/logs
1127
+ ```
1128
+
1129
+ Deletes all logs for a workflow run.
1130
+ OAuth tokens and personal access tokens (classic) need the repo scope to use this endpoint.
1131
+
1132
+ ### Parameters
1133
+
1134
+ #### Headers
1135
+
1136
+ * **`accept`** (string)
1137
+ Setting to `application/vnd.github+json` is recommended.
1138
+
1139
+ #### Path and query parameters
1140
+
1141
+ * **`owner`** (string) (required)
1142
+ The account owner of the repository. The name is not case sensitive.
1143
+
1144
+ * **`repo`** (string) (required)
1145
+ The name of the repository without the .git extension. The name is not case sensitive.
1146
+
1147
+ * **`run_id`** (integer) (required)
1148
+ The unique identifier of the workflow run.
1149
+
1150
+ ### HTTP response status codes
1151
+
1152
+ * **204** - No Content
1153
+
1154
+ * **403** - Forbidden
1155
+
1156
+ * **500** - Internal Error
1157
+
1158
+ ### Code examples
1159
+
1160
+ #### Example
1161
+
1162
+ **Request:**
1163
+
1164
+ ```curl
1165
+ curl -L \
1166
+ -X DELETE \
1167
+ https://api.github.com/repos/OWNER/REPO/actions/runs/RUN_ID/logs
1168
+ ```
1169
+
1170
+ **Response schema (Status: 204):**
1171
+
1172
+ ## Get pending deployments for a workflow run
1173
+
1174
+ ```
1175
+ GET /repos/{owner}/{repo}/actions/runs/{run_id}/pending_deployments
1176
+ ```
1177
+
1178
+ Get all deployment environments for a workflow run that are waiting for protection rules to pass.
1179
+ Anyone with read access to the repository can use this endpoint.
1180
+ If the repository is private, OAuth tokens and personal access tokens (classic) need the repo scope to use this endpoint.
1181
+
1182
+ ### Parameters
1183
+
1184
+ #### Headers
1185
+
1186
+ * **`accept`** (string)
1187
+ Setting to `application/vnd.github+json` is recommended.
1188
+
1189
+ #### Path and query parameters
1190
+
1191
+ * **`owner`** (string) (required)
1192
+ The account owner of the repository. The name is not case sensitive.
1193
+
1194
+ * **`repo`** (string) (required)
1195
+ The name of the repository without the .git extension. The name is not case sensitive.
1196
+
1197
+ * **`run_id`** (integer) (required)
1198
+ The unique identifier of the workflow run.
1199
+
1200
+ ### HTTP response status codes
1201
+
1202
+ * **200** - OK
1203
+
1204
+ ### Code examples
1205
+
1206
+ #### Example
1207
+
1208
+ **Request:**
1209
+
1210
+ ```curl
1211
+ curl -L \
1212
+ -X GET \
1213
+ https://api.github.com/repos/OWNER/REPO/actions/runs/RUN_ID/pending_deployments
1214
+ ```
1215
+
1216
+ **Response schema (Status: 200):**
1217
+
1218
+ Array of `Pending Deployment`:
1219
+
1220
+ * `environment`: required, object:
1221
+ * `id`: integer, format: int64
1222
+ * `node_id`: string
1223
+ * `name`: string
1224
+ * `url`: string
1225
+ * `html_url`: string
1226
+ * `wait_timer`: required, integer
1227
+ * `wait_timer_started_at`: required, string or null, format: date-time
1228
+ * `current_user_can_approve`: required, boolean
1229
+ * `reviewers`: required, array of objects:
1230
+ * `type`: string, enum: `User`, `Team`
1231
+ * `reviewer`: any of:
1232
+ * **Simple User**
1233
+ * `name`: string or null
1234
+ * `email`: string or null
1235
+ * `login`: required, string
1236
+ * `id`: required, integer, format: int64
1237
+ * `node_id`: required, string
1238
+ * `avatar_url`: required, string, format: uri
1239
+ * `gravatar_id`: required, string or null
1240
+ * `url`: required, string, format: uri
1241
+ * `html_url`: required, string, format: uri
1242
+ * `followers_url`: required, string, format: uri
1243
+ * `following_url`: required, string
1244
+ * `gists_url`: required, string
1245
+ * `starred_url`: required, string
1246
+ * `subscriptions_url`: required, string, format: uri
1247
+ * `organizations_url`: required, string, format: uri
1248
+ * `repos_url`: required, string, format: uri
1249
+ * `events_url`: required, string
1250
+ * `received_events_url`: required, string, format: uri
1251
+ * `type`: required, string
1252
+ * `site_admin`: required, boolean
1253
+ * `starred_at`: string
1254
+ * `user_view_type`: string
1255
+ * **Team**
1256
+ * `id`: required, integer
1257
+ * `node_id`: required, string
1258
+ * `name`: required, string
1259
+ * `slug`: required, string
1260
+ * `description`: required, string or null
1261
+ * `privacy`: string
1262
+ * `notification_setting`: string
1263
+ * `permission`: required, string
1264
+ * `permissions`: object:
1265
+ * `pull`: required, boolean
1266
+ * `triage`: required, boolean
1267
+ * `push`: required, boolean
1268
+ * `maintain`: required, boolean
1269
+ * `admin`: required, boolean
1270
+ * `url`: required, string, format: uri
1271
+ * `html_url`: required, string, format: uri
1272
+ * `members_url`: required, string
1273
+ * `repositories_url`: required, string, format: uri
1274
+ * `type`: required, string, enum: `enterprise`, `organization`
1275
+ * `access_source`: string, enum: `direct`, `organization`, `enterprise`
1276
+ * `organization_id`: integer
1277
+ * `enterprise_id`: integer
1278
+ * `parent`: required, any of:
1279
+ * **null**
1280
+ * **Team Simple**
1281
+ * `id`: required, integer
1282
+ * `node_id`: required, string
1283
+ * `url`: required, string, format: uri
1284
+ * `members_url`: required, string
1285
+ * `name`: required, string
1286
+ * `description`: required, string or null
1287
+ * `permission`: required, string
1288
+ * `privacy`: string
1289
+ * `notification_setting`: string
1290
+ * `html_url`: required, string, format: uri
1291
+ * `repositories_url`: required, string, format: uri
1292
+ * `slug`: required, string
1293
+ * `ldap_dn`: string
1294
+ * `type`: required, string, enum: `enterprise`, `organization`
1295
+ * `organization_id`: integer
1296
+ * `enterprise_id`: integer
1297
+
1298
+ ## Review pending deployments for a workflow run
1299
+
1300
+ ```
1301
+ POST /repos/{owner}/{repo}/actions/runs/{run_id}/pending_deployments
1302
+ ```
1303
+
1304
+ Approve or reject pending deployments that are waiting on approval by a required reviewer.
1305
+ Required reviewers with read access to the repository contents and deployments can use this endpoint.
1306
+ OAuth app tokens and personal access tokens (classic) need the repo scope to use this endpoint.
1307
+
1308
+ ### Parameters
1309
+
1310
+ #### Headers
1311
+
1312
+ * **`accept`** (string)
1313
+ Setting to `application/vnd.github+json` is recommended.
1314
+
1315
+ #### Path and query parameters
1316
+
1317
+ * **`owner`** (string) (required)
1318
+ The account owner of the repository. The name is not case sensitive.
1319
+
1320
+ * **`repo`** (string) (required)
1321
+ The name of the repository without the .git extension. The name is not case sensitive.
1322
+
1323
+ * **`run_id`** (integer) (required)
1324
+ The unique identifier of the workflow run.
1325
+
1326
+ #### Body parameters
1327
+
1328
+ * **`environment_ids`** (array of integers) (required)
1329
+ The list of environment ids to approve or reject
1330
+
1331
+ * **`state`** (string) (required)
1332
+ Whether to approve or reject deployment to the specified environments.
1333
+ Can be one of: `approved`, `rejected`
1334
+
1335
+ * **`comment`** (string) (required)
1336
+ A comment to accompany the deployment review
1337
+
1338
+ ### HTTP response status codes
1339
+
1340
+ * **200** - OK
1341
+
1342
+ ### Code examples
1343
+
1344
+ #### Example
1345
+
1346
+ **Request:**
1347
+
1348
+ ```curl
1349
+ curl -L \
1350
+ -X POST \
1351
+ https://api.github.com/repos/OWNER/REPO/actions/runs/RUN_ID/pending_deployments \
1352
+ -d '{
1353
+ "environment_ids": [
1354
+ 161171787
1355
+ ],
1356
+ "state": "approved",
1357
+ "comment": "Ship it!"
1358
+ }'
1359
+ ```
1360
+
1361
+ **Response schema (Status: 200):**
1362
+
1363
+ Array of `Deployment`:
1364
+
1365
+ * `url`: required, string, format: uri
1366
+ * `id`: required, integer, format: int64
1367
+ * `node_id`: required, string
1368
+ * `sha`: required, string
1369
+ * `ref`: required, string
1370
+ * `task`: required, string
1371
+ * `payload`: required, one of:
1372
+ * **object, additional properties allowed**
1373
+ * **string**
1374
+ * `original_environment`: string
1375
+ * `environment`: required, string
1376
+ * `description`: required, string or null
1377
+ * `creator`: required, any of:
1378
+ * **null**
1379
+ * **Simple User**
1380
+ * `name`: string or null
1381
+ * `email`: string or null
1382
+ * `login`: required, string
1383
+ * `id`: required, integer, format: int64
1384
+ * `node_id`: required, string
1385
+ * `avatar_url`: required, string, format: uri
1386
+ * `gravatar_id`: required, string or null
1387
+ * `url`: required, string, format: uri
1388
+ * `html_url`: required, string, format: uri
1389
+ * `followers_url`: required, string, format: uri
1390
+ * `following_url`: required, string
1391
+ * `gists_url`: required, string
1392
+ * `starred_url`: required, string
1393
+ * `subscriptions_url`: required, string, format: uri
1394
+ * `organizations_url`: required, string, format: uri
1395
+ * `repos_url`: required, string, format: uri
1396
+ * `events_url`: required, string
1397
+ * `received_events_url`: required, string, format: uri
1398
+ * `type`: required, string
1399
+ * `site_admin`: required, boolean
1400
+ * `starred_at`: string
1401
+ * `user_view_type`: string
1402
+ * `created_at`: required, string, format: date-time
1403
+ * `updated_at`: required, string, format: date-time
1404
+ * `statuses_url`: required, string, format: uri
1405
+ * `repository_url`: required, string, format: uri
1406
+ * `transient_environment`: boolean
1407
+ * `production_environment`: boolean
1408
+ * `performed_via_github_app`: any of:
1409
+ * **null**
1410
+ * **GitHub app**
1411
+ * `id`: required, integer
1412
+ * `slug`: string
1413
+ * `node_id`: required, string
1414
+ * `client_id`: string
1415
+ * `owner`: required, one of:
1416
+ * **Simple User** (see above)
1417
+ * **Enterprise**
1418
+ * `description`: string or null
1419
+ * `html_url`: required, string, format: uri
1420
+ * `website_url`: string or null, format: uri
1421
+ * `id`: required, integer
1422
+ * `node_id`: required, string
1423
+ * `name`: required, string
1424
+ * `slug`: required, string
1425
+ * `created_at`: required, string or null, format: date-time
1426
+ * `updated_at`: required, string or null, format: date-time
1427
+ * `avatar_url`: required, string, format: uri
1428
+ * `name`: required, string
1429
+ * `description`: required, string or null
1430
+ * `external_url`: required, string, format: uri
1431
+ * `html_url`: required, string, format: uri
1432
+ * `created_at`: required, string, format: date-time
1433
+ * `updated_at`: required, string, format: date-time
1434
+ * `permissions`: required, object, additional properties: string:
1435
+ * `issues`: string
1436
+ * `checks`: string
1437
+ * `metadata`: string
1438
+ * `contents`: string
1439
+ * `deployments`: string
1440
+ * `events`: required, array of string
1441
+ * `installations_count`: integer
1442
+
1443
+ ## Re-run a workflow
1444
+
1445
+ ```
1446
+ POST /repos/{owner}/{repo}/actions/runs/{run_id}/rerun
1447
+ ```
1448
+
1449
+ Re-runs your workflow run using its id.
1450
+ OAuth app tokens and personal access tokens (classic) need the repo scope to use this endpoint.
1451
+
1452
+ ### Parameters
1453
+
1454
+ #### Headers
1455
+
1456
+ * **`accept`** (string)
1457
+ Setting to `application/vnd.github+json` is recommended.
1458
+
1459
+ #### Path and query parameters
1460
+
1461
+ * **`owner`** (string) (required)
1462
+ The account owner of the repository. The name is not case sensitive.
1463
+
1464
+ * **`repo`** (string) (required)
1465
+ The name of the repository without the .git extension. The name is not case sensitive.
1466
+
1467
+ * **`run_id`** (integer) (required)
1468
+ The unique identifier of the workflow run.
1469
+
1470
+ #### Body parameters
1471
+
1472
+ * **`enable_debug_logging`** (boolean)
1473
+ Whether to enable debug logging for the re-run.
1474
+ Default: `false`
1475
+
1476
+ ### HTTP response status codes
1477
+
1478
+ * **201** - Created
1479
+
1480
+ ### Code examples
1481
+
1482
+ #### Example
1483
+
1484
+ **Request:**
1485
+
1486
+ ```curl
1487
+ curl -L \
1488
+ -X POST \
1489
+ https://api.github.com/repos/OWNER/REPO/actions/runs/RUN_ID/rerun
1490
+ ```
1491
+
1492
+ **Response schema (Status: 201):**
1493
+
1494
+ ## Re-run failed jobs from a workflow run
1495
+
1496
+ ```
1497
+ POST /repos/{owner}/{repo}/actions/runs/{run_id}/rerun-failed-jobs
1498
+ ```
1499
+
1500
+ Re-run all of the failed jobs and their dependent jobs in a workflow run using the id of the workflow run.
1501
+ OAuth app tokens and personal access tokens (classic) need the repo scope to use this endpoint.
1502
+
1503
+ ### Parameters
1504
+
1505
+ #### Headers
1506
+
1507
+ * **`accept`** (string)
1508
+ Setting to `application/vnd.github+json` is recommended.
1509
+
1510
+ #### Path and query parameters
1511
+
1512
+ * **`owner`** (string) (required)
1513
+ The account owner of the repository. The name is not case sensitive.
1514
+
1515
+ * **`repo`** (string) (required)
1516
+ The name of the repository without the .git extension. The name is not case sensitive.
1517
+
1518
+ * **`run_id`** (integer) (required)
1519
+ The unique identifier of the workflow run.
1520
+
1521
+ #### Body parameters
1522
+
1523
+ * **`enable_debug_logging`** (boolean)
1524
+ Whether to enable debug logging for the re-run.
1525
+ Default: `false`
1526
+
1527
+ ### HTTP response status codes
1528
+
1529
+ * **201** - Created
1530
+
1531
+ ### Code examples
1532
+
1533
+ #### Example
1534
+
1535
+ **Request:**
1536
+
1537
+ ```curl
1538
+ curl -L \
1539
+ -X POST \
1540
+ https://api.github.com/repos/OWNER/REPO/actions/runs/RUN_ID/rerun-failed-jobs
1541
+ ```
1542
+
1543
+ **Response schema (Status: 201):**
1544
+
1545
+ ## Get workflow run usage
1546
+
1547
+ ```
1548
+ GET /repos/{owner}/{repo}/actions/runs/{run_id}/timing
1549
+ ```
1550
+
1551
+ Warning
1552
+
1553
+ 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.
1554
+
1555
+ Gets the number of billable minutes and total run time for a specific workflow run. Billable minutes only apply to workflows in private repositories that use GitHub-hosted runners. Usage is listed for each GitHub-hosted runner operating system in milliseconds. Any job re-runs are also included in the usage. The usage does not include the multiplier for macOS and Windows runners and is not rounded up to the nearest whole minute. For more information, see "Managing billing for GitHub Actions".
1556
+ Anyone with read access to the repository can use this endpoint.
1557
+ OAuth app tokens and personal access tokens (classic) need the repo scope to use this endpoint with a private repository.
1558
+
1559
+ ### Parameters
1560
+
1561
+ #### Headers
1562
+
1563
+ * **`accept`** (string)
1564
+ Setting to `application/vnd.github+json` is recommended.
1565
+
1566
+ #### Path and query parameters
1567
+
1568
+ * **`owner`** (string) (required)
1569
+ The account owner of the repository. The name is not case sensitive.
1570
+
1571
+ * **`repo`** (string) (required)
1572
+ The name of the repository without the .git extension. The name is not case sensitive.
1573
+
1574
+ * **`run_id`** (integer) (required)
1575
+ The unique identifier of the workflow run.
1576
+
1577
+ ### HTTP response status codes
1578
+
1579
+ * **200** - OK
1580
+
1581
+ ### Code examples
1582
+
1583
+ #### Example
1584
+
1585
+ **Request:**
1586
+
1587
+ ```curl
1588
+ curl -L \
1589
+ -X GET \
1590
+ https://api.github.com/repos/OWNER/REPO/actions/runs/RUN_ID/timing
1591
+ ```
1592
+
1593
+ **Response schema (Status: 200):**
1594
+
1595
+ * `billable`: required, object:
1596
+ * `UBUNTU`: object:
1597
+ * `total_ms`: required, integer
1598
+ * `jobs`: required, integer
1599
+ * `job_runs`: array of objects:
1600
+ * `job_id`: required, integer
1601
+ * `duration_ms`: required, integer
1602
+ * `MACOS`: object:
1603
+ * `total_ms`: required, integer
1604
+ * `jobs`: required, integer
1605
+ * `job_runs`: array of objects:
1606
+ * `job_id`: required, integer
1607
+ * `duration_ms`: required, integer
1608
+ * `WINDOWS`: object:
1609
+ * `total_ms`: required, integer
1610
+ * `jobs`: required, integer
1611
+ * `job_runs`: array of objects:
1612
+ * `job_id`: required, integer
1613
+ * `duration_ms`: required, integer
1614
+ * `run_duration_ms`: integer
1615
+
1616
+ ## List workflow runs for a workflow
1617
+
1618
+ ```
1619
+ GET /repos/{owner}/{repo}/actions/workflows/{workflow_id}/runs
1620
+ ```
1621
+
1622
+ List all workflow runs for a workflow. You can replace workflow\_id with the workflow file name. For example, you could use main.yaml. You can use parameters to narrow the list of results. For more information about using parameters, see Parameters.
1623
+ Anyone with read access to the repository can use this endpoint
1624
+ OAuth app tokens and personal access tokens (classic) need the repo scope to use this endpoint with a private repository.
1625
+ This endpoint will return up to 1,000 results for each search when using the following parameters: actor, branch, check\_suite\_id, created, event, head\_sha, status.
1626
+
1627
+ ### Parameters
1628
+
1629
+ #### Headers
1630
+
1631
+ * **`accept`** (string)
1632
+ Setting to `application/vnd.github+json` is recommended.
1633
+
1634
+ #### Path and query parameters
1635
+
1636
+ * **`owner`** (string) (required)
1637
+ The account owner of the repository. The name is not case sensitive.
1638
+
1639
+ * **`repo`** (string) (required)
1640
+ The name of the repository without the .git extension. The name is not case sensitive.
1641
+
1642
+ * **`workflow_id`** (integer or string) (required)
1643
+ The ID of the workflow. You can also pass the workflow file name as a string.
1644
+
1645
+ * **`actor`** (string)
1646
+ Returns someone's workflow runs. Use the login for the user who created the push associated with the check suite or workflow run.
1647
+
1648
+ * **`branch`** (string)
1649
+ Returns workflow runs associated with a branch. Use the name of the branch of the push.
1650
+
1651
+ * **`event`** (string)
1652
+ Returns workflow run triggered by the event you specify. For example, push, pull\_request or issue. For more information, see "Events that trigger workflows."
1653
+
1654
+ * **`status`** (string)
1655
+ Returns workflow runs with the check run status or conclusion that you specify. For example, a conclusion can be success or a status can be in\_progress. Only GitHub Actions can set a status of waiting, pending, or requested.
1656
+ Can be one of: `completed`, `action_required`, `cancelled`, `failure`, `neutral`, `skipped`, `stale`, `success`, `timed_out`, `in_progress`, `queued`, `requested`, `waiting`, `pending`
1657
+
1658
+ * **`per_page`** (integer)
1659
+ The number of results per page (max 100). For more information, see "Using pagination in the REST API."
1660
+ Default: `30`
1661
+
1662
+ * **`page`** (integer)
1663
+ The page number of the results to fetch. For more information, see "Using pagination in the REST API."
1664
+ Default: `1`
1665
+
1666
+ * **`created`** (string)
1667
+ Returns workflow runs created within the given date-time range. For more information on the syntax, see "Understanding the search syntax."
1668
+
1669
+ * **`exclude_pull_requests`** (boolean)
1670
+ If true pull requests are omitted from the response (empty array).
1671
+ Default: `false`
1672
+
1673
+ * **`check_suite_id`** (integer)
1674
+ Returns workflow runs with the check\_suite\_id that you specify.
1675
+
1676
+ * **`head_sha`** (string)
1677
+ Only returns workflow runs that are associated with the specified head\_sha.
1678
+
1679
+ ### HTTP response status codes
1680
+
1681
+ * **200** - OK
1682
+
1683
+ ### Code examples
1684
+
1685
+ #### Example
1686
+
1687
+ **Request:**
1688
+
1689
+ ```curl
1690
+ curl -L \
1691
+ -X GET \
1692
+ https://api.github.com/repos/OWNER/REPO/actions/workflows/WORKFLOW_ID/runs
1693
+ ```
1694
+
1695
+ **Response schema (Status: 200):**
1696
+
1697
+ Same response schema as [List workflow runs for a repository](#list-workflow-runs-for-a-repository).