from retab import Retab

client = Retab()

result = client.workflows.runs.cancel(
    run_id="run_abc123",
    command_id="cmd_cancel_abc",  # optional dedup key
)

print(result.cancellation_status)
print(result.run.lifecycle.status)

import { Retab } from "@retab/node";

const client = new Retab({ apiKey: process.env.RETAB_API_KEY });

const result = await client.workflows.runs.cancel("run_abc123", "cmd_cancel_abc");

console.log(result.cancellationStatus);
console.log(result.run.lifecycle.status);

package main

import (
	"context"
	"fmt"
	"log"

	retab "github.com/retab-dev/retab/clients/go"
)

func ptr[T any](v T) *T { return &v }

func main() {
	ctx := context.Background()

	client, err := retab.NewClient("")
	if err != nil {
		log.Fatal(err)
	}

	result, err := client.Workflows.Runs.Cancel(ctx, "run_abc123", nil)
	if err != nil {
		log.Fatal(err)
	}

	fmt.Println(result.CancellationStatus)
	fmt.Println(result.Run.Lifecycle.Status())
}

require 'retab'

client = Retab::Client.new(api_key: ENV['RETAB_API_KEY'])

result = client.workflows.runs.cancel(
  run_id: 'run_abc123',
  command_id: 'cmd_cancel_abc',
)

puts result.cancellation_status
puts result.run.lifecycle.status

use retab::models::CancelWorkflowRequest;
use retab::resources::workflow_runs::CancelParams;
use retab::Retab;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = Retab::new(std::env::var("RETAB_API_KEY")?);

    let result = client
        .workflows().runs()
        .cancel(
            "run_abc123",
            CancelParams {
                body: Some(CancelWorkflowRequest {
                    command_id: Some("cmd_cancel_abc".into()),
                }),
            },
        )
        .await?;

    println!("{:?}", result.cancellation_status);
    println!("{:?}", result.run.lifecycle);
    Ok(())
}

<?php
require 'vendor/autoload.php';

use Retab\Client;

$client = new Client(apiKey: getenv('RETAB_API_KEY'));

$result = $client->workflows()->runs()->cancel(
    runId: 'run_abc123',
);
print_r($result);

using Retab;
using RetabClient = Retab.Retab;

var apiKey = Environment.GetEnvironmentVariable("RETAB_API_KEY")!;
var client = new RetabClient(apiKey);

var result = await client.Workflows.Runs.CancelAsync("run_abc123", new WorkflowRunsCancelOptions());
Console.WriteLine(result);

import com.retab.RetabClient;

public final class Example {
  public static void main(String[] args) throws Exception {
    RetabClient client = new RetabClient(System.getenv("RETAB_API_KEY"));

    var result = client.workflows().runs().cancel("run_abc123");
    System.out.println(result);
  }
}

curl -X 'POST' \
  'https://api.retab.com/v1/workflows/runs/run_abc123/cancel' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer <your-api-key>' \
  -d '{"command_id": "cmd_cancel_abc"}'

{
  "run": {
    "id": "run_abc123",
    "workflow": {
      "workflow_id": "wf_abc123xyz",
      "version_id": "ver_abc123xyz"
    },
    "trigger": { "type": "api" },
    "lifecycle": {
      "status": "cancelled",
      "reason": "user requested cancellation"
    },
    "timing": {
      "created_at": "2026-05-01T14:30:00Z",
      "started_at": "2026-05-01T14:30:00Z",
      "completed_at": "2026-05-01T14:30:08Z"
    },
    "inputs": { "documents": {}, "json_data": {} }
  },
  "cancellation_status": "cancelled"
}

{
  "run": {
    "id": "run_abc123",
    "workflow": {
      "workflow_id": "wf_abc123xyz",
      "version_id": "ver_abc123xyz"
    },
    "trigger": { "type": "api" },
    "lifecycle": { "status": "running" },
    "timing": {
      "created_at": "2026-05-01T14:30:00Z",
      "started_at": "2026-05-01T14:30:00Z",
      "completed_at": null
    },
    "inputs": { "documents": {}, "json_data": {} }
  },
  "cancellation_status": "cancellation_requested"
}

{
  "detail": "Workflow run not found"
}