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.

Every profession in FinkiOpenDesk has exactly one associated discussion thread — a community space where students can ask questions, share advice, and discuss the career path. This page documents how to retrieve that discussion thread and how to fetch the list of subjects linked to a profession, which is the data that populates the career roadmap view in the application.

GET /api/professions/pid/{professionId}

Returns the ProfessionDiscussionDto for the profession identified by professionId. This is distinct from the profession list endpoint (GET /api/professions) and is the canonical way to load the discussion thread along with its full comment history.
This endpoint is public. No authentication is required to read profession discussions.

Path parameters

professionId
string
required
The unique identifier of the profession whose discussion thread you want to retrieve.

Response

A single ProfessionDiscussionDto object.
professionDiscussionId
string
required
Unique identifier for this discussion thread.
name
string
required
Title of the discussion thread.
description
string
Introductory description of the discussion thread.
comments
object[]
Ordered list of comments posted to this discussion thread.

Example

curl https://finkiopendesk.onrender.com/api/professions/pid/sw-engineer

GET /api/subjects/pid/{professionId}

Returns the list of subjects linked to a profession. This is the endpoint that populates the career roadmap — the subjects shown as a recommended learning path for students pursuing a particular career.
This endpoint is served from SubjectController under the /api/subjects path, not /api/professions. It is documented here because it is the primary companion call when rendering a profession’s career roadmap page.

Path parameters

professionId
string
required
The unique identifier of the profession whose linked subjects you want to retrieve.

Response

An array of SubjectDto objects. Returns an empty array if no subjects are linked to the profession.
subjectId
string
required
Unique identifier for the subject.
name
string
required
Subject name.
description
string
Description of the subject’s content and goals.
discussion
object
The discussion thread associated with this subject.
tags
object[]
Tags attached to this subject.

Example

curl https://finkiopendesk.onrender.com/api/subjects/pid/sw-engineer

Build docs developers (and LLMs) love