---
title: "PUT /proxies/{id}"
method: PUT
path: "/proxies/{id}"
tags: ["Proxies"]
---

# PUT /proxies/{id}

`PUT /proxies/{id}`

## Path parameters

- `id` string, uuid, required

## Request body

- UpdateProxyRequest
  - `name` string, required
  - `destination_url` string, required
  - `request_reactor_id` string, uuid, nullable
  - `response_reactor_id` string, uuid, nullable
  - `request_transform` ProxyTransform
    - `type` string, nullable
    - `code` string, nullable
    - `matcher` string, nullable
    - `expression` string, nullable
    - `replacement` string, nullable
    - `options` ProxyTransformOptions
      - `token` CreateTokenRequest
        - `id` string, nullable
        - `type` string, nullable
        - `data` unknown
        - `encrypted` string, nullable
        - `privacy` Privacy
          - `classification` string, nullable
          - `impact_level` string, nullable
          - `restriction_policy` string, nullable
        - `metadata` object, nullable
        - `search_indexes` string[], nullable
        - `fingerprint_expression` string, nullable
        - `mask` unknown
        - `deduplicate_token` boolean, nullable
        - `expires_at` string, nullable
        - `containers` string[], nullable
        - `token_intent_id` string, nullable
        - `owner_merchant_id` string, uuid, nullable
      - `identifier` string, nullable
      - `value` string, nullable
      - `location` string, nullable
      - `runtime` Runtime
        - `image` string, nullable
        - `dependencies` object, nullable
        - `resolutions` object, nullable
        - `warm_concurrency` integer, nullable
        - `timeout` integer, nullable
        - `resources` string, nullable
        - `permissions` string[], nullable
  - `response_transform` ProxyTransform
    - `type` string, nullable
    - `code` string, nullable
    - `matcher` string, nullable
    - `expression` string, nullable
    - `replacement` string, nullable
    - `options` ProxyTransformOptions
      - `token` CreateTokenRequest
        - `id` string, nullable
        - `type` string, nullable
        - `data` unknown
        - `encrypted` string, nullable
        - `privacy` Privacy
          - `classification` string, nullable
          - `impact_level` string, nullable
          - `restriction_policy` string, nullable
        - `metadata` object, nullable
        - `search_indexes` string[], nullable
        - `fingerprint_expression` string, nullable
        - `mask` unknown
        - `deduplicate_token` boolean, nullable
        - `expires_at` string, nullable
        - `containers` string[], nullable
        - `token_intent_id` string, nullable
        - `owner_merchant_id` string, uuid, nullable
      - `identifier` string, nullable
      - `value` string, nullable
      - `location` string, nullable
      - `runtime` Runtime
        - `image` string, nullable
        - `dependencies` object, nullable
        - `resolutions` object, nullable
        - `warm_concurrency` integer, nullable
        - `timeout` integer, nullable
        - `resources` string, nullable
        - `permissions` string[], nullable
  - `request_transforms` ProxyTransform[], nullable
    - `type` string, nullable
    - `code` string, nullable
    - `matcher` string, nullable
    - `expression` string, nullable
    - `replacement` string, nullable
    - `options` ProxyTransformOptions
      - `token` CreateTokenRequest
        - `id` string, nullable
        - `type` string, nullable
        - `data` unknown
        - `encrypted` string, nullable
        - `privacy` Privacy
          - `classification` string, nullable
          - `impact_level` string, nullable
          - `restriction_policy` string, nullable
        - `metadata` object, nullable
        - `search_indexes` string[], nullable
        - `fingerprint_expression` string, nullable
        - `mask` unknown
        - `deduplicate_token` boolean, nullable
        - `expires_at` string, nullable
        - `containers` string[], nullable
        - `token_intent_id` string, nullable
        - `owner_merchant_id` string, uuid, nullable
      - `identifier` string, nullable
      - `value` string, nullable
      - `location` string, nullable
      - `runtime` Runtime
        - `image` string, nullable
        - `dependencies` object, nullable
        - `resolutions` object, nullable
        - `warm_concurrency` integer, nullable
        - `timeout` integer, nullable
        - `resources` string, nullable
        - `permissions` string[], nullable
  - `response_transforms` ProxyTransform[], nullable
    - `type` string, nullable
    - `code` string, nullable
    - `matcher` string, nullable
    - `expression` string, nullable
    - `replacement` string, nullable
    - `options` ProxyTransformOptions
      - `token` CreateTokenRequest
        - `id` string, nullable
        - `type` string, nullable
        - `data` unknown
        - `encrypted` string, nullable
        - `privacy` Privacy
          - `classification` string, nullable
          - `impact_level` string, nullable
          - `restriction_policy` string, nullable
        - `metadata` object, nullable
        - `search_indexes` string[], nullable
        - `fingerprint_expression` string, nullable
        - `mask` unknown
        - `deduplicate_token` boolean, nullable
        - `expires_at` string, nullable
        - `containers` string[], nullable
        - `token_intent_id` string, nullable
        - `owner_merchant_id` string, uuid, nullable
      - `identifier` string, nullable
      - `value` string, nullable
      - `location` string, nullable
      - `runtime` Runtime
        - `image` string, nullable
        - `dependencies` object, nullable
        - `resolutions` object, nullable
        - `warm_concurrency` integer, nullable
        - `timeout` integer, nullable
        - `resources` string, nullable
        - `permissions` string[], nullable
  - `application` Application
    - `id` string, uuid
    - `tenant_id` string, uuid
    - `name` string, nullable
    - `key` string, nullable
    - `keys` ApplicationKey[], nullable
      - `id` string, uuid
      - `key` string, nullable
      - `version` string, nullable
      - `created_by` string, uuid, nullable
      - `created_at` string, date-time, nullable
    - `type` string, nullable
    - `created_by` string, uuid, nullable
    - `created_at` string, date-time, nullable
    - `modified_by` string, uuid, nullable
    - `modified_at` string, date-time, nullable
    - `permissions` string[], nullable
    - `rules` AccessRule[], nullable
      - `description` string, nullable
      - `priority` integer, nullable
      - `container` string, nullable
      - `transform` string, nullable
      - `conditions` Condition[], nullable
        - `attribute` string, nullable
        - `operator` string, nullable
        - `value` string, nullable
      - `permissions` string[], nullable
  - `configuration` object, nullable
  - `require_auth` boolean, nullable
  - `disable_detokenization` boolean, nullable

