Was this helpful?


API Platform Base Path: https://api.enterprise.apigee.com/v1/o/{org_name}

API Resource Path:


Description: Undeploys an API proxy revision from an environment (typically 'test' or 'prod')

Verb: POST
Auth: Basic Auth
Media types:



This method undeploys a revision of an API proxy from the environment specified

Call this method before you deploy a new revision of an API proxy to the environment.

This method is also used before an API is deleted, since an API proxy cannot be deleted while it is deployed in an environment.

Sample Request:
$ curl -H "Content-type: application/octet-stream" -X DELETE \
https://api.enterprise.apigee.com/v1/o/{org_name}/environments/{env_name}/apis/{api_name}/revisions/{revision_number}/deployments" \
-u myname:mypass
Sample Response:
  "aPIProxy" : "myapi",
  "configuration" : {
    "basePath" : "/",
    "steps" : [ ]
  "environment" : "test",
  "name" : "1",
  "organization" : "myorg",
  "revision" : "1",
  "server" : [ {
    "status" : "undeployed",
    "type" : [ "message-processor" ],
    "uUID" : "90096dd1-1019-406b-9f42-fbb80cd01200"
  }, {
    "status" : "undeployed",
    "type" : [ "message-processor" ],
    "uUID" : "7d6e2eb1-581a-4db0-8045-20d9c3306549"
  }, {
    "status" : "undeployed",
    "type" : [ "router" ],
    "uUID" : "1619e2d7-c822-45e0-9f97-63882fb6a805"
  }, {
    "status" : "undeployed",
    "type" : [ "router" ],
    "uUID" : "8a5f3d5f-46f8-4e99-b4cc-955875c8a8c8"
  } ],
  "state" : "undeployed"
Response Payload Elements:
Name Description
aPIProxy The name of the API
configuration Base path and policy steps that are configured for the deployment
environment The environment where the APi was deployed
name The name of the APi revision
organization The organization of the API provider
revision The revision number of the APi proxy
server Information on Apigee servers deployed to service the API
state The state of the API: deployed or undeployed
  "code" : "messaging.config.beans.ApplicationDoesNotExist",
  "message" : "APIProxy named myapi does not exist in organization myorg",
  "contexts" : [ ]


Add new comment

Provide your email address if you wish to be contacted offline about your comment.
We will not display your email address as part of your comment.

We'd love your feedback and perspective! Please be as specific as possible.
Type the characters you see in this picture. (verify using audio)

Type the characters you see in the picture above; if you can't read them, submit the form and a new image will be generated. Not case sensitive.