Update API

put

/mobile/tools/1.0/apis/{id}

Overwrites the API metadata.

Request

Supported Media Types
Path Parameters
Header Parameters
  • The request completes successfully only if the ETag of the corresponding asset matches the value of this HTTP request header. To force overwrite, pass the value `*`.
Body ()
The API representation for PUT requests.
Root Schema : apiUpdate
Type: object
The API representation for PUT requests.
Match All
Show Source
Nested Schema : assetUpdate
Type: object
The asset representation for PUT requests.
Show Source
Nested Schema : apiUpdate-allOf[1]
Type: object
Show Source
Nested Schema : stringArray
Type: array
Minimum Number of Items: 0
An array of string values.
Show Source
Nested Schema : icon
Type: object
Information about the icon that's associated with the API or connector.
Show Source
Nested Schema : apiSecurity
Type: object
The API security for POST and PUT requests.
Show Source
Nested Schema : securityAccess
Type: object
Access details.
Show Source
Nested Schema : endpointSecurityArray
Type: array
Minimum Number of Items: 0
An array of endpoint security elements.
Show Source
Nested Schema : endpointSecurity
Type: object
The API security for POST and PUT requests.
Show Source

Response

Supported Media Types

200 Response

The API metadata was updated, and metadata for the new API was returned.
Headers
  • The ETag corresponds to the state of the API (that is, the value increments by one on each change operation). You can use this ETag with the `If-Match` HTTP header on a request.
Body ()
Information about the API (short form) and the RAML-validation result. This information doesn't include the RAML descriptor.
Root Schema : apiCreatedWithRamlValidation
Type: object
Information about the API (short form) and the RAML-validation result. This information doesn't include the RAML descriptor.
Match All
Show Source
Nested Schema : apiShort
Type: object
The short API definition representation.
Match All
Show Source
Nested Schema : apiCreatedWithRamlValidation-allOf[1]
Type: object
Show Source
Nested Schema : assetGet
Type: object
The asset representation for GET requests.
Match All
Show Source
Nested Schema : apiShort-allOf[1]
Type: object
Show Source
Nested Schema : assetUpdate
Type: object
The asset representation for PUT requests.
Show Source
Nested Schema : assetIdEtag
Type: object
The asset ID and entity tag (ETag) values.
Show Source
Nested Schema : trash
Type: object
Indicator of whether the asset is in the trash.
Show Source
Nested Schema : assetGet-allOf[3]
Type: object
Show Source
Nested Schema : entityLinksArray
Type: array
Minimum Number of Items: 0
An array of links for an entity's metadata.
Show Source
Nested Schema : items
Type: object
Link to the entity's metadata.
Show Source
Nested Schema : icon
Type: object
Information about the icon that's associated with the API or connector.
Show Source
Nested Schema : ramlValidationReport
Type: object
The result of the RAML validation.
Show Source
Nested Schema : apiSecurity
Type: object
The API security for POST and PUT requests.
Show Source
Nested Schema : validationResults
Type: array
Minimum Number of Items: 0
Show Source
Nested Schema : securityAccess
Type: object
Access details.
Show Source
Nested Schema : endpointSecurityArray
Type: array
Minimum Number of Items: 0
An array of endpoint security elements.
Show Source
Nested Schema : stringArray
Type: array
Minimum Number of Items: 0
An array of string values.
Show Source
Nested Schema : endpointSecurity
Type: object
The API security for POST and PUT requests.
Show Source

400 Response

Missing API specification.
Body ()
Root Schema : error
Type: object
Show Source
Nested Schema : errorDetails
Type: object
Show Source

409 Response

The update modified either the name or the version, and an API with the same name and version as the updated API already exists.
Body ()
Root Schema : error
Type: object
Show Source
Nested Schema : errorDetails
Type: object
Show Source

412 Response

The operation failed based on the `If-Match` condition. Typically, this is the result of concurrent modification detection. It also can be the result of improper values specified in the request headers.
Body ()
Root Schema : error
Type: object
Show Source
Nested Schema : errorDetails
Type: object
Show Source