Skip to content

Petstore

This is a sample Pet Store Server based on the OpenAPI 3.0 specification.

Type: petstore/v1


Connections

Version: 1

OAuth2 Implicit

Properties

NameLabelTypeControl TypeDescriptionRequired
clientIdClient IdSTRINGTEXTtrue
clientSecretClient SecretSTRINGTEXTtrue

API Key

Properties

NameLabelTypeControl TypeDescriptionRequired
keyKeySTRINGTEXTtrue
valueValueSTRINGTEXTtrue

Actions

Add a new pet to the store

Name: addPet

Add a new pet to the store

Properties

NameLabelTypeControl TypeDescriptionRequired
petPetOBJECT
Properties {INTEGER(id), STRING(name), {INTEGER(id), STRING(name)}(category), [STRING](photoUrls), [{INTEGER(id), STRING(name)}](tags), STRING(status)}
OBJECT_BUILDERtrue

Output

Type: OBJECT

Properties

NameTypeControl Type
idINTEGERINTEGER
nameSTRINGTEXT
categoryOBJECT
Properties {INTEGER(id), STRING(name)}
OBJECT_BUILDER
photoUrlsARRAY
Items [STRING]
ARRAY_BUILDER
tagsARRAY
Items [{INTEGER(id), STRING(name)}]
ARRAY_BUILDER
statusSTRING
Options available, pending, sold
SELECT

JSON Example

{
"label" : "Add a new pet to the store",
"name" : "addPet",
"parameters" : {
"pet" : {
"id" : 1,
"name" : "",
"category" : {
"id" : 1,
"name" : ""
},
"photoUrls" : [ "" ],
"tags" : [ {
"id" : 1,
"name" : ""
} ],
"status" : ""
}
},
"type" : "petstore/v1/addPet"
}

Update an existing pet

Name: updatePet

Update an existing pet by Id

Properties

NameLabelTypeControl TypeDescriptionRequired
petPetOBJECT
Properties {INTEGER(id), STRING(name), {INTEGER(id), STRING(name)}(category), [STRING](photoUrls), [{INTEGER(id), STRING(name)}](tags), STRING(status)}
OBJECT_BUILDERtrue

Output

Type: OBJECT

Properties

NameTypeControl Type
idINTEGERINTEGER
nameSTRINGTEXT
categoryOBJECT
Properties {INTEGER(id), STRING(name)}
OBJECT_BUILDER
photoUrlsARRAY
Items [STRING]
ARRAY_BUILDER
tagsARRAY
Items [{INTEGER(id), STRING(name)}]
ARRAY_BUILDER
statusSTRING
Options available, pending, sold
SELECT

JSON Example

{
"label" : "Update an existing pet",
"name" : "updatePet",
"parameters" : {
"pet" : {
"id" : 1,
"name" : "",
"category" : {
"id" : 1,
"name" : ""
},
"photoUrls" : [ "" ],
"tags" : [ {
"id" : 1,
"name" : ""
} ],
"status" : ""
}
},
"type" : "petstore/v1/updatePet"
}

Finds Pets by status

Name: findPetsByStatus

Multiple status values can be provided with comma separated strings

Properties

NameLabelTypeControl TypeDescriptionRequired
statusStatusSTRING
Options available, pending, sold
SELECTStatus values that need to be considered for filterfalse

Output

Type: ARRAY

Properties

NameTypeControl Type
OBJECT
Properties {INTEGER(id), STRING(name), {INTEGER(id), STRING(name)}(category), [STRING](photoUrls), [{INTEGER(id), STRING(name)}](tags), STRING(status)}
OBJECT_BUILDER

JSON Example

{
"label" : "Finds Pets by status",
"name" : "findPetsByStatus",
"parameters" : {
"status" : ""
},
"type" : "petstore/v1/findPetsByStatus"
}

Finds Pets by tags

Name: findPetsByTags

Multiple tags can be provided with comma separated strings. Use tag1, tag2, tag3 for testing.

Properties

NameLabelTypeControl TypeDescriptionRequired
tagsTagsARRAY
Items [STRING]
ARRAY_BUILDERTags to filter byfalse

Output

Type: ARRAY

Properties

NameTypeControl Type
OBJECT
Properties {INTEGER(id), STRING(name), {INTEGER(id), STRING(name)}(category), [STRING](photoUrls), [{INTEGER(id), STRING(name)}](tags), STRING(status)}
OBJECT_BUILDER

JSON Example

{
"label" : "Finds Pets by tags",
"name" : "findPetsByTags",
"parameters" : {
"tags" : [ "" ]
},
"type" : "petstore/v1/findPetsByTags"
}

Deletes a pet

Name: deletePet

delete a pet

Properties

