REST API - Defining an Artifact in the Request Body

You must define the artifact in the request body when you are adding an artifact.

Parameters

The following parameters must be specified within the Artifact element:

• ArtifactTypeId: Numerically identifies the type of artifact. The identifier can be obtained via the Get Artifact Type and List Artifact Types requests.
• Name: Identifies the name of the artifact.
• Any required properties of the applicable artifact type.

Properties Element

If you want to specify property values for your artifact, include a Properties element within the Artifact element.

Among others, the Properties element can contain the following elements:

• Property: (Required.) The element of the property specifications.
• PropertyTypeId: The corresponding elements, which can be populated in the Get Artifact call.

Examples

AddArtifact Example

Here is an example of a request body in XML format:

<?xml version="1.0" ?> 
<Artifact xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://www.blueprintsys.com/blueprint/api/v1">
  <ArtifactTypeId>25</ArtifactTypeId>
  <Name>New Textual Requirement</Name>
  <ParentId>10</ParentId>
  <Properties>
    <Property>
      <PropertyTypeId>235658</PropertyTypeId>
      <TextOrChoiceValue>Sample Description</TextOrChoiceValue>
    </Property>
    <Property>
      <NumberValue>15</NumberValue>
      <PropertyTypeId>235659</PropertyTypeId>
    </Property>
  </Properties>
</Artifact>

Here is an example of a request body in JSON format:

{
  "Name": "New Textual Requirement",
  "ParentId": 10,
  "ArtifactTypeId": 25,
  "Properties": [
    {
      "PropertyTypeId": 235658,
      "TextOrChoiceValue": "Sample Description"
    },
    {
      "PropertyTypeId": 235659,
      "NumberValue": 15.0
    }
  ]
}