## Response `200`

Success

- Proxy
  - `id` string, uuid
  - `key` string, nullable
  - `tenant_id` string, uuid
  - `name` string, nullable
  - `destination_url` string, nullable
  - `state` string, nullable
  - `request_reactor_id` string, uuid, nullable
  - `response_reactor_id` string, uuid, nullable
  - `require_auth` boolean
  - `request_transform` ProxyTransform
    - `type` string, nullable
    - `code` string, nullable
    - `matcher` string, nullable
    - `expression` string, nullable
    - `replacement` string, nullable
    - `options` ProxyTransformOptions
      - `token` CreateTokenRequest
        - `id` string, nullable
        - `type` string, nullable
        - `data` unknown
        - `encrypted` string, nullable
        - `privacy` Privacy
          - `classification` string, nullable
          - `impact_level` string, nullable
          - `restriction_policy` string, nullable
        - `metadata` object, nullable
        - `search_indexes` string[], nullable
        - `fingerprint_expression` string, nullable
        - `mask` unknown
        - `deduplicate_token` boolean, nullable
        - `expires_at` string, nullable
        - `containers` string[], nullable
        - `token_intent_id` string, nullable
        - `owner_merchant_id` string, uuid, nullable
      - `identifier` string, nullable
      - `value` string, nullable
      - `location` string, nullable
      - `runtime` Runtime
        - `image` string, nullable
        - `dependencies` object, nullable
        - `resolutions` object, nullable
        - `warm_concurrency` integer, nullable
        - `timeout` integer, nullable
        - `resources` string, nullable
        - `permissions` string[], nullable
  - `response_transform` ProxyTransform
    - `type` string, nullable
    - `code` string, nullable
    - `matcher` string, nullable
    - `expression` string, nullable
    - `replacement` string, nullable
    - `options` ProxyTransformOptions
      - `token` CreateTokenRequest
        - `id` string, nullable
        - `type` string, nullable
        - `data` unknown
        - `encrypted` string, nullable
        - `privacy` Privacy
          - `classification` string, nullable
          - `impact_level` string, nullable
          - `restriction_policy` string, nullable
        - `metadata` object, nullable
        - `search_indexes` string[], nullable
        - `fingerprint_expression` string, nullable
        - `mask` unknown
        - `deduplicate_token` boolean, nullable
        - `expires_at` string, nullable
        - `containers` string[], nullable
        - `token_intent_id` string, nullable
        - `owner_merchant_id` string, uuid, nullable
      - `identifier` string, nullable
      - `value` string, nullable
      - `location` string, nullable
      - `runtime` Runtime
        - `image` string, nullable
        - `dependencies` object, nullable
        - `resolutions` object, nullable
        - `warm_concurrency` integer, nullable
        - `timeout` integer, nullable
        - `resources` string, nullable
        - `permissions` string[], nullable
  - `request_transforms` ProxyTransform[], nullable
    - `type` string, nullable
    - `code` string, nullable
    - `matcher` string, nullable
    - `expression` string, nullable
    - `replacement` string, nullable
    - `options` ProxyTransformOptions
      - `token` CreateTokenRequest
        - `id` string, nullable
        - `type` string, nullable
        - `data` unknown
        - `encrypted` string, nullable
        - `privacy` Privacy
          - `classification` string, nullable
          - `impact_level` string, nullable
          - `restriction_policy` string, nullable
        - `metadata` object, nullable
        - `search_indexes` string[], nullable
        - `fingerprint_expression` string, nullable
        - `mask` unknown
        - `deduplicate_token` boolean, nullable
        - `expires_at` string, nullable
        - `containers` string[], nullable
        - `token_intent_id` string, nullable
        - `owner_merchant_id` string, uuid, nullable
      - `identifier` string, nullable
      - `value` string, nullable
      - `location` string, nullable
      - `runtime` Runtime
        - `image` string, nullable
        - `dependencies` object, nullable
        - `resolutions` object, nullable
        - `warm_concurrency` integer, nullable
        - `timeout` integer, nullable
        - `resources` string, nullable
        - `permissions` string[], nullable
  - `response_transforms` ProxyTransform[], nullable
    - `type` string, nullable
    - `code` string, nullable
    - `matcher` string, nullable
    - `expression` string, nullable
    - `replacement` string, nullable
    - `options` ProxyTransformOptions
      - `token` CreateTokenRequest
        - `id` string, nullable
        - `type` string, nullable
        - `data` unknown
        - `encrypted` string, nullable
        - `privacy` Privacy
          - `classification` string, nullable
          - `impact_level` string, nullable
          - `restriction_policy` string, nullable
        - `metadata` object, nullable
        - `search_indexes` string[], nullable
        - `fingerprint_expression` string, nullable
        - `mask` unknown
        - `deduplicate_token` boolean, nullable
        - `expires_at` string, nullable
        - `containers` string[], nullable
        - `token_intent_id` string, nullable
        - `owner_merchant_id` string, uuid, nullable
      - `identifier` string, nullable
      - `value` string, nullable
      - `location` string, nullable
      - `runtime` Runtime
        - `image` string, nullable
        - `dependencies` object, nullable
        - `resolutions` object, nullable
        - `warm_concurrency` integer, nullable
        - `timeout` integer, nullable
        - `resources` string, nullable
        - `permissions` string[], nullable
  - `application_id` string, uuid, nullable
  - `configuration` object, nullable
  - `proxy_host` string, nullable
  - `timeout` integer, nullable
  - `disable_detokenization` boolean
  - `client_certificate` string, nullable
  - `requested` RequestedProxy
    - `proxy` PendingProxy
      - `destination_url` string, nullable
      - `configuration` object, nullable
      - `require_auth` boolean
      - `request_transforms` ProxyTransform[], nullable
        - `type` string, nullable
        - `code` string, nullable
        - `matcher` string, nullable
        - `expression` string, nullable
        - `replacement` string, nullable
        - `options` ProxyTransformOptions
          - `token` CreateTokenRequest
            - `id` string, nullable
            - `type` string, nullable
            - `data` unknown
            - `encrypted` string, nullable
            - `privacy` Privacy
              - …
            - `metadata` object, nullable
            - `search_indexes` string[], nullable
            - `fingerprint_expression` string, nullable
            - `mask` unknown
            - `deduplicate_token` boolean, nullable
            - `expires_at` string, nullable
            - `containers` string[], nullable
            - `token_intent_id` string, nullable
            - `owner_merchant_id` string, uuid, nullable
          - `identifier` string, nullable
          - `value` string, nullable
          - `location` string, nullable
          - `runtime` Runtime
            - `image` string, nullable
            - `dependencies` object, nullable
            - `resolutions` object, nullable
            - `warm_concurrency` integer, nullable
            - `timeout` integer, nullable
            - `resources` string, nullable
            - `permissions` string[], nullable
      - `response_transforms` ProxyTransform[], nullable
        - `type` string, nullable
        - `code` string, nullable
        - `matcher` string, nullable
        - `expression` string, nullable
        - `replacement` string, nullable
        - `options` ProxyTransformOptions
          - `token` CreateTokenRequest
            - `id` string, nullable
            - `type` string, nullable
            - `data` unknown
            - `encrypted` string, nullable
            - `privacy` Privacy
              - …
            - `metadata` object, nullable
            - `search_indexes` string[], nullable
            - `fingerprint_expression` string, nullable
            - `mask` unknown
            - `deduplicate_token` boolean, nullable
            - `expires_at` string, nullable
            - `containers` string[], nullable
            - `token_intent_id` string, nullable
            - `owner_merchant_id` string, uuid, nullable
          - `identifier` string, nullable
          - `value` string, nullable
          - `location` string, nullable
          - `runtime` Runtime
            - `image` string, nullable
            - `dependencies` object, nullable
            - `resolutions` object, nullable
            - `warm_concurrency` integer, nullable
            - `timeout` integer, nullable
            - `resources` string, nullable
            - `permissions` string[], nullable
    - `error_code` string, nullable
    - `error_message` string, nullable
    - `error_details` object, nullable
  - `created_by` string, uuid, nullable
  - `created_at` string, date-time, nullable
  - `modified_by` string, uuid, nullable
  - `modified_at` string, date-time, nullable

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found

---

[API](https://skmtc.net/basistheory/apis/basis-theory-api.md) · [All operations](https://skmtc.net/basistheory/apis/basis-theory-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/basistheory/basis-theory-api/revisions/cbb8e098b560/schema)