# GitHub Agents API

**Canonical:** https://apis.io/apis/github/github-agents-api/  
**Provider:** GitHub — https://apis.io/providers/github/  
**Base URL:** https://api.github.com  
**Documentation:** https://docs.github.com/en/rest/gists?apiVersion=2022-11-28

GitHub Agents API is one of 129 APIs that [GitHub](https://apis.io/providers/github/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification and an AsyncAPI event-driven specification. Tagged areas include Agents. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an AsyncAPI specification, and an API reference.

Endpoints for Agents secrets and variables.

## Operations (30)

| Method | Path | Summary |
|---|---|---|
| GET | `/orgs/{org}/agents/secrets` | List organization secrets |
| GET | `/orgs/{org}/agents/secrets/public-key` | Get an organization public key |
| GET | `/orgs/{org}/agents/secrets/{secret_name}` | Get an organization secret |
| PUT | `/orgs/{org}/agents/secrets/{secret_name}` | Create or update an organization secret |
| DELETE | `/orgs/{org}/agents/secrets/{secret_name}` | Delete an organization secret |
| GET | `/orgs/{org}/agents/secrets/{secret_name}/repositories` | List selected repositories for an organization secret |
| PUT | `/orgs/{org}/agents/secrets/{secret_name}/repositories` | Set selected repositories for an organization secret |
| PUT | `/orgs/{org}/agents/secrets/{secret_name}/repositories/{repository_id}` | Add selected repository to an organization secret |
| DELETE | `/orgs/{org}/agents/secrets/{secret_name}/repositories/{repository_id}` | Remove selected repository from an organization secret |
| GET | `/orgs/{org}/agents/variables` | List organization variables |
| POST | `/orgs/{org}/agents/variables` | Create an organization variable |
| GET | `/orgs/{org}/agents/variables/{name}` | Get an organization variable |
| PATCH | `/orgs/{org}/agents/variables/{name}` | Update an organization variable |
| DELETE | `/orgs/{org}/agents/variables/{name}` | Delete an organization variable |
| GET | `/orgs/{org}/agents/variables/{name}/repositories` | List selected repositories for an organization variable |
| PUT | `/orgs/{org}/agents/variables/{name}/repositories` | Set selected repositories for an organization variable |
| PUT | `/orgs/{org}/agents/variables/{name}/repositories/{repository_id}` | Add selected repository to an organization variable |
| DELETE | `/orgs/{org}/agents/variables/{name}/repositories/{repository_id}` | Remove selected repository from an organization variable |
| GET | `/repos/{owner}/{repo}/agents/organization-secrets` | List repository organization secrets |
| GET | `/repos/{owner}/{repo}/agents/organization-variables` | List repository organization variables |
| GET | `/repos/{owner}/{repo}/agents/secrets` | List repository secrets |
| GET | `/repos/{owner}/{repo}/agents/secrets/public-key` | Get a repository public key |
| GET | `/repos/{owner}/{repo}/agents/secrets/{secret_name}` | Get a repository secret |
| PUT | `/repos/{owner}/{repo}/agents/secrets/{secret_name}` | Create or update a repository secret |
| DELETE | `/repos/{owner}/{repo}/agents/secrets/{secret_name}` | Delete a repository secret |
| GET | `/repos/{owner}/{repo}/agents/variables` | List repository variables |
| POST | `/repos/{owner}/{repo}/agents/variables` | Create a repository variable |
| GET | `/repos/{owner}/{repo}/agents/variables/{name}` | Get a repository variable |
| PATCH | `/repos/{owner}/{repo}/agents/variables/{name}` | Update a repository variable |
| DELETE | `/repos/{owner}/{repo}/agents/variables/{name}` | Delete a repository variable |

## Machine-readable artifacts (26)

- **OpenAPI** — https://artifacts.apis.io/github/openapi/github-agents-api-openapi.yml
- **Documentation** — https://docs.github.com/en/rest/apps
- **Documentation** — https://docs.github.com/en/rest/codes-of-conduct/codes-of-conduct
- **Documentation** — https://docs.github.com/en/rest/emojis
- **Documentation** — https://docs.github.com/en/rest/gitignore
- **Documentation** — https://docs.github.com/en/rest/apps/installations
- **Documentation** — https://docs.github.com/en/rest/enterprise-admin
- **Documentation** — https://docs.github.com/en/rest/activity/events
- **Documentation** — https://docs.github.com/en/rest/orgs
- **Documentation** — https://docs.github.com/en/rest/rate-limit
- **Documentation** — https://docs.github.com/en/enterprise-cloud@latest/rest/scim
- **Documentation** — https://docs.github.com/en/rest/using-the-rest-api/getting-started-with-the-rest-api
- **Documentation** — https://docs.github.com/en/rest/teams
- **Documentation** — https://docs.github.com/en/rest/meta/meta
- **Documentation** — https://docs.github.com/en/rest/actions
- **Documentation** — https://docs.github.com/en/rest/branches
- **Documentation** — https://docs.github.com/en/rest/code-scanning
- **Documentation** — https://docs.github.com/en/rest/collaborators
- **Documentation** — https://docs.github.com/en/rest/dependabot
- **AsyncAPI** — https://artifacts.apis.io/github/asyncapi/github-webhooks-asyncapi.yml
- **Documentation** — https://docs.github.com/en/rest/webhooks
- **Reference** — https://docs.github.com/en/webhooks/webhook-events-and-payloads
- **Documentation** — https://docs.github.com/en/rest/pulls
- **Documentation** — https://docs.github.com/en/rest/git/tags
- **Documentation** — https://docs.github.com/en/rest/repos/autolinks
- **Documentation** — https://docs.github.com/en/rest/collaborators/invitations

## Other GitHub APIs (12)

- [GitHub Gists API](https://apis.io/apis/github/github-gists-api/)
- [GitHub Issues API](https://apis.io/apis/github/github-issues-api/)
- [GitHub Licenses API](https://apis.io/apis/github/github-licenses-api/)
- [GitHub Markdown API](https://apis.io/apis/github/github-markdown-api/)
- [GitHub Meta API](https://apis.io/apis/github/github-meta-api/)
- [GitHub Projects API](https://apis.io/apis/github/github-projects-api/)
- [GitHub Repos API](https://apis.io/apis/github/github-repos-api/)
- [GitHub Search API](https://apis.io/apis/github/github-search-api/)
- [GitHub User API](https://apis.io/apis/github/github-user-api/)
- [GitHub Deployments API](https://apis.io/apis/github/github-deployments-api/)
- [GitHub Releases API](https://apis.io/apis/github/github-releases-api/)
- [GitHub Pages API](https://apis.io/apis/github/github-pages-api/)

## Tags

Agents

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/github/github-agents-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/github/.