---
title: "Update API package current specification"
method: PUT
path: "/v3/api-packages/{packageId}/current-specification"
tags: ["API Package Specification"]
---

# Update API package current specification

`PUT /v3/api-packages/{packageId}/current-specification`

Updates the current specification of an API package.

## Request body

- ApiSpec
  - `id` string, uuid — The API specification identifier.
  - `content` string — The raw content of your API specification, in json or yaml format (OpenAPI or AsyncAPI).
  - `validation_messages` object[] — The errors that occurred while parsing the API specification.
    - `message` string, required
  - `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.

## Response `200`

API specification (OpenAPI or AsyncAPI)

- object
  - `id` string, uuid, required — The API specification identifier.
  - `content` string, required — The raw content of your API specification, in json or yaml format (OpenAPI or AsyncAPI).
  - `validation_messages` object[], required — The errors that occurred while parsing the API specification.
    - `message` string, required
  - `type` 'oas2' | 'oas3' | 'asyncapi', required — The type of specification being stored. This allows us to render the specification correctly.
  - `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 - `slug` property must be unique
- `415` — Unsupported Media Type

---

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