# Codefresh Agents API

**Canonical:** https://apis.io/apis/codefresh/codefresh-agents-api/  
**Provider:** Codefresh — https://apis.io/providers/codefresh/  
**Base URL:** https://g.codefresh.io/api  
**Documentation:** https://g.codefresh.io/api/

Codefresh Agents API is one of 64 APIs that [Codefresh](https://apis.io/providers/codefresh/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Agents. The published artifact set on APIs.io includes an OpenAPI specification.

Manage and serve Codefresh Runners

## Operations (11)

| Method | Path | Summary |
|---|---|---|
| GET | `/agent/tasks` | Get tasks |
| PUT | `/agent/status` | Update agent status |
| GET | `/agent/{agentId}/tasks` | Get tasks |
| POST | `/agent/{agentId}/tasks/{taskId}/statuses` | Update agent task status |
| PUT | `/agent/{agentId}/status` | Update agent status |
| POST | `/agents` | Create agent |
| GET | `/agents` | List agents |
| GET | `/agents/name/{name}` | Get agent by Name |
| GET | `/agent/{agentId}` | Get by id |
| PUT | `/agent/{agentId}` | Update agent |
| DELETE | `/agent/{agentId}` | Delete agent |

## Machine-readable artifacts (1)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/codefresh/refs/heads/main/openapi/codefresh-agents-api-openapi.yml

## Other Codefresh APIs (12)

- [Codefresh REST API](https://apis.io/apis/codefresh/rest-api/)
- [Codefresh Accounts API](https://apis.io/apis/codefresh/codefresh-accounts-api/)
- [Codefresh Annotations API](https://apis.io/apis/codefresh/codefresh-annotations-api/)
- [Codefresh Audit API](https://apis.io/apis/codefresh/codefresh-audit-api/)
- [Codefresh Builds API](https://apis.io/apis/codefresh/codefresh-builds-api/)
- [Codefresh Clusters API](https://apis.io/apis/codefresh/codefresh-clusters-api/)
- [Codefresh Contexts API](https://apis.io/apis/codefresh/codefresh-contexts-api/)
- [Codefresh Environments API](https://apis.io/apis/codefresh/codefresh-environments-api/)
- [Codefresh Features API](https://apis.io/apis/codefresh/codefresh-features-api/)
- [Codefresh Helm API](https://apis.io/apis/codefresh/codefresh-helm-api/)
- [Codefresh Abac API](https://apis.io/apis/codefresh/codefresh-abac-api/)
- [Codefresh Account API](https://apis.io/apis/codefresh/codefresh-account-api/)

## Tags

Agents

---

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