---
title: "Delete Target By Name"
method: DELETE
path: "/api/v1/pipelines/targets/{name}"
tags: ["secure", "targets"]
---

# Delete Target By Name

`DELETE /api/v1/pipelines/targets/{name}`

Deletes a target from RDI settings by its name.

## Path parameters

- `name` string, required

## Response `200`

Successful Response

- union
  - ActionIdResponse — Response model containing an action ID.
    - `action_id` string, nullable
  - RedisDiApiV1ModulesSharedResponseError — Model representing an error status.
    - `status` 'error'
    - `error` string, required

## Other responses

- `401` — Unauthorized
- `403` — Forbidden

## Changes

- **2026-02-02** `f0a3d26cc0c6` — 2 warning, 1 info
  - removed the optional property `errors` from the response with the `401` status
  - removed the optional property `errors` from the response with the `403` status
  - removed the non-success response with the status `422`
- **2025-06-16** `557b7644b943` — 2 breaking, 2 info
  - the response property `anyOf[subschema #1: ActionIdResponse]/action_id` became optional for the status `200`
  - response property `anyOf[subschema #1: ActionIdResponse]/action_id` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - added the optional property `errors` to the response with the `401` status
  - added the optional property `errors` to the response with the `403` status
- **2025-02-27** `b0ed6c7dac42` — 3 info
  - added the non-success response with the status `422`
  - the response property `anyOf[subschema #1: ActionIdResponse]/action_id` became required for the status `200`
  - response property `anyOf[subschema #1: ActionIdResponse]/action_id` list-of-types was narrowed by removing types `null` from media type `application/json` of response `200`

[Change history](https://skmtc.dev/redis/apis/redis-data-integration-api/changes/api/v1/pipelines/targets/:name/delete.md)

---

[API](https://skmtc.dev/redis/apis/redis-data-integration-api.md) · [All operations](https://skmtc.dev/redis/apis/redis-data-integration-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/redis/redis-data-integration-api/revisions/30f630f0aac5/schema)