> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.telekesher.dev/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.telekesher.dev/_mcp/server.

# Operation

An `Operation` represents a command accepted for asynchronous processing. Use
its `operation_uuid` to correlate the lifecycle webhooks triggered by that
command. See [Awaiting asynchronous operations](/async-operations) for a
complete correlation pattern.

`status: in_progress` means command processing continues asynchronously and its
result arrives through lifecycle events. `status: completed` is used when an
idempotent terminal command was already satisfied without further processing.
`status: cancelling` means a cancellation request was accepted while the
original command moves toward its terminal lifecycle event.

## Resource representation

### The Operation resource

```json
{
  "operation_uuid": "string",
  "status": "in_progress"
}
```

## Properties

### Schema (`Operation`)

```yaml
components:
  schemas:
    OperationStatus:
      type: string
      enum:
        - in_progress
        - completed
        - cancelling
      title: OperationStatus
    Operation:
      type: object
      properties:
        operation_uuid:
          type: string
          format: uuid
        status:
          $ref: '#/components/schemas/OperationStatus'
      required:
        - operation_uuid
        - status
      title: Operation
```