Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/Daniel-Stojanovski/finkiopendesk/llms.txt

Use this file to discover all available pages before exploring further.

These read endpoints return comments scoped to a specific subject or profession discussion. The server resolves the correct discussion ID internally — you supply the subject or profession ID from your data model, not the raw discussion ID. All three endpoints are publicly accessible without authentication.

​
GET /api/comments/sid/

Returns all comments belonging to the discussion of the given subject.

​
Path parameters

​
subjectId
string
required
The unique identifier of the subject. The server looks up the subject’s linked discussion and returns its comments.

​
Response

Returns an array of CommentDto objects.
​
commentId
string
required
Auto-generated UUID for the comment.
​
type
string
required
Semantic classification of the comment. One of:
  • COMMENT — a general remark
  • REPLY — a direct reply to another comment (see parentId)
  • QUESTION — a question directed at other participants
  • IMPORTANT — flagged as important by the author
​
content
string
required
The full text body of the comment.
​
subjectId
string
ID of the subject whose discussion this comment belongs to. null if the comment is in a profession discussion or channel.
​
professionId
string
ID of the profession whose discussion this comment belongs to. null for subject discussion comments.
​
channelId
string
ID of the channel this comment belongs to. null for discussion comments.
​
parentId
string
ID of the parent comment when type is REPLY. null for top-level comments.
​
user
object
required
The author of the comment.
curl https://finkiopendesk.onrender.com/api/comments/sid/subject-abc123

​
GET /api/comments/pid/

Returns all comments belonging to the discussion of the given profession.

​
Path parameters

​
professionId
string
required
The unique identifier of the profession. The server looks up the profession’s linked discussion and returns its comments.

​
Response

An array of CommentDto objects — same schema as described above. Comments in a profession discussion will have professionId populated and subjectId set to null. 
curl https://finkiopendesk.onrender.com/api/comments/pid/profession-42

​
GET /api/comments

Returns every comment stored in the platform across all discussions and channels.
This endpoint is intended for administrative use. It returns unbounded data and may be slow for large datasets. Prefer the subject or profession scoped endpoints for production UI use.

​
Response

An array of all CommentDto objects — same schema as described above. 
curl https://finkiopendesk.onrender.com/api/comments

Build docs developers (and LLMs) love

Get started for freeTalk to us