Discard Artifacts
/api/v1/vc/discard
Description |
Discards changes to the specified artifact(s). |
URL |
[Blueprint_URI]/api/v1/vc/discard |
Supported Methods |
|
Request Body |
The list of artifacts that you want to publish must be included in the body of the request. Read more about how to specify a list of artifacts in the request body. |
Blueprint result codes
Your response may contain ResultCode and Message parameters if your request involves changes to Blueprint data. These parameters provide detailed information about the result of your request.
-
200 (OK)
- Successfully discarded the artifact.
-
404 (Not Found)
- Artifact not found in the project.
- Artifact type not found.
-
413 (Nothing to Discard)
- The artifact does not have any changes to discard.
-
415 (Not All Dependent Artifacts Included)
This operation does not include all dependent artifacts to be published or discarded.
-
500 (Error)
- A system error has occurred.
HTTP status codes
-
200: OK
-
201: Successfully Created
-
206: Partial Content
-
400: Bad Request
This error can occur for a variety of reasons:
-
401: Unauthorized
- The Blueprint token is missing, invalid or expired.
-
403: Forbidden
- The applicable permissions are needed. For example, this error can occur when:
- An Author or Collaborate license is needed for access.
- Comment permissions are needed on the artifact.
- Edit permissions are needed on the change summary job.
- The applicable permissions are needed. For example, this error can occur when:
-
404: NotFound
-
Item is not found in the project. For example, this error can occur when:
- Artifact not found.
- Artifact type not found.
- Project not found.
- ALM target not found.
- Change summary job not found.
- User does not have edit permissions for this artifact, project or ALM target.
-
-
409: Conflict
- Reason for failure can be found in the response body. Additional information may also be found in the log.
-
411: Length Required
- If the Content-Length header is missing in the request.
-
413: Request Entity Too Large
- If the provided file size is larger than allowed.
-
415: Unsupported Media Type
- If the provided media type is not of MIME Multipart Content "form-data."
-
416: Request Range Not Satisfiable
- If
offset
points to a part of a collection that is not available.
- If
-
501: Not Implemented
500: Internal Server Error