Skip to end of metadata
Go to start of metadata
Contents Summary


This REST API allows you to add a drawing object to the Word document. The request is an HTTP request with multipart content (see RFC 2046 or RFC 1341). The first part of the multipart content contains the drawing object data and the second contains a binary image. Moreover, the detail of resource properties are given below:

Parameter NameTypeDescription
RelativeHorizontalPositionAspose.Words.Drawing.ShapeBase.RelativeHorizontalPositionSpecifies where the distance to the image is measured.
RelativeVerticalPositionAspose.Words.Drawing.ShapeBase.RelativeVerticalPositionSpecifies where the distance to the image is measured.
LeftdoubleDistance in points from the origin to the left side of the image.
TopdoubleDistance in points from the origin to the top side of the image.
WidthdoubleWidth of the drawing objects in points.
HeightdoubleHeight of the drawing object in points.
WrapTypeAspose.Words.Drawing.ShapeBase.WrapTypeSpecifies how to wrap text around the image.

Resource URI

{file-name} is the name of the Word document containing elements.
{nodePath} is the path to a specific node in the document. If this URI is used, only elements contained within a specific node will be returned. Supported syntax:

  • sections/{sectionIndex} - references specific section.
  • paragraphs/{paragraphIndex} - references specific paragraph.
  • sections/{sectionIndex}/paragraphs/{paragraphIndex} - references specific paragraph within section.

{index} is the index of the specific drawing object.

Swagger UI lets you call this REST API directly from the browser. 

cURL Example



Using an SDK (API client) is the quickest way for a developer to speed up the development. An SDK takes care of a lot of low-level details of making requests and handling responses and lets you focus on writing code specific to your particular project. Check out our GitHub repository for a complete list of Aspose.Words Cloud SDKs along with working examples, to get you started in no time. Please check Available SDKs article to learn how to add an SDK to your project.

SDK Examples

  • No labels