---
title: "PATCH /api/v3/gateways/{gatewayId}"
method: PATCH
path: "/api/v3/gateways/{gatewayId}"
tags: ["Gateways"]
---

# PATCH /api/v3/gateways/{gatewayId}

`PATCH /api/v3/gateways/{gatewayId}`

## Path parameters

- `gatewayId` string, uuid, required

## Request body

- object
  - `authMethod` union — Replacement auth method. Same shape as in create — `aws` with allowlists or `token` with no config. Existing gateways keep working until they restart and re-authenticate via the new method.
    - object
      - `method` 'aws', required
      - `stsEndpoint` string — The endpoint URL for the AWS STS API.
      - `allowedPrincipalArns` string — The comma-separated list of trusted IAM principal ARNs that are allowed to authenticate with Infisical.
      - `allowedAccountIds` string — The comma-separated list of trusted AWS account IDs that are allowed to authenticate with Infisical.
    - object
      - `method` 'token', required

## Response `200`

Default Response

- object
  - `id` string, uuid, required
  - `identityId` string, uuid, nullable
  - `name` string, required
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time, required
  - `heartbeat` string, date-time, nullable
  - `heartbeatTTL` number, nullable
  - `canRevoke` boolean, required
  - `authMethod` union, required
    - object
      - `method` 'aws', required
      - `config` object, required
        - `id` string, uuid, required
        - `stsEndpoint` string, required
        - `allowedPrincipalArns` string, required
        - `allowedAccountIds` string, required
        - `createdAt` string, date-time, required
        - `updatedAt` string, date-time, required
    - object
      - `method` 'token', required
      - `config` object, required
    - object
      - `method` 'identity', required
      - `config` object, required
        - `identityId` string, required
        - `identityName` string, nullable, required

## Other responses

- `400` — Default Response
- `401` — Default Response
- `403` — Default Response
- `404` — Default Response
- `422` — Default Response
- `500` — Default Response

---

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