---
title: "Update API"
method: PATCH
path: "/v3/apis/{apiId}"
tags: ["API"]
---

# Update API

`PATCH /v3/apis/{apiId}`

Updates an API.

## Query parameters

- `force` 'true' | 'false'

## Request body

- object
  - `id` string, uuid — The API identifier.
  - `name` string, nullable — The name of your API. The `name + version` combination must be unique for each API you publish.
  - `description` string, nullable — A description of your API. Will be visible on your live Portal.
  - `version` string, nullable — An optional version for your API. Leave this empty if your API is unversioned.
  - `current_version_summary` ApiVersionSummary, nullable
    - `id` string, uuid — The API version identifier.
    - `version` string, nullable — The version of this api spec.
    - `spec` object, nullable
      - `type` 'oas2' | 'oas3' | 'asyncapi' — The type of specification being stored. This allows us to render the specification correctly.
    - `created_at` string, date-time — An ISO-8601 timestamp representation of entity creation date.
    - `updated_at` string, date-time — An ISO-8601 timestamp representation of entity update date.
  - `slug` string, nullable — The `slug` is used in generated URLs to provide human readable paths. Defaults to `slugify(name + version)`
  - `api_spec_ids` string[] — The list of API specification ids for the API.
  - `portals` object[] — The list of portals which this API is published to.
    - `id` string, uuid, required — The portal identifier.
    - `name` string, required — The name of the portal, used to distinguish it from other portals.
    - `display_name` string, required — The display name of the portal. This value will be the portal's `name` in Portal API.
  - `labels` LabelsUpdate, nullable — Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types. Labels are intended to store **INTERNAL** metadata. Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
  - `attributes` ApiAttributes — A set of attributes that describe the API
  - `created_at` string, date-time — An ISO-8601 timestamp representation of entity creation date.
  - `updated_at` string, date-time — An ISO-8601 timestamp representation of entity update date.

## Response `200`

API

- ApiResponseSchema
  - `id` string, uuid, required — The API identifier.
  - `name` string, required — The name of your API. The `name + version` combination must be unique for each API you publish.
  - `description` string, nullable — A description of your API. Will be visible on your live Portal.
  - `version` string, nullable, required — An optional version for your API. Leave this empty if your API is unversioned.
  - `current_version_summary` ApiVersionSummary, nullable, required
    - `id` string, uuid — The API version identifier.
    - `version` string, nullable — The version of this api spec.
    - `spec` object, nullable
      - `type` 'oas2' | 'oas3' | 'asyncapi' — The type of specification being stored. This allows us to render the specification correctly.
    - `created_at` string, date-time — An ISO-8601 timestamp representation of entity creation date.
    - `updated_at` string, date-time — An ISO-8601 timestamp representation of entity update date.
  - `slug` string, nullable, required — The `slug` is used in generated URLs to provide human readable paths. Defaults to `slugify(name + version)`
  - `api_spec_ids` string[], required — The list of API specification ids for the API.
  - `portals` object[], required — The list of portals which this API is published to.
    - `id` string, uuid, required — The portal identifier.
    - `name` string, required — The name of the portal, used to distinguish it from other portals.
    - `display_name` string, required — The display name of the portal. This value will be the portal's `name` in Portal API.
  - `labels` Labels, required — Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types. Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
  - `attributes` ApiAttributes — A set of attributes that describe the API
  - `created_at` string, date-time, required — An ISO-8601 timestamp representation of entity creation date.
  - `updated_at` string, date-time, required — An ISO-8601 timestamp representation of entity update date.

## Other responses

- `400` — Bad Request
- `401` — ApiUnauthorized
- `403` — ApiForbidden
- `404` — Not Found
- `409` — Conflict - May occur when constraints are violated
- `415` — Unsupported Media Type

## Changes

- **2025-10-02** `ecce2daf9de6` — 7 breaking, 5 info
  - the response property `allOf[subschema #2]/invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterChoiceItem]/source` became nullable for the status `400`
  - the response property `allOf[subschema #2]/invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterDependentItem]/source` became nullable for the status `400`
  - the response property `allOf[subschema #2]/invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterMaximumLength]/source` became nullable for the status `400`
  - the response property `allOf[subschema #2]/invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterMinimumLength]/source` became nullable for the status `400`
  - …8 more
- **2025-08-12** `b2800570b3e2` — 1 breaking, 3 info
  - added the pattern `^[^,<>]*$` to the request property `attributes/additionalProperties/items/`
  - the `attributes` request property default value `{}` was added
  - the `attributes` response's property default value `{}` was added for the status `200`
  - the `attributes/additionalProperties/items/` response's property pattern `^[^,<>]*$` was added for the status `200`
- …earlier changes not shown

[Full history](https://skmtc.dev/kong/apis/konnect-api-beta/changes/v3/apis/:apiId/patch.md)

---

[API](https://skmtc.dev/kong/apis/konnect-api-beta.md) · [All operations](https://skmtc.dev/kong/apis/konnect-api-beta/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/kong/konnect-api-beta/revisions/ecce2daf9de6/schema)