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.

Code examples

Replace <entity-id> with the ID of the Entities. Replace <target-id> with the ID of the new parent. Replace <your-token> with a valid API token.

Assign a feature to a different component:

curl -X PUT "https://api.productboard.com/v2/entities/<entity-id>/relationships/parent" \
  -H "Authorization: Bearer <your-token>" \
  -H "Content-Type: application/json" \
  -d '{
    "data": {
      "target": { "id": "<target-id>" }
    }
  }'

Move a subfeature to a new parent feature:

curl -X PUT "https://api.productboard.com/v2/entities/<entity-id>/relationships/parent" \
  -H "Authorization: Bearer <your-token>" \
  -H "Content-Type: application/json" \
  -d '{
    "data": {
      "target": { "id": "<target-id>" }
    }
  }'