Add comment to pin

Adds a new comment to an existing pin.

• Anonymous users: Must provide authorName and optionally authorEmail

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

  Path Parameters

  Parameter	Type	Required	Description
  pinUuid	string (UUID)	Yes	Pin unique identifier

  Body Fields

  Field	Type	Required	Description
  content	string	Yes	Comment content
  authorName	string	No*	Name of the author (*required if anonymous)
  authorEmail	string	No	Email of the author

  Response Fields

  Field	Type	Description
  uuid	string	Comment unique identifier
  content	string	Comment text
  authorName	string	Author name
  authorEmail	string	Author email
  author	object/null	User object if authenticated
  createdAt	datetime	Creation timestamp

  Response

  • 201 Created: Comment successfully created
  • 400 Bad Request: Missing content field
  • 404 Not Found: Pin not found