v50

latestOpenAPI 3.1.0Apache 2.0raw.githubusercontent.com2026-07-068428533.0 MB

API Product Version Specification

Create API Product Version Specification

Creates a specification for a version of an API product. Note: You can only have one specification for a product version.

post/v2/api-products/{apiProductId}/product-versions/{apiProductVersionId}/specifications

Request body

namestring required

The name of the API product version specification

contentstring byte required

The base64 encoded contents of the API product version specification

Example request

{
  "name": "oas.yaml",
  "content": "TXkgWUFNTCBvciBKU09OIGZvcm1hdHRlZCBPQVMgY29udGVudA=="
}

Response

API product version specification

idstring uuid required

The API product version specification identifier.

namestring required

The name of the API product version specification

contentstring required

The contents of the API product version specification

created_atstring date-time required

An ISO-8601 timestamp representation of entity creation date.

updated_atstring date-time required

An ISO-8601 timestamp representation of entity update date.

Example response

{
  "id": "7710d5c4-d902-410b-992f-18b814155b53",
  "name": "oas.yaml",
  "content": "My YAML or JSON formatted OAS content",
  "created_at": "2022-11-04T20:10:06.927Z",
  "updated_at": "2022-11-04T20:10:06.927Z"
}