---
title: "Upsert Processors Property"
method: PUT
path: "/api/v1/pipelines/processors/{prop}"
tags: ["secure", "processors"]
---

# Upsert Processors Property

`PUT /api/v1/pipelines/processors/{prop}`

Upserts a single processor property by property name.
The request body should contain a single 'value' field with the new value for the property.
The property name is specified in the URL path.

## Path parameters

- `prop` 'on_failed_retry_interval' | 'read_batch_size' | 'dedup' | 'dedup_max_size' | 'dedup_strategy' | 'duration' | 'write_batch_size' | 'error_handling' | 'dlq_max_messages' | 'target_data_type' | 'json_update_strategy' | 'initial_sync_processes' | 'idle_sleep_time_ms' | 'idle_streams_check_interval_ms' | 'busy_streams_check_interval_ms' | 'wait_enabled' | 'wait_timeout' | 'retry_on_replica_failure', required

## Request body

- ProcessorProperty
  - `value` 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-05-09** `acb8b4d3bbed` — 1 breaking
  - removed the enum value `debezium_lob_encoded_placeholder` from the `path` request parameter `prop`
- **2025-03-06** `5558a61192d4` — 1 info
  - added the new enum value `debezium_lob_encoded_placeholder` to the `path` request parameter `prop`
- **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/processors/:prop/put.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)