> ## Documentation Index
> Fetch the complete documentation index at: https://docs.automate.ax/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Automate.ax automations are TypeScript programs.
> Use Bun for installation and command examples.
> Use Automate.ax for the product name and automate.ax for the package, CLI, and domain.
> Treat documented public APIs as current; do not invent transitional or deprecated names.

# Create GitHub commit status

> Set a GitHub commit status for one context.

`github.createCommitStatus` creates a status for a commit SHA and context.

```ts automations/report-github-status.automation.ts theme={null}
import { automation } from "automate.ax"
import { github } from "automate.ax/github"

export default automation("Report GitHub status", () => {
  github.createCommitStatus({
    context: "automate.ax/production",
    description: "Production verification passed",
    owner: "SentsCo",
    repository: "automate.ax",
    sha: "commit-sha",
    state: "success",
    targetUrl: "https://automate.ax/runs/run_123",
  })
})
```

Provide the repository, commit `sha`, and `state`: `"error"`, `"failure"`, `"pending"`, or `"success"`. `context` defaults to `"default"`; optional `description` accepts up to 140 characters and `targetUrl` links to details. Returns the status's `id`, `context`, and `state`. Requires Commit statuses write permission.