Saves the provided Swagger definition

POST

/apis/{owner}/{api}

Saves the provided Swagger definition; the owner must match the token owner. The version will be extracted from the Swagger definitions itself.

Request

Path Params

Query Params

Body Params application/json

Examples

Responses

🟢200the API was successfully saved

application/json

Bodyapplication/json

🟢201new API was successfully saved

🟠400the Swagger definition was invalid

🟠403the API is not owned by the user

🟠409can not overwrite a published API version without force=true

🟠415invalid content type

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://openapi.space/api/v1/apis//' \
--header 'Content-Type: application/json' \
--data '{}'

Response Example

200 - Example 1

{
    "created": "2019-08-24T14:15:22.123Z",
    "description": "string",
    "modified": "2019-08-24T14:15:22.123Z",
    "name": "string",
    "owner": "string",
    "swagger": {},
    "url": "string",
    "versions": [
        null
    ]
}

Modified at 2023-08-15 10:35:02

Retrieves an API meta listing for all API versions for this owner and API

Deletes a particular version of the specified API