# Hlix Cycles API

**Canonical:** https://apis.io/apis/hlix-ai/hlix-ai-cycles-api/  
**Provider:** Hlix — https://apis.io/providers/hlix-ai/  
**Base URL:** https://server.hlix.ai

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

Multi-task units of work and their conversations.

## Operations (29)

| Method | Path | Summary |
|---|---|---|
| GET | `/v1/api/cycles` | List cycles |
| POST | `/v1/api/cycles` | Propose a cycle |
| POST | `/v1/api/cycles/direct` | Create a separate cycle |
| POST | `/v1/api/cycles/from-branch` | Open a cycle from a pushed branch |
| DELETE | `/v1/api/cycles/{id}` | Delete a draft or failed cycle |
| GET | `/v1/api/cycles/{id}` | Get one cycle with its tasks |
| PATCH | `/v1/api/cycles/{id}` | Update a cycle's title, description or target branch |
| GET | `/v1/api/cycles/{id}/artifacts` | List a cycle's stored artifacts |
| GET | `/v1/api/cycles/{id}/artifacts/{filename}` | Get a signed download URL for one cycle artifact |
| PATCH | `/v1/api/cycles/{id}/assign` | Hand a cycle to a teammate |
| POST | `/v1/api/cycles/{id}/continue` | Admit a branch cycle once its branch is at the pushed commit |
| GET | `/v1/api/cycles/{id}/diagnostics` | Read why a cycle failed or is waiting |
| GET | `/v1/api/cycles/{id}/e2e` | The cycle's user-side verification: journeys, outcomes and evidence keys |
| GET | `/v1/api/cycles/{id}/events` | List a cycle's own events |
| POST | `/v1/api/cycles/{id}/execute` | Run a cycle's lifecycle |
| GET | `/v1/api/cycles/{id}/messages` | Read a cycle's conversation |
| POST | `/v1/api/cycles/{id}/messages` | Send a message to a cycle's coder |
| GET | `/v1/api/cycles/{id}/pending-requests` | List a cycle's pending requests |
| GET | `/v1/api/cycles/{id}/review` | Get the verified review evidence for a cycle |
| GET | `/v1/api/cycles/{id}/review/comments` | List the review comments on a cycle |
| POST | `/v1/api/cycles/{id}/review/comments` | Comment on a cycle's review |
| PATCH | `/v1/api/cycles/{id}/review/comments/{commentId}` | Resolve or reopen a cycle review comment |
| POST | `/v1/api/cycles/{id}/review/request-revision` | Ask the cycle's engineer to address the open comments |
| POST | `/v1/api/cycles/{id}/stop` | Stop a running cycle |
| POST | `/v1/api/cycles/{id}/tasks` | Add a task to a cycle |
| DELETE | `/v1/api/cycles/{id}/tasks/{taskId}` | Remove a task from a cycle |
| PATCH | `/v1/api/cycles/{id}/tasks/{taskId}` | Update a task inside a cycle |
| GET | `/v1/api/cycles/{id}/timeline` | List a cycle's events plus its tasks' |
| GET | `/v1/api/cycles/{id}/usage` | Get the cycle's cost and token roll-up |

## Machine-readable artifacts (1)

- **OpenAPI** — https://artifacts.apis.io/hlix-ai/openapi/hlix-ai-cycles-api-openapi.yml

## Other Hlix APIs (12)

- [Hlix Agent Runs API](https://apis.io/apis/hlix-ai/hlix-ai-agent-runs-api/)
- [Hlix Agents API](https://apis.io/apis/hlix-ai/hlix-ai-agents-api/)
- [Hlix AI API](https://apis.io/apis/hlix-ai/hlix-ai-ai-api/)
- [Hlix Alerts API](https://apis.io/apis/hlix-ai/hlix-ai-alerts-api/)
- [Hlix Attention API](https://apis.io/apis/hlix-ai/hlix-ai-attention-api/)
- [Hlix Audit Log API](https://apis.io/apis/hlix-ai/hlix-ai-audit-log-api/)
- [Hlix Billing API](https://apis.io/apis/hlix-ai/hlix-ai-billing-api/)
- [Hlix Brand Kit API](https://apis.io/apis/hlix-ai/hlix-ai-brand-kit-api/)
- [Hlix Changes API](https://apis.io/apis/hlix-ai/hlix-ai-changes-api/)
- [Hlix Chat API](https://apis.io/apis/hlix-ai/hlix-ai-chat-api/)
- [Hlix Client Accounts API](https://apis.io/apis/hlix-ai/hlix-ai-client-accounts-api/)
- [Hlix Client Billing API](https://apis.io/apis/hlix-ai/hlix-ai-client-billing-api/)

## Tags

Cycles

---

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