Retrieve relationships

Retrieves all relationships connected to a specific note.

This includes:

  • Customer relationship (either a User or Company entity)
  • Product hierarchy relationships (e.g. linked features, initiatives)

Customer relationship rules

  • A note can have a relationship to exactly one customer entity (User or Company).
  • If the note has a User as the customer, and that User is associated with a Company, only the User is returned.
  • If the note has a User without a Company, the User is returned.
  • If the note has a Company, the Company is returned.
  • If the note has no customer relationship, an empty array is returned.

Product hierarchy item relationships

  • Notes can be linked to multiple Product Management entities (e.g. features, components).
  • All such relationships are returned in the same response.

To discover supported relationship types, use the /v2/notes/configuration endpoint.

Code examples

  • Replace <note-id> with the ID of the note you want to inspect.
  • Replace <your-token> with a valid API token.

List all entities linked to a note:

curl -X GET "https://api.productboard.com/v2/notes/<note-id>/relationships" \
  -H "Authorization: Bearer <your-token>"
Language
Credentials
Header
Click Try It! to start a request and see the response here!