NameLabelTypeControl TypeDescriptionRequired
api_keyApi KeySTRINGTEXTfalse
petIdPet IdINTEGERINTEGERPet id to deletetrue

JSON Example

{
"label" : "Deletes a pet",
"name" : "deletePet",
"parameters" : {
"api_key" : "",
"petId" : 1
},
"type" : "petstore/v1/deletePet"
}

Find pet by ID

Name: getPetById

Returns a single pet

Properties

NameLabelTypeControl TypeDescriptionRequired
petIdPet IdINTEGERINTEGERID of pet to returntrue

Output

Type: OBJECT

Properties

NameTypeControl Type
idINTEGERINTEGER
nameSTRINGTEXT
categoryOBJECT
Properties {INTEGER(id), STRING(name)}
OBJECT_BUILDER
photoUrlsARRAY
Items [STRING]
ARRAY_BUILDER
tagsARRAY
Items [{INTEGER(id), STRING(name)}]
ARRAY_BUILDER
statusSTRING
Options available, pending, sold
SELECT

JSON Example

{
"label" : "Find pet by ID",
"name" : "getPetById",
"parameters" : {
"petId" : 1
},
"type" : "petstore/v1/getPetById"
}

Updates a pet in the store with form data

Name: updatePetWithForm

Properties

NameLabelTypeControl TypeDescriptionRequired
petIdPet IdINTEGERINTEGERID of pet that needs to be updatedtrue
nameNameSTRINGTEXTName of pet that needs to be updatedfalse
statusStatusSTRINGTEXTStatus of pet that needs to be updatedfalse

JSON Example

{
"label" : "Updates a pet in the store with form data",
"name" : "updatePetWithForm",
"parameters" : {
"petId" : 1,
"name" : "",
"status" : ""
},
"type" : "petstore/v1/updatePetWithForm"
}

uploads an image

Name: uploadFile

Properties

NameLabelTypeControl TypeDescriptionRequired
petIdPet IdINTEGERINTEGERID of pet to updatetrue
additionalMetadataAdditional MetadataSTRINGTEXTAdditional Metadatafalse
fileEntryFILE_ENTRYFILE_ENTRYnull

Output

Type: OBJECT

Properties

NameTypeControl Type
codeINTEGERINTEGER
typeSTRINGTEXT
messageSTRINGTEXT

JSON Example

{
"label" : "uploads an image",
"name" : "uploadFile",
"parameters" : {
"petId" : 1,
"additionalMetadata" : "",
"fileEntry" : {
"extension" : "",
"mimeType" : "",
"name" : "",
"url" : ""
}
},
"type" : "petstore/v1/uploadFile"
}

Returns pet inventories by status

Name: getInventory

Returns a map of status codes to quantities

Output

Type: OBJECT

JSON Example

{
"label" : "Returns pet inventories by status",
"name" : "getInventory",
"type" : "petstore/v1/getInventory"
}

Place an order for a pet

Name: placeOrder

Place a new order in the store

Properties

NameLabelTypeControl TypeDescriptionRequired
orderOrderOBJECT
Properties {INTEGER(id), INTEGER(petId), INTEGER(quantity), DATE_TIME(shipDate), STRING(status), BOOLEAN(complete)}
OBJECT_BUILDERnull

Output

Type: OBJECT

Properties

NameTypeControl Type
idINTEGERINTEGER
petIdINTEGERINTEGER
quantityINTEGERINTEGER
shipDateDATE_TIMEDATE_TIME
statusSTRING
Options placed, approved, delivered
SELECT
completeBOOLEAN
Options true, false
SELECT

JSON Example

{
"label" : "Place an order for a pet",
"name" : "placeOrder",
"parameters" : {
"order" : {
"id" : 1,
"petId" : 1,
"quantity" : 1,
"shipDate" : "2021-01-01T00:00:00",
"status" : "",
"complete" : false
}
},
"type" : "petstore/v1/placeOrder"
}

Delete purchase order by ID

Name: deleteOrder

For valid response try integer IDs with value < 1000. Anything above 1000 or nonintegers will generate API errors

Properties

NameLabelTypeControl TypeDescriptionRequired
orderIdOrder IdINTEGERINTEGERID of the order that needs to be deletedtrue

JSON Example

{
"label" : "Delete purchase order by ID",
"name" : "deleteOrder",
"parameters" : {
"orderId" : 1
},
"type" : "petstore/v1/deleteOrder"
}

Find purchase order by ID

Name: getOrderById

For valid response try integer IDs with value <= 5 or > 10. Other values will generate exceptions.

Properties

NameLabelTypeControl TypeDescriptionRequired
orderIdOrder IdINTEGERINTEGERID of order that needs to be fetchedtrue

Output

Type: OBJECT

Properties

