Skip to main content
System StatusContact Support
VersionOne Community

Update an Asset

Updating assets involves sending HTTP POST requests to rest-1.v1/Data with an XML payload.

Getting Started

Update a Simple Attribute

Updating a value type on an asset is accomplished by marking the attribute with act="set", and filling in the new value in the element's text. The following updates the Phone attribute.

POST /VersionOne/rest-1.v1/Data/Member/20 HTTP/1.1
Content-Type: application/xml

<Asset>
<Attribute name="Phone" act="set">555-555-1212</Attribute>
</Asset>

The response will be similar to the following.

<Asset href="/VersionOne/rest-1.v1/Data/Member/20/173" id="Member:20:173">
    <Attribute name="Phone">555-555-1212</Attribute>
</Asset>

Update a Single-Value Relationship

Updating a single-value relationship on an asset is accomplished by marking the attribute with act="set", and filling in the idref of the enclosed Asset element with the referenced OID Token. The following changes the Owner of the root project.

POST /VersionOne/rest-1.v1/Data/Scope/0 HTTP/1.1
Content-Type: application/xml

<Asset>
<Relation name="Owner" act="set">
<Asset idref="Member:20" />
</Relation>
</Asset>

Conversely, the way to unset a single-value relationship is to simply pass an empty element. The following changes the Owner to nobody.

POST /VersionOne/rest-1.v1/Data/Scope/0 HTTP/1.1
Content-Type: application/xml

<Asset>
<Relation name="Owner" act="set">
</Relation>
</Asset>

Update a Multi-Value Relationship

Updating a multi-value relationship on an asset is accomplished by marking enclosed Asset elements with act="add" or act="remove", and filling in the idref of the enclosed Asset element with the referenced OID Token. The following adds one Member and removes another Member from the root project.

POST /VersionOne/rest-1.v1/Data/Scope/0 HTTP/1.1
Content-Type: application/xml

<Asset>
<Relation name="Members">
<Asset idref="Member:1000" act="add"/>
<Asset idref="Member:1001" act="remove"/>
</Relation>
</Asset>
  • Was this article helpful?