Skip to content

docs: expand "Write Operations Fail" troubleshooting stub in common-issues.md #21519

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
pelikhan merged 2 commits into from
Mar 18, 2026
Merged

docs: expand "Write Operations Fail" troubleshooting stub in common-issues.md #21519

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
dac7b81
Initial plan
Copilot Mar 18, 2026
3c5c4e6
docs: expand Write Operations Fail troubleshooting section
Copilot Mar 18, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
19 changes: 18 additions & 1 deletion docs/src/content/docs/troubleshooting/common-issues.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -208,7 +208,24 @@ gh extension upgrade gh-aw

### Write Operations Fail

Use safe outputs or request new safe output types.
Agentic workflows cannot write to GitHub directly. All writes (issues, comments, PR updates)
must go through the `safe-outputs` system, which validates and executes write operations on
behalf of the workflow.

Ensure your workflow frontmatter declares the safe output types it needs:

```yaml wrap
safe-outputs:
create-issue:
title-prefix: "[bot] "
labels: [automation]
add-comment: # no configuration required; uses defaults
update-issue: # no configuration required; uses defaults
```

If the operation you need is not listed in the [Safe Outputs reference](/gh-aw/reference/safe-outputs/),
it may not be supported yet. See the [Safe Outputs Specification](/gh-aw/reference/safe-outputs-specification/)
for the full list of available output types and their configuration options.

### Safe Outputs Not Creating Issues

Expand Down
Loading