> ## Documentation Index > Fetch the complete documentation index at: https://docs.plazza.ca/llms.txt > Use this file to discover all available pages before exploring further. # Get a roadmap comment ## OpenAPI ````yaml /openapi/backend.json get /v1/roadmapBoards/{board}/items/{item}/comments/{comment} openapi: 3.0.0 info: title: Plazza API description: >- The Plazza REST API. Errors follow AIP-193 and carry a message in the language of Accept-Language, French or English. version: v1 servers: - url: https://api.plazza.ca security: - bearer: [] paths: /v1/roadmapBoards/{board}/items/{item}/comments/{comment}: get: tags: - Roadmap summary: Get a roadmap comment operationId: RoadmapComments.get parameters: - name: board required: true in: path description: 'The board: `hire` for employers, `talents` for job seekers.' schema: type: string enum: - hire - talents description: 'The board: `hire` for employers, `talents` for job seekers.' example: hire - name: item required: true in: path description: The item's id. schema: type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ description: The item's id. example: 019a7c2e-4b1d-7c3a-9d4e-5f6a7b8c9d0e - name: comment required: true in: path description: The comment's id. schema: type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ description: The comment's id. example: 019a7c31-0e2f-7a1b-8c3d-4e5f6a7b8c9d responses: '200': description: >- A comment on a roadmap item, or a reply to one. Threads are one level deep. content: application/json: schema: $ref: '#/components/schemas/RoadmapComment' default: description: An AIP-193 error. content: application/json: schema: $ref: '#/components/schemas/Error' security: [] components: schemas: RoadmapComment: type: object properties: name: type: string description: The comment's resource name. example: >- roadmapBoards/hire/items/019a7c2e-4b1d-7c3a-9d4e-5f6a7b8c9d0e/comments/019a7c31-0e2f-7a1b-8c3d-4e5f6a7b8c9d parent: nullable: true description: The top-level comment it replies to. Null for a top-level comment. example: null type: string source: type: string enum: - PLAZZA - LINEAR description: '`LINEAR` for a reply the Plazza team wrote in Linear.' example: PLAZZA body: type: string description: The text, in Markdown. Empty once removed. example: We’d use this every week. author: nullable: true description: >- Who wrote it: a reply from Linear is the staff member’s. Null once removed. example: displayName: Camille Tremblay staff: false allOf: - $ref: '#/components/schemas/RoadmapAuthor' reactions: type: array items: type: object properties: emoji: type: string enum: - πŸ‘ - ❀️ - πŸŽ‰ - πŸ‘€ description: One of the four reactions. example: πŸ‘ count: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: How many people reacted so. example: 3 required: - emoji - count additionalProperties: false description: Reactions, by emoji. example: - emoji: πŸ‘ count: 3 replyCount: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: How many replies a top-level comment has, removed ones included. example: 2 etag: type: string description: 'AIP-154: send it back to change the comment.' example: '"1"' createTime: type: string format: date-time description: When it was written. example: '2026-11-05T09:12:44.031Z' updateTime: type: string format: date-time description: When it was last edited or removed. example: '2026-11-05T09:12:44.031Z' deleteTime: nullable: true type: string format: date-time description: 'AIP-164: when its author or staff removed it. Null otherwise.' example: '2026-11-05T09:12:44.031Z' required: - name - parent - source - body - author - reactions - replyCount - etag - createTime - updateTime - deleteTime additionalProperties: false description: >- A comment on a roadmap item, or a reply to one. Threads are one level deep. Error: type: object properties: error: type: object properties: code: type: integer minimum: -9007199254740991 maximum: 9007199254740991 message: type: string status: type: string enum: - INVALID_ARGUMENT - FAILED_PRECONDITION - OUT_OF_RANGE - UNAUTHENTICATED - PERMISSION_DENIED - NOT_FOUND - ABORTED - ALREADY_EXISTS - RESOURCE_EXHAUSTED - INTERNAL - UNIMPLEMENTED - UNAVAILABLE - DEADLINE_EXCEEDED details: type: array items: oneOf: - type: object properties: '@type': type: string enum: - type.googleapis.com/google.rpc.ErrorInfo reason: type: string domain: type: string metadata: type: object additionalProperties: type: string required: - '@type' - reason - domain additionalProperties: false - type: object properties: '@type': type: string enum: - type.googleapis.com/google.rpc.LocalizedMessage locale: type: string message: type: string required: - '@type' - locale - message additionalProperties: false - type: object properties: '@type': type: string enum: - type.googleapis.com/google.rpc.BadRequest fieldViolations: type: array items: type: object properties: field: type: string description: type: string required: - field - description additionalProperties: false required: - '@type' - fieldViolations additionalProperties: false - type: object properties: '@type': type: string enum: - type.googleapis.com/google.rpc.RetryInfo retryDelay: type: string pattern: ^\d+s$ required: - '@type' - retryDelay additionalProperties: false required: - code - message - status - details additionalProperties: false required: - error additionalProperties: false description: An AIP-193 error. example: error: code: 401 message: Unauthorized status: UNAUTHENTICATED details: - '@type': type.googleapis.com/google.rpc.ErrorInfo reason: MISSING_CREDENTIALS domain: api.plazza.ca - '@type': type.googleapis.com/google.rpc.LocalizedMessage locale: en message: Sign in to continue. RoadmapAuthor: type: object properties: displayName: nullable: true description: >- The name they chose for the roadmap. Null for a staff member who never chose one: show your team name. example: Camille Tremblay type: string staff: type: boolean description: Whether they work at Plazza. example: false required: - displayName - staff additionalProperties: false description: Who wrote something on the roadmap, as shown publicly. securitySchemes: bearer: scheme: bearer bearerFormat: JWT type: http description: >- The session token of a signed-in Plazza account, sent as `Authorization: Bearer `. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.