---
title: "Update a policy."
method: PUT
path: "/tyk/policies/{polID}"
tags: ["Policies"]
---

# Update a policy.

`PUT /tyk/policies/{polID}`

You can update a Policy in your Tyk Instance by ID.

## Path parameters

- `polID` string, required

## Request body

- Policy
  - `_id` string
  - `access_rights` object, nullable
  - `active` boolean
  - `enable_http_signature_validation` boolean
  - `graphql_access_rights` object, nullable
  - `hmac_enabled` boolean
  - `id` string
  - `is_inactive` boolean
  - `key_expires_in` integer
  - `last_updated` string
  - `max_query_depth` integer
  - `meta_data` object, nullable
  - `name` string
  - `org_id` string
  - `partitions` PolicyPartitions
    - `acl` boolean
    - `complexity` boolean
    - `per_api` boolean
    - `quota` boolean
    - `rate_limit` boolean
  - `per` number, double
  - `post_expiry_action` 'retain' | 'delete' — Defines the action to take on a Session in Redis after it expires. Valid values are "retain" and "delete".
  - `post_expiry_grace_period` integer — Duration in seconds to retain a Session in Redis after it expires. Used with post_expiry_action "retain". Set to -1 to retain indefinitely.
  - `quota_max` integer
  - `quota_renewal_rate` integer
  - `rate` number, double
  - `smoothing` RateLimitSmoothing, nullable
    - `delay` integer
    - `enabled` boolean
    - `step` integer
    - `threshold` integer
    - `trigger` number
  - `tags` string[], nullable
  - `throttle_interval` number, double
  - `throttle_retry_limit` integer

## Response `200`

Policy updated

- ApiModifyKeySuccess
  - `action` string
  - `key` string
  - `key_hash` string
  - `status` string

## Other responses

- `400` — malformed request
- `403` — Forbidden
- `500` — Internal server error.

---

[API](https://skmtc.net/tyktechnologies/apis/tyk-gateway-api.md) · [All operations](https://skmtc.net/tyktechnologies/apis/tyk-gateway-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tyktechnologies/tyk-gateway-api/versions/4ae998d5545e/schema)