# abort\_sequence

Abort the sequence in a task's checkout.

writes · not idempotent · destructive · CLI only · [Agent](https://komrad.dev/latest/api/agent.md)

Komrad keeps the checkout at a ref first and mails the task's writer what was aborted.

## Calling it

```bash
curl -X POST http://127.0.0.1:8787/komrad.agent.v1.AgentService/AbortSequence \
  -H 'Content-Type: application/json' \
  -d '{
  "task_id": "<task_id>"
}'
```

```bash
komrad rpc abort-sequence \
  --task-id '<uuid>'
```

## Request

### AbortSequenceRequest

| Field | Type | Description |
| --- | --- | --- |
| [one of](https://komrad.dev/latest/api/agent/abort-sequence.md#komrad-agent-v1-AbortSequenceRequest-task)\* |  | The task whose sequence to abort. |
| [`task_id`](https://komrad.dev/latest/api/agent/abort-sequence.md#komrad-agent-v1-AbortSequenceRequest-task_id) | uuid | The task, by id. |
| [`task_slug`](https://komrad.dev/latest/api/agent/abort-sequence.md#komrad-agent-v1-AbortSequenceRequest-task_slug) | string not empty | The task, by slug. |

## Response

### AbortSequenceResponse

| Field | Type | Description |
| --- | --- | --- |
| [`sequence`](https://komrad.dev/latest/api/agent/abort-sequence.md#komrad-agent-v1-AbortSequenceResponse-sequence) | [Sequence](https://komrad.dev/latest/api/agent/abort-sequence.md#komrad-task-v1-Sequence) | The sequence that was aborted. |
| [`branch`](https://komrad.dev/latest/api/agent/abort-sequence.md#komrad-agent-v1-AbortSequenceResponse-branch) | string | The branch of the task's checkout after the abort. Empty when the checkout is detached. |
| [`parked_ref`](https://komrad.dev/latest/api/agent/abort-sequence.md#komrad-agent-v1-AbortSequenceResponse-parked_ref) | string | The ref that keeps the checkout as it was before the abort, conflicts included. |

## Types

### Sequence

Sequence is a git operation stopped part way in a task's checkout.

| Value | Description |
| --- | --- |
| [`none`](https://komrad.dev/latest/api/agent/abort-sequence.md#komrad-task-v1-Sequence-none) | No git operation is stopped part way. |
| [`rebase`](https://komrad.dev/latest/api/agent/abort-sequence.md#komrad-task-v1-Sequence-rebase) | A rebase stopped on a commit it could not replay. |
| [`am`](https://komrad.dev/latest/api/agent/abort-sequence.md#komrad-task-v1-Sequence-am) | A `git am` stopped on a patch it could not apply. |
| [`merge`](https://komrad.dev/latest/api/agent/abort-sequence.md#komrad-task-v1-Sequence-merge) | A merge stopped on conflicts. |
| [`cherry_pick`](https://komrad.dev/latest/api/agent/abort-sequence.md#komrad-task-v1-Sequence-cherry_pick) | A cherry-pick stopped on conflicts or paused between commits. |
| [`revert`](https://komrad.dev/latest/api/agent/abort-sequence.md#komrad-task-v1-Sequence-revert) | A revert stopped on conflicts or paused between commits. |
