> ## Documentation Index
> Fetch the complete documentation index at: https://deepline.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# DiscoLike: Cancel Contacts Run

> Stop a contacts run that has not finished. Includes SDK V2 guidance, input constraints, response fields, and Deepline credit cost.

Stop a contacts run that has not finished.

> [!NOTE]
>
> Tool ID: `discolike_cancel_contacts_run`

## Run this action

Use the TypeScript SDK for one call. Use `ctx.tools.execute(...)` inside a Play for durable calls, scheduled calls, or CSV processing.

```ts theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'discolike_cancel_contacts_run',
  {
    "run_id": "123e4567-e89b-42d3-a456-426614174000"
  },
);

console.log(result.toolResponse.raw);
```

### CLI

```bash theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
deepline run discolike_cancel_contacts_run --input '{
  "run_id": "123e4567-e89b-42d3-a456-426614174000"
}'
```

## Example response

The SDK returns this shape at `result.toolResponse.raw`. The example values illustrate the response.

```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
{
  "data": {
    "id": "id_123",
    "kind": "example",
    "status": "example",
    "generation": 123,
    "created_at": "2026-01-15T12:00:00Z",
    "updated_at": "2026-01-15T12:00:00Z",
    "expires_at": "2026-01-15T12:00:00Z"
  }
}
```

Use `deepline describe discolike_cancel_contacts_run --json` for the latest machine-readable contract.

## Input reference

Stops a run that has not finished. Work already charged is not refunded. A finished run returns 409.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `payload.run_id` | `string` | Yes | — | Format: `uuid`. |

