> For the complete documentation index, see [llms.txt](https://www.center.daxium-air.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://www.center.daxium-air.com/api-reference/submissions/comments.md).
# Comments
## Get comments for multiple submissions
> Returns comments for up to \*\*1000\*\* submission IDs in one request.
```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"tags":[{"name":"submission-comments"}],"servers":[{"url":"https://api.daxium-air.com","description":"Production"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer"}},"parameters":{"AppShort":{"name":"app_short","in":"path","required":true,"description":"Short name of the workspace instance (e.g. `daxium-test`)","schema":{"type":"string"}}},"schemas":{"Comment":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Comment identifier (UUID v4)"},"message":{"type":"string","maxLength":1000,"description":"Plain text only — no HTML or script tags"},"client_created_at":{"type":"integer","format":"int64","description":"Client-side creation timestamp (Unix timestamp)"},"client_updated_at":{"type":"integer","format":"int64","description":"Client-side update timestamp (Unix timestamp)"},"user_id":{"type":"integer"},"submission_id":{"type":"string","format":"uuid"},"replies":{"type":"array","description":"Second-level replies (thread depth is limited to 2)","items":{"$ref":"#/components/schemas/Comment"}}}},"ErrorResponse":{"type":"object","properties":{"code":{"type":"string","description":"Unique error code prefixed with `DAERR-`"},"message":{"type":"string"},"url":{"type":"string","format":"uri","description":"Link to the detailed error documentation"},"api_version":{"type":"string"},"infos":{"type":"array","items":{},"description":"Additional context (may be empty)"},"server_time":{"type":"string","description":"Unix timestamp as string"}}}}},"paths":{"/{app_short}/submissions/comments":{"post":{"summary":"Get comments for multiple submissions","description":"Returns comments for up to **1000** submission IDs in one request.\n","tags":["submission-comments"],"operationId":"getCommentsBySubmissionIds","parameters":[{"$ref":"#/components/parameters/AppShort"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["submission_ids"],"properties":{"submission_ids":{"type":"array","maxItems":1000,"items":{"type":"string","format":"uuid"}}}}}}},"responses":{"200":{"description":"Comments grouped by submission UUID","content":{"application/json":{"schema":{"type":"object","additionalProperties":{"type":"array","items":{"$ref":"#/components/schemas/Comment"}}}}}},"400":{"description":"Too many submission IDs — max 1000 (DAERR-COM1010)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```
## Count comments on a submission
> Returns the total number of comments linked to a submission.
```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"tags":[{"name":"submission-comments"}],"servers":[{"url":"https://api.daxium-air.com","description":"Production"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer"}},"parameters":{"AppShort":{"name":"app_short","in":"path","required":true,"description":"Short name of the workspace instance (e.g. `daxium-test`)","schema":{"type":"string"}}}},"paths":{"/{app_short}/submissions/{id}/comments/count":{"get":{"summary":"Count comments on a submission","description":"Returns the total number of comments linked to a submission.","tags":["submission-comments"],"operationId":"countSubmissionComments","parameters":[{"$ref":"#/components/parameters/AppShort"},{"name":"id","in":"path","required":true,"description":"Submission identifier (UUID)","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Total number of comments","content":{"application/json":{"schema":{"type":"object","properties":{"count":{"type":"integer","description":"Total number of comments linked to the submission"}}}}}}}}}}}
```
## GET /{app\_short}/submissions/{id}/comments
> List comments on a submission
```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"tags":[{"name":"submission-comments"}],"servers":[{"url":"https://api.daxium-air.com","description":"Production"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer"}},"parameters":{"AppShort":{"name":"app_short","in":"path","required":true,"description":"Short name of the workspace instance (e.g. `daxium-test`)","schema":{"type":"string"}}},"schemas":{"Comment":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Comment identifier (UUID v4)"},"message":{"type":"string","maxLength":1000,"description":"Plain text only — no HTML or script tags"},"client_created_at":{"type":"integer","format":"int64","description":"Client-side creation timestamp (Unix timestamp)"},"client_updated_at":{"type":"integer","format":"int64","description":"Client-side update timestamp (Unix timestamp)"},"user_id":{"type":"integer"},"submission_id":{"type":"string","format":"uuid"},"replies":{"type":"array","description":"Second-level replies (thread depth is limited to 2)","items":{"$ref":"#/components/schemas/Comment"}}}},"ErrorResponse":{"type":"object","properties":{"code":{"type":"string","description":"Unique error code prefixed with `DAERR-`"},"message":{"type":"string"},"url":{"type":"string","format":"uri","description":"Link to the detailed error documentation"},"api_version":{"type":"string"},"infos":{"type":"array","items":{},"description":"Additional context (may be empty)"},"server_time":{"type":"string","description":"Unix timestamp as string"}}}}},"paths":{"/{app_short}/submissions/{id}/comments":{"get":{"summary":"List comments on a submission","tags":["submission-comments"],"operationId":"listSubmissionComments","parameters":[{"$ref":"#/components/parameters/AppShort"},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"List of comments (including replies)","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Comment"}}}}},"403":{"description":"Access to submission forbidden (DAERR-COM1000)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Submission not found (DAERR-COM1006)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```
## Create a comment on a submission
> Adds a new comment. Plain text only — no HTML or script content.\
> Maximum \*\*1000 characters\*\*. Supports an optional client-supplied UUID.
```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"tags":[{"name":"submission-comments"}],"servers":[{"url":"https://api.daxium-air.com","description":"Production"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer"}},"parameters":{"AppShort":{"name":"app_short","in":"path","required":true,"description":"Short name of the workspace instance (e.g. `daxium-test`)","schema":{"type":"string"}}},"schemas":{"CommentInput":{"type":"object","required":["message"],"properties":{"id":{"type":"string","format":"uuid","description":"Optional client-supplied UUID v4"},"message":{"type":"string","maxLength":1000,"description":"Plain text only — no HTML, script tags, or dangerous characters"},"client_created_at":{"type":"integer","format":"int64","description":"Unix timestamp"},"client_updated_at":{"type":"integer","format":"int64","description":"Unix timestamp"}}},"Comment":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Comment identifier (UUID v4)"},"message":{"type":"string","maxLength":1000,"description":"Plain text only — no HTML or script tags"},"client_created_at":{"type":"integer","format":"int64","description":"Client-side creation timestamp (Unix timestamp)"},"client_updated_at":{"type":"integer","format":"int64","description":"Client-side update timestamp (Unix timestamp)"},"user_id":{"type":"integer"},"submission_id":{"type":"string","format":"uuid"},"replies":{"type":"array","description":"Second-level replies (thread depth is limited to 2)","items":{"$ref":"#/components/schemas/Comment"}}}},"ErrorResponse":{"type":"object","properties":{"code":{"type":"string","description":"Unique error code prefixed with `DAERR-`"},"message":{"type":"string"},"url":{"type":"string","format":"uri","description":"Link to the detailed error documentation"},"api_version":{"type":"string"},"infos":{"type":"array","items":{},"description":"Additional context (may be empty)"},"server_time":{"type":"string","description":"Unix timestamp as string"}}}}},"paths":{"/{app_short}/submissions/{id}/comments":{"post":{"summary":"Create a comment on a submission","description":"Adds a new comment. Plain text only — no HTML or script content.\nMaximum **1000 characters**. Supports an optional client-supplied UUID.\n","tags":["submission-comments"],"operationId":"createSubmissionComment","parameters":[{"$ref":"#/components/parameters/AppShort"},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommentInput"}}}},"responses":{"200":{"description":"Comment created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Comment"}}}},"400":{"description":"Validation error — missing message (DAERR-COM1002), too long\n(DAERR-COM1003), invalid date (DAERR-COM1004), invalid characters\n(DAERR-COM1005), invalid UUID (DAERR-COM1009), or comment limit\nreached (DAERR-COM1012)\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Access forbidden (DAERR-COM1000)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```
## Update a comment
> Updates the text of a comment. Users can only update their own comments (DAERR-COM1008).
```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"tags":[{"name":"submission-comments"}],"servers":[{"url":"https://api.daxium-air.com","description":"Production"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer"}},"parameters":{"AppShort":{"name":"app_short","in":"path","required":true,"description":"Short name of the workspace instance (e.g. `daxium-test`)","schema":{"type":"string"}}},"schemas":{"CommentInput":{"type":"object","required":["message"],"properties":{"id":{"type":"string","format":"uuid","description":"Optional client-supplied UUID v4"},"message":{"type":"string","maxLength":1000,"description":"Plain text only — no HTML, script tags, or dangerous characters"},"client_created_at":{"type":"integer","format":"int64","description":"Unix timestamp"},"client_updated_at":{"type":"integer","format":"int64","description":"Unix timestamp"}}},"Comment":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Comment identifier (UUID v4)"},"message":{"type":"string","maxLength":1000,"description":"Plain text only — no HTML or script tags"},"client_created_at":{"type":"integer","format":"int64","description":"Client-side creation timestamp (Unix timestamp)"},"client_updated_at":{"type":"integer","format":"int64","description":"Client-side update timestamp (Unix timestamp)"},"user_id":{"type":"integer"},"submission_id":{"type":"string","format":"uuid"},"replies":{"type":"array","description":"Second-level replies (thread depth is limited to 2)","items":{"$ref":"#/components/schemas/Comment"}}}},"ErrorResponse":{"type":"object","properties":{"code":{"type":"string","description":"Unique error code prefixed with `DAERR-`"},"message":{"type":"string"},"url":{"type":"string","format":"uri","description":"Link to the detailed error documentation"},"api_version":{"type":"string"},"infos":{"type":"array","items":{},"description":"Additional context (may be empty)"},"server_time":{"type":"string","description":"Unix timestamp as string"}}}}},"paths":{"/{app_short}/submissions/{id}/comments/{comment_id}":{"put":{"summary":"Update a comment","description":"Updates the text of a comment. Users can only update their own comments (DAERR-COM1008).","tags":["submission-comments"],"operationId":"updateSubmissionComment","parameters":[{"$ref":"#/components/parameters/AppShort"},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"comment_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommentInput"}}}},"responses":{"200":{"description":"Comment updated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Comment"}}}},"403":{"description":"Not allowed to update this comment (DAERR-COM1008)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Comment not found (DAERR-COM1001)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```
## Delete a comment
> Deletes a comment. Users can only delete their own comments (DAERR-COM1007).
```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"tags":[{"name":"submission-comments"}],"servers":[{"url":"https://api.daxium-air.com","description":"Production"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer"}},"parameters":{"AppShort":{"name":"app_short","in":"path","required":true,"description":"Short name of the workspace instance (e.g. `daxium-test`)","schema":{"type":"string"}}},"schemas":{"ErrorResponse":{"type":"object","properties":{"code":{"type":"string","description":"Unique error code prefixed with `DAERR-`"},"message":{"type":"string"},"url":{"type":"string","format":"uri","description":"Link to the detailed error documentation"},"api_version":{"type":"string"},"infos":{"type":"array","items":{},"description":"Additional context (may be empty)"},"server_time":{"type":"string","description":"Unix timestamp as string"}}}}},"paths":{"/{app_short}/submissions/{id}/comments/{comment_id}":{"delete":{"summary":"Delete a comment","description":"Deletes a comment. Users can only delete their own comments (DAERR-COM1007).","tags":["submission-comments"],"operationId":"deleteSubmissionComment","parameters":[{"$ref":"#/components/parameters/AppShort"},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"comment_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"204":{"description":"Comment deleted"},"403":{"description":"Not allowed to delete this comment (DAERR-COM1007)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Comment not found (DAERR-COM1001)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```
## Reply to a comment
> Adds a reply to a first-level comment (max thread depth is 2).\
> Replying to a reply is not allowed (DAERR-COM1011).
```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"tags":[{"name":"submission-comments"}],"servers":[{"url":"https://api.daxium-air.com","description":"Production"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer"}},"parameters":{"AppShort":{"name":"app_short","in":"path","required":true,"description":"Short name of the workspace instance (e.g. `daxium-test`)","schema":{"type":"string"}}},"schemas":{"CommentInput":{"type":"object","required":["message"],"properties":{"id":{"type":"string","format":"uuid","description":"Optional client-supplied UUID v4"},"message":{"type":"string","maxLength":1000,"description":"Plain text only — no HTML, script tags, or dangerous characters"},"client_created_at":{"type":"integer","format":"int64","description":"Unix timestamp"},"client_updated_at":{"type":"integer","format":"int64","description":"Unix timestamp"}}},"Comment":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Comment identifier (UUID v4)"},"message":{"type":"string","maxLength":1000,"description":"Plain text only — no HTML or script tags"},"client_created_at":{"type":"integer","format":"int64","description":"Client-side creation timestamp (Unix timestamp)"},"client_updated_at":{"type":"integer","format":"int64","description":"Client-side update timestamp (Unix timestamp)"},"user_id":{"type":"integer"},"submission_id":{"type":"string","format":"uuid"},"replies":{"type":"array","description":"Second-level replies (thread depth is limited to 2)","items":{"$ref":"#/components/schemas/Comment"}}}},"ErrorResponse":{"type":"object","properties":{"code":{"type":"string","description":"Unique error code prefixed with `DAERR-`"},"message":{"type":"string"},"url":{"type":"string","format":"uri","description":"Link to the detailed error documentation"},"api_version":{"type":"string"},"infos":{"type":"array","items":{},"description":"Additional context (may be empty)"},"server_time":{"type":"string","description":"Unix timestamp as string"}}}}},"paths":{"/{app_short}/submissions/{id}/comments/{comment_id}/replies":{"post":{"summary":"Reply to a comment","description":"Adds a reply to a first-level comment (max thread depth is 2).\nReplying to a reply is not allowed (DAERR-COM1011).\n","tags":["submission-comments"],"operationId":"replyToSubmissionComment","parameters":[{"$ref":"#/components/parameters/AppShort"},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"comment_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommentInput"}}}},"responses":{"200":{"description":"Reply created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Comment"}}}},"403":{"description":"Cannot reply to a second-level comment (DAERR-COM1011)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://www.center.daxium-air.com/api-reference/submissions/comments.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.