Create a revision

POST

/parts/{id}/revisions

curl --request POST \
  --url https://app.buildtrace.eu/api/parts/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/revisions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "label": "example", "copyFromRevisionId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0" }'

Required scope: revisions:write.

Authorizations

• bearerAuth

Parameters

Path Parameters

id

required

string format: uuid

Request Body^required

Media typeapplication/json

object

label

required

string

copyFromRevisionId

Optional. When set, the new revision is created as DRAFT with the source revision’s BOM lines, work instructions and final test plan cloned into it (verbatim; ECOs are not folded). The source must be a revision of the same part. Omit to create an empty revision.

string format: uuid

Example ^generated

{
  "label": "example",
  "copyFromRevisionId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0"
}

Responses

201

Created

Media typeapplication/json

object

id

required

string format: uuid

partId

required

string format: uuid

label

required

string

status

required

string

releasedAt

string format: date-time

Example ^generated

{
  "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
  "partId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
  "label": "example",
  "status": "example",
  "releasedAt": "2026-04-15T12:00:00Z"
}

400

Bad request

Media typeapplication/json

object

error

required

string

Example ^generated

{
  "error": "example"
}

401

Unauthorized

404

Not found

409

A revision with this label already exists on the part, or a line of the copied revision pins a revision of another part

Media typeapplication/json

object

error

required

string

Example ^generated

{
  "error": "example"
}