NameTypeControl Type
idINTEGERINTEGER
petIdINTEGERINTEGER
quantityINTEGERINTEGER
shipDateDATE_TIMEDATE_TIME
statusSTRING
Options placed, approved, delivered
SELECT
completeBOOLEAN
Options true, false
SELECT

JSON Example

{
"label" : "Find purchase order by ID",
"name" : "getOrderById",
"parameters" : {
"orderId" : 1
},
"type" : "petstore/v1/getOrderById"
}

Create user

Name: createUser

This can only be done by the logged in user.

Properties

NameLabelTypeControl TypeDescriptionRequired
userUserOBJECT
Properties {INTEGER(id), STRING(username), STRING(firstName), STRING(lastName), STRING(email), STRING(password), STRING(phone), INTEGER(userStatus)}
OBJECT_BUILDERnull

Output

Type: OBJECT

Properties

NameTypeControl Type
idINTEGERINTEGER
usernameSTRINGTEXT
firstNameSTRINGTEXT
lastNameSTRINGTEXT
emailSTRINGTEXT
passwordSTRINGTEXT
phoneSTRINGTEXT
userStatusINTEGERINTEGER

JSON Example

{
"label" : "Create user",
"name" : "createUser",
"parameters" : {
"user" : {
"id" : 1,
"username" : "",
"firstName" : "",
"lastName" : "",
"email" : "",
"password" : "",
"phone" : "",
"userStatus" : 1
}
},
"type" : "petstore/v1/createUser"
}

Creates list of users with given input array

Name: createUsersWithListInput

Creates list of users with given input array

Properties

NameLabelTypeControl TypeDescriptionRequired
__itemsItemsARRAY
Items [{INTEGER(id), STRING(username), STRING(firstName), STRING(lastName), STRING(email), STRING(password), STRING(phone), INTEGER(userStatus)}]
ARRAY_BUILDERnull

Output

Type: ARRAY

Properties

NameTypeControl Type
OBJECT
Properties {INTEGER(id), STRING(username), STRING(firstName), STRING(lastName), STRING(email), STRING(password), STRING(phone), INTEGER(userStatus)}
OBJECT_BUILDER

JSON Example

{
"label" : "Creates list of users with given input array",
"name" : "createUsersWithListInput",
"parameters" : {
"__items" : [ {
"id" : 1,
"username" : "",
"firstName" : "",
"lastName" : "",
"email" : "",
"password" : "",
"phone" : "",
"userStatus" : 1
} ]
},
"type" : "petstore/v1/createUsersWithListInput"
}

Delete user

Name: deleteUser

This can only be done by the logged in user.

Properties

NameLabelTypeControl TypeDescriptionRequired
usernameUsernameSTRINGTEXTThe name that needs to be deletedtrue

JSON Example

{
"label" : "Delete user",
"name" : "deleteUser",
"parameters" : {
"username" : ""
},
"type" : "petstore/v1/deleteUser"
}

Get user by user name

Name: getUserByName

Properties

NameLabelTypeControl TypeDescriptionRequired
usernameUsernameSTRINGTEXTThe name that needs to be fetched. Use user1 for testing.true

Output

Type: OBJECT

Properties

NameTypeControl Type
idINTEGERINTEGER
usernameSTRINGTEXT
firstNameSTRINGTEXT
lastNameSTRINGTEXT
emailSTRINGTEXT
passwordSTRINGTEXT
phoneSTRINGTEXT
userStatusINTEGERINTEGER

JSON Example

{
"label" : "Get user by user name",
"name" : "getUserByName",
"parameters" : {
"username" : ""
},
"type" : "petstore/v1/getUserByName"
}

Update user

Name: updateUser

This can only be done by the logged in user.

Properties

NameLabelTypeControl TypeDescriptionRequired
usernameUsernameSTRINGTEXTname that need to be deletedtrue
userUserOBJECT
Properties {INTEGER(id), STRING(username), STRING(firstName), STRING(lastName), STRING(email), STRING(password), STRING(phone), INTEGER(userStatus)}
OBJECT_BUILDERnull

Output

Type: OBJECT

Properties

NameTypeControl Type
idINTEGERINTEGER
usernameSTRINGTEXT
firstNameSTRINGTEXT
lastNameSTRINGTEXT
emailSTRINGTEXT
passwordSTRINGTEXT
phoneSTRINGTEXT
userStatusINTEGERINTEGER

JSON Example

{
"label" : "Update user",
"name" : "updateUser",
"parameters" : {
"username" : "",
"user" : {
"id" : 1,
"username" : "",
"firstName" : "",
"lastName" : "",
"email" : "",
"password" : "",
"phone" : "",
"userStatus" : 1
}
},
"type" : "petstore/v1/updateUser"
}