Create pin

Creates a new pin with a first comment on a quotation.

• Anonymous users: Must provide authorName and optionally authorEmail

  • Authenticated users: Author info is automatically set from user profile (can add X-API-KEY header)

  Body Fields

  Field	Type	Required	Description
  quotationUuid	string (UUID)	Yes	Target quotation identifier
  content	string	Yes	First comment content
  authorName	string	No*	Name of the author (*required if anonymous)
  authorEmail	string	No	Email of the author
  offsetX	float	No	Horizontal position of the pin
  offsetY	float	No	Vertical position of the pin
  zoneId	string	No	Zone identifier where the pin is placed

  Response Fields

  Field	Type	Description
  uuid	string	Pin unique identifier
  offsetX	float	Horizontal position
  offsetY	float	Vertical position
  zoneId	string	Zone identifier
  comments	array	Comments (includes first comment)
  comments[].uuid	string	Comment unique identifier
  comments[].content	string	Comment text
  comments[].authorName	string	Author name
  comments[].author	object/null	User object if authenticated
  comments[].createdAt	datetime	Comment creation timestamp
  createdAt	datetime	Pin creation timestamp

  Response

  • 201 Created: Pin and comment successfully created
  • 400 Bad Request: Missing required fields
  • 404 Not Found: Quotation not found