<details>
  <summary>Show raw input schema</summary>

  ### Input JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Stops a run that has not finished. Work already charged is not refunded. A finished run returns 409.",
    "properties": {
      "run_id": {
        "type": "string",
        "format": "uuid"
      }
    },
    "required": [
      "run_id"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Output reference

Standard tool result payload.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `result.data` | `object` | Yes | — | Provider response payload. |
| `result.data.progress` | `record` | No | — | — |
| `result.data.applied_company_filters` | `object \| null` | No | — | Effective company filters after prompt extraction. absent until resolved. |
| `result.data.applied_company_filters.filter_industry` | `array \| null` | No | — | Filter by industry category (ANY-OF. prefix + to require a category). Valid values: ACCOUNTING, ADVERTISING\_AND\_MARKETING, AGRICULTURE\_AND\_NATURAL\_RESOURCES, ALCOHOL\_AND\_TOBACCO, AUTOMOTIVE, BIG\_DATA\_AND\_ANALYTICS, BIOTECHNOLOGY, BLOCKCHAIN\_AND\_CRYPTOCURRENCY, BUSINESS\_PRODUCTS\_AND\_SERVICES, CLOUD\_COMPUTING, COMPUTER\_HARDWARE\_AND\_SEMICONDUCTORS, CONGLOMERATES\_SHELL\_AND\_HOLDING\_COMPANIES, CONSTRUCTION, CONSUMER\_PRODUCTS, CONSUMER\_SERVICES, CYBERSECURITY, DEFENSE\_AND\_AEROSPACE, E-COMMERCE, See the live schema for the complete constraint. |
| `result.data.applied_company_filters.negate_filter_industry` | `array \| null` | No | — | Exclude contacts at companies in specified industries. Valid values: ACCOUNTING, ADVERTISING\_AND\_MARKETING, AGRICULTURE\_AND\_NATURAL\_RESOURCES, ALCOHOL\_AND\_TOBACCO, AUTOMOTIVE, BIG\_DATA\_AND\_ANALYTICS, BIOTECHNOLOGY, BLOCKCHAIN\_AND\_CRYPTOCURRENCY, BUSINESS\_PRODUCTS\_AND\_SERVICES, CLOUD\_COMPUTING, COMPUTER\_HARDWARE\_AND\_SEMICONDUCTORS, CONGLOMERATES\_SHELL\_AND\_HOLDING\_COMPANIES, CONSTRUCTION, CONSUMER\_PRODUCTS, CONSUMER\_SERVICES, CYBERSECURITY, DEFENSE\_AND\_AEROSPACE, E-COMMERCE, EDUCATION, ENERGY, See the live schema for the complete constraint. |
| `result.data.applied_company_filters.filter_country` | `array \| null` | No | — | Filter by company country using ISO-3166-1 alpha-2 codes (e.g., US, GB, DE). Also accepts region aliases: EU, LATAM, MENA, APAC, NORDICS, DACH, BENELUX, GCC, ASEAN, CEE, ANZ, EUROPE, ASIA, AFRICA, NORTH\_AMERICA, SOUTH\_AMERICA, OCEANIA, ANTARCTICA. |
| `result.data.applied_company_filters.negate_filter_country` | `array \| null` | No | — | Exclude contacts at companies in specified countries. Accepts same codes and region aliases as filter\_country. |
| `result.data.applied_company_filters.filter_state` | `array \| null` | No | — | Filter by company state/region. Accepts ISO 3166-2 codes or names, listed at [https://docs.discolike.com/states/](https://docs.discolike.com/states/), resolved against the selected countries. A value that resolves under none is ignored. |
| `result.data.applied_company_filters.negate_filter_state` | `array \| null` | No | — | Exclude contacts at companies in specified states. Same format as filter\_state. |
| `result.data.applied_company_filters.employee_range` | `string \| null` | No | — | Filter by employee count range. Format: 'min,max' (e.g., '51,200'). Maps to buckets: 1-10, 11-50, 51-200, 201-500, 501-1000, 1001-5000, 5001-10000, 10001+. |
| `result.data.applied_company_filters.revenue_range` | `string \| null` | No | — | Company revenue range as 'min,max' in raw numbers, e.g. '10000000,50000000'. |
| `result.data.applied_company_filters.sub_industry` | `array \| null` | No | — | Only include companies in these sub-industries. |
| `result.data.error` | `string \| null` | No | — | — |
| `result.data.input` | `record` | No | — | — |
| `result.data.id` | `string` | Yes | — | — |
| `result.data.kind` | `string` | Yes | — | — |
| `result.data.status` | `string` | Yes | — | — |
| `result.data.current_step` | `"find_contacts" \| "find_missing" \| "find_emails" \| "discover" \| "validate"` | No | — | Allowed: `find_contacts`, `find_missing`, `find_emails`, `discover`, `validate`. |
| `result.data.generation` | `integer` | Yes | — | — |
| `result.data.steps` | `record` | No | — | — |
| `result.data.total_estimate_usd` | `string \| null` | No | — | — |
| `result.data.total_charged_usd` | `string` | No | `"0"` | — |
| `result.data.created_at` | `string` | Yes | — | Format: `date-time`. |
| `result.data.updated_at` | `string` | Yes | — | Format: `date-time`. |
| `result.data.expires_at` | `string` | Yes | — | Format: `date-time`. |
| `result.data.companies` | `array` | No | — | — |
| `result.data.companies[].company` | `record` | No | — | — |
| `result.data.companies[].domain` | `string` | Yes | — | — |
| `result.data.companies[].status` | `"pending" \| "finding_people" \| "finding_emails" \| "validated" \| "skipped" \| "cancelled" \| "failed"` | Yes | — | Allowed: `pending`, `finding_people`, `finding_emails`, `validated`, `skipped`, `cancelled`, `failed`. |
| `result.data.companies[].people_reviewed` | `integer` | No | `0` | — |
| `result.data.companies[].mailboxes_checked` | `integer` | No | `0` | — |
| `result.data.companies[].validated_contacts` | `integer` | No | `0` | — |
| `result.data.companies[].contacts` | `array` | No | — | — |
| `result.data.companies[].contacts[].row_key` | `string` | Yes | — | — |
| `result.data.companies[].contacts[].persona_id` | `integer \| null` | No | — | — |
| `result.data.companies[].contacts[].domain` | `string` | Yes | — | — |
| `result.data.companies[].contacts[].name` | `string \| null` | No | — | — |
| `result.data.companies[].contacts[].title` | `string \| null` | No | — | — |
| `result.data.companies[].contacts[].linkedin_url` | `string \| null` | No | — | — |
| `result.data.companies[].contacts[].seniority` | `string \| null` | No | — | — |
| `result.data.companies[].contacts[].department` | `string \| null` | No | — | — |
| `result.data.companies[].contacts[].debug_only` | `boolean \| null` | No | — | — |
| `result.data.companies[].contacts[].reason` | `string \| null` | No | — | — |
| `result.data.companies[].contacts[].company_score` | `number \| null` | No | — | — |
| `result.data.companies[].contacts[].p_fit` | `number \| null` | No | — | — |
| `result.data.companies[].contacts[].fit_label` | `string \| null` | No | — | — |
| `result.data.companies[].contacts[].floor` | `boolean` | No | `false` | — |
| `result.data.companies[].contacts[].not_fit` | `boolean` | No | `false` | — |
| `result.data.companies[].contacts[].email` | `string \| null` | No | — | — |
| `result.data.companies[].contacts[].email_status` | `string \| null` | No | — | — |

The table shows the first 50 fields. Use the live contract below for every field.

> [!NOTE]
>
> This output schema is too large for an inline display. Read the complete live contract with `deepline describe discolike_cancel_contacts_run --json`.

## Deepline cost

* Pricing model: `fixed` (per call).
* Estimated Deepline credits: `0` per pricing unit.
* Provider-native pricing may still exist outside Deepline credit billing.

## Related documentation

* [Connect integrations](https://deepline.com/docs/integrations.md)
* [SDK V2 quickstart](https://deepline.com/docs/sdk-v2/quickstart.md)
* [SDK reference](https://deepline.com/docs/sdk-v2/sdk-reference.md)
* [Run tools across a CSV](https://deepline.com/docs/sdk-v2/batch-csv.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.