Back to Aligni.com

Release a part revision.

In XML request revision_name and revision_description are optional. Set them only if you want to modify name and description.

For inventory_units you can specify either 'keep' or 'dispose' for action to be taken on particular inventory_unit with an optional comment in case of 'dispose'. inventory_units that are not explicitly specified in the request will be automatically marked as 'keep'.

For part_ancestors you can specify either 'up' (up revision) or 'keep' for action to be taken on particular part_ancestor. part_ancestors that are not explicitly specified in the request will be automatically marked as 'up'.

Examples

# request
curl -X POST -H 'Accept: application/xml' -H 'Content-Type: application/xml' -d "
<part_revision>
  <revision_name>B</revision_name>
  <revision_description>Rev B has some improvements</revision_description>
  <inventory_units>
    <inventory_unit>
      <id>52</id>
      <action>dispose</action>
      <disposition_comment>Reason for dispose</disposition_comment>
    </inventory_unit>
  </inventory_units>
  <part_ancestors>
    <part_ancestor>
      <id>25</id>
      <action>keep</action>
    </part_ancestor>
    <part_ancestor>
      <id>143</id>
      <action>keep</action>
    </part_ancestor>
  </part_ancestors>
</part_revision>" \
https://demo.aligni.com/api/v2/oid3vLgynoy_Yl1gZkrgkLEq3J/parts/728/revisions/231/release

# no response
# request with bypass_part_ancestor_up_rev_guard when up-reving a part ancestor
curl -X POST -H 'Accept: application/xml' -H 'Content-Type: application/xml' -d "
<part_revision>
  <revision_name>BBC</revision_name>
  <revision_description>Rev B has some improvements</revision_description>
    <part_ancestors>
    <part_ancestor>
      <id>105</id>
      <action>up</action>
    </part_ancestor>
  </part_ancestors>
</part_revision>" \
https://demo.aligni.com/api/v2/oid3vLgynoy_Yl1gZkrgkLEq3J/parts/755/revisions/214/release?bypass_part_ancestor_up_rev_guard=true

# no response

Params

Param name Description
api_token
required

Your API token.


Value: Must be a String
id
required

ID of a revision to be released.


Value: Must be a number.
part_id
required

Release a revision belonging to this part.


Value: Must be a number.
bypass_part_ancestor_up_rev_guard
optional

If added to the URI it will allow up-rev of part ancestors.


Value: Must be a String