v1

latestOpenAPI 3.1.1Productboard Proprietary2026-07-2453178243.2 KB
entities

Set parent relationship

Replaces the parent of a specific Entities.
Some entity types (such as features and subfeatures) are required to have a parent.
This endpoint allows you to update the parent entity when the relationship changes.

The new parent is specified in the request body using the target.id field.

Limitations

  • Only valid parent relationships are allowed (e.g. feature → component, subfeature → feature).
  • The target entity must exist and be a valid parent type.
  • This will overwrite any existing parent relationship.
put/entities/{id}/relationships/parent

Path parameters

idstring uuid required

A universally unique identifier (UUID).

Example:123e4567-e89b-12d3-a456-426614174000

Entity identifier.

Request body

Example request

{
  "data": {
    "target": {
      "id": "123e4567-e89b-12d3-a456-426614174000"
    }
  }
}

Response

Relationship updated successfully

Example response

{
  "data": {
    "target": {
      "id": "123e4567-e89b-12d3-a456-426614174000"
    }
  }
}