---
title: "Stop A Task"
method: POST
path: "/organizations/{organization_id}/tasks/{task_id}/stop"
tags: ["Tasks"]
---

# Stop A Task

`POST /organizations/{organization_id}/tasks/{task_id}/stop`

Send a stop event to SQS in an attempt to stop the task from executing

## Path parameters

- `organization_id` string, required
- `task_id` string, required

## Request body

- PostOrganizationsTasksStopRequest
  - `organization_id` string
  - `timezone_location` string
  - `name` string
  - `description` string
  - `inherit_tags` boolean
  - `schedule_cron` string
  - `is_active` boolean
  - `is_fls_indexed` boolean
  - `fls_index_freq` string
  - `created_by` string
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `deleted_at` string
  - `retention` object
    - `type` string
    - `tiered_unit` string
    - `tiered_amount` integer
    - `tiered_weekly_enabled` boolean
    - `tiered_monthly_enabled` boolean
    - `tiered_yearly_enabled` boolean
    - `tiered_weekly_amount` integer
    - `tiered_monthly_amount` integer
    - `tiered_yearly_amount` integer
    - `backups_count` string
  - `tag_with` string[]
  - `copies` object
    - `first_region` string
    - `second_region` string
    - `cross_account_region` string
    - `cross_account_id` string
    - `interval` integer
    - `retention_type` string
    - `retention_amount` integer
    - `retention_unit` string
  - `s3_archive` object
    - `weekly_storage_class` string
    - `monthly_storage_class` string
    - `yearly_storage_class` string
    - `weekly_enabled` boolean
    - `monthly_enabled` boolean
    - `yearly_enabled` boolean
  - `resource_options` object
    - `ec2_amis` boolean
    - `ami_reboot` boolean
    - `vss` boolean
    - `scripts` boolean
  - `encryption_mappings` string[]
  - `rules` object[]
    - `regions` string[]
    - `resource_types` string[]
    - `policy_id` integer
    - `rule_type` string
    - `exclude` boolean
    - `all_accounts` boolean
    - `all_regions` boolean
    - `all_resource_types` boolean
    - `created_at` string
    - `updated_at` string
    - `accounts` object[]
      - `account_id` string
    - `tags` object[]
      - `rule_id` integer
      - `key` string
      - `value` string
    - `resources` string[]

## Response `200`

200 response

- PostOrganizationsTasksStopResponse
  - `id` string
  - `job_id` string
  - `region` string
  - `resource_type` string
  - `resource_id` string
  - `resource_name` string
  - `action` string
  - `is_success` boolean
  - `halt` boolean
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `job` object
    - `id` string
    - `organization_id` string
    - `account_id` string
    - `type` string
    - `action` string
    - `object_id` integer
    - `event_type` string
    - `event_at` string, date-time
    - `cron` string
    - `cron_location` string
    - `total_tasks` integer
    - `total_success` integer
    - `total_fail` integer
    - `seq` integer
    - `halt` string
    - `created_at` string, date-time
    - `updated_at` string, date-time

## Other responses

- `201` — 201 response
- `401` — 401 response
- `403` — 403 response
- `404` — 404 response

---

[API](https://skmtc.dev/druva/apis/authentication.md) · [All operations](https://skmtc.dev/druva/apis/authentication/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/druva/authentication/revisions/2af2bf148b25/schema)