GET /repos/{owner}/{repo}/actions/runs: bot committer emails fail `format: "email"` validation
Nobody has claimed this yet.
Assessment
- Difficulty
- 2/5
- Estimated time
- 1-3 hours
- Newbie friendliness
- 68/100
- Issue type
- Bug
- Clarity
- Mostly clear
- Activity status
- Quiet
- Tech stack
- openapi
- Domain
- api
Research direction
Search the OpenAPI description for GET /repos/{owner}/{repo}/actions/runs and its workflow run commit author/committer email fields. Compare the schema constraints with the bot email examples in the issue, then validate that the chosen schema change accepts those values without breaking the endpoint description.
Written by the indexing model from the issue text.
Description
Description
The workflow runs endpoint (GET /repos/{owner}/{repo}/actions/runs) returns commit objects where the committer/author email field is declared with format: "email", but GitHub Actions bot commits use email addresses like:
github-actions[bot]@users.noreply.github.com
The square brackets in github-actions[bot] make this address non-compliant with RFC 5321 (which prohibits [ and ] in the local part of an email address). JSON Schema validators that strictly enforce format: "email" will reject these values.
Error observed
When calling GET /repos/{owner}/{repo}/actions/runs on a repository that has GitHub Actions bot commits, MCP servers and other tools that validate against this schema fail with:
MCP error -32602: Structured content does not match the tool's output schema:
[commit].committer.email must match format "email"
Examples of non-RFC-compliant bot emails returned by the API
github-actions[bot]@users.noreply.github.com49699333+dependabot[bot]@users.noreply.github.com
The [bot] suffix appended to the username contains square brackets, which are not permitted in the local part of an RFC 5321 email address.
Expected behavior
The schema should either:
- Relax the
format: "email"constraint on committer/author email fields in workflow run commit objects (e.g. useformat: "email"only as a hint, or remove it for these fields), or - Use a more permissive format that accommodates GitHub's internal bot email convention
Steps to reproduce
- Call
GET /repos/{owner}/{repo}/actions/runson any repo that uses GitHub Actions or Dependabot - Inspect the
head_commit.committer.emailorhead_commit.author.emailfield - Validating against the current schema's
format: "email"constraint will fail for bot-authored commits
Notes
- This affects all endpoints returning workflow run objects with commit data
- The same issue may affect other endpoints that return commit author/committer objects where bot accounts are involved
- Dominant language
- No language data
- Stars
- 1.6k
- Forks
- 342
- Avg merge
- 3h 33m
- Merged PRs (30d)
- 51
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from github/rest-api-description
-
feature
Difficulty 2/5 1-3 hours Newbie friendliness 82/100
github/rest-api-description#7201 ·
-
feature
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
github/rest-api-description#7163 ·
-
feature
Difficulty 2/5 1-3 hours Newbie friendliness 68/100
github/rest-api-description#7162 ·
-
feature
Difficulty 2/5 1-3 hours Newbie friendliness 68/100
github/rest-api-description#7135 ·
-
feature
Difficulty 2/5 1-3 hours Newbie friendliness 74/100
github/rest-api-description#7111 · 1 comment ·
All issues in github/rest-api-description
Similar issues
-
bug customer-eng Durable Agents Inngest status: needs triage
Difficulty 2/5 1-3 hours Newbie friendliness 82/100
-
bug
Difficulty 2/5 1-3 hours Newbie friendliness 85/100
-
integration: elevenlabs
Difficulty 1/5 Under an hour Newbie friendliness 88/100
home-assistant/core#182944 · 1 comment ·
-
ai-observability bug team/ai-observability
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
-
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
vicharanashala/fln#563 ·