---
title: "Update a grant"
method: PUT
path: "/api/v1/iga/grants/{grant_id}"
tags: ["accessManagement"]
---

# Update a grant

`PUT /api/v1/iga/grants/{grant_id}`

Update an identity grant's status or policy.

## Path parameters

- `grant_id` string, required

## Headers

- `X-Api-Key` string, required
- `X-Workspace-Id` string

## Request body

- object
  - `status` 'GRANTED' | 'EXPIRED' | 'EXTENDED' | 'REVOKED'
  - `policy_id` integer — Change the policy associated with the grant
  - `policy_key` string — Change the policy by key (alternative to policy_id)
  - `granted_by` integer — User ID who authorized this grant
  - `granted_at` string, date-time — When the grant was authorized

## Response `200`

Successful response

- AccessManagementPutapiV1IgaGrantsGrantIdResponse200 — Empty response body

## Changes

- **2026-08-12** `2ab1cf36239b` — 1 info
  - api operation id `putapi-v-1-iga-grants-grant-id` removed and replaced with `putapi_v1_iga_grants__grant_id`

[Change history](https://skmtc.dev/atomicwork/apis/atomicwork-public-api/changes/api/v1/iga/grants/:grant_id/put.md)

---

[API](https://skmtc.dev/atomicwork/apis/atomicwork-public-api.md) · [All operations](https://skmtc.dev/atomicwork/apis/atomicwork-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/atomicwork/atomicwork-public-api/revisions/6223f7496274/schema)