v1

latestOpenAPI 3.1.1Productboard Proprietary2026-07-2453178243.2 KB
notes

Create relationship

Creates a new relationship between a note and another entity.

You can link a note to:

  • A Product Management entity (e.g. feature, component, initiative)
  • A customer entity (company or user)

This is useful for capturing customer feedback and tying it to the right product link, or for attributing a note to a specific customer.

Notes can have one customer relationship and multiple product link relationships. If a Customer relationship already exists (user or company), this endpoint returns a validation error. Use PUT /v2/notes/{id}/relationships/customer to replace an existing Customer relationship.

post/notes/{id}/relationships

Path parameters

idstring uuid required

Note identifier.

Request body

Example request

{
  "data": {
    "target": {
      "type": "user"
    }
  }
}

Response

Relationship created successfully

Example response

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