deploy

skills/discussions/SKILL.md

@@ -0,0 +1,144 @@
+---
+name: discussions-routes
+description: Handle 14 OpenAPI operation(s) under /api/v1/discussions for the discussions route group.
+---
+
+# discussions API Routes
+
+Handle 14 OpenAPI operation(s) under /api/v1/discussions for the discussions route group.
+
+Use the generated operation tools to make real API calls. Do not invent API responses.
+If a tool reports missing setup, return the exact setup field name to the caller.
+For write, update, or delete operations, state the intended action before calling the tool.
+
+## Operations
+
+### api_get_discussion_labels_api_v1_discussions_labels_get
+
+- Operation ID: `api_get_discussion_labels_api_v1_discussions_labels_get`
+- Route: `GET /api/v1/discussions/labels`
+- Mode: READ
+- Summary: List discussion labels
+
+### api_get_discussion_api_v1_discussions_discussion_uuid_get
+
+- Operation ID: `api_get_discussion_api_v1_discussions_discussion_uuid_get`
+- Route: `GET /api/v1/discussions/{discussion_uuid}`
+- Mode: READ
+- Summary: Get a discussion
+- Parameters:
+  - `discussion_uuid` in `path` required
+
+### api_update_discussion_api_v1_discussions_discussion_uuid_put
+
+- Operation ID: `api_update_discussion_api_v1_discussions_discussion_uuid_put`
+- Route: `PUT /api/v1/discussions/{discussion_uuid}`
+- Mode: WRITE
+- Summary: Update a discussion
+- Parameters:
+  - `discussion_uuid` in `path` required
+- Body: JSON request body accepted.
+
+### api_delete_discussion_api_v1_discussions_discussion_uuid_delete
+
+- Operation ID: `api_delete_discussion_api_v1_discussions_discussion_uuid_delete`
+- Route: `DELETE /api/v1/discussions/{discussion_uuid}`
+- Mode: WRITE
+- Summary: Delete a discussion
+- Parameters:
+  - `discussion_uuid` in `path` required
+
+### api_pin_discussion_api_v1_discussions_discussion_uuid_pin_put
+
+- Operation ID: `api_pin_discussion_api_v1_discussions_discussion_uuid_pin_put`
+- Route: `PUT /api/v1/discussions/{discussion_uuid}/pin`
+- Mode: WRITE
+- Summary: Pin or unpin a discussion
+- Parameters:
+  - `discussion_uuid` in `path` required
+- Body: JSON request body accepted.
+
+### api_lock_discussion_api_v1_discussions_discussion_uuid_lock_put
+
+- Operation ID: `api_lock_discussion_api_v1_discussions_discussion_uuid_lock_put`
+- Route: `PUT /api/v1/discussions/{discussion_uuid}/lock`
+- Mode: WRITE
+- Summary: Lock or unlock a discussion
+- Parameters:
+  - `discussion_uuid` in `path` required
+- Body: JSON request body accepted.
+
+### api_upvote_discussion_api_v1_discussions_discussion_uuid_vote_post
+
+- Operation ID: `api_upvote_discussion_api_v1_discussions_discussion_uuid_vote_post`
+- Route: `POST /api/v1/discussions/{discussion_uuid}/vote`
+- Mode: WRITE
+- Summary: Upvote a discussion
+- Parameters:
+  - `discussion_uuid` in `path` required
+
+### api_remove_upvote_api_v1_discussions_discussion_uuid_vote_delete
+
+- Operation ID: `api_remove_upvote_api_v1_discussions_discussion_uuid_vote_delete`
+- Route: `DELETE /api/v1/discussions/{discussion_uuid}/vote`
+- Mode: WRITE
+- Summary: Remove an upvote from a discussion
+- Parameters:
+  - `discussion_uuid` in `path` required
+
+### api_get_user_votes_batch_api_v1_discussions_votes_batch_post
+
+- Operation ID: `api_get_user_votes_batch_api_v1_discussions_votes_batch_post`
+- Route: `POST /api/v1/discussions/votes/batch`
+- Mode: WRITE
+- Summary: Batch check user vote status
+- Body: JSON request body accepted.
+
+### api_create_comment_api_v1_discussions_discussion_uuid_comments_post
+
+- Operation ID: `api_create_comment_api_v1_discussions_discussion_uuid_comments_post`
+- Route: `POST /api/v1/discussions/{discussion_uuid}/comments`
+- Mode: WRITE
+- Summary: Create a comment
+- Parameters:
+  - `discussion_uuid` in `path` required
+- Body: JSON request body accepted.
+
+### api_get_comments_by_discussion_api_v1_discussions_discussion_uuid_comments_get
+
+- Operation ID: `api_get_comments_by_discussion_api_v1_discussions_discussion_uuid_comments_get`
+- Route: `GET /api/v1/discussions/{discussion_uuid}/comments`
+- Mode: READ
+- Summary: List comments for a discussion
+- Parameters:
+  - `discussion_uuid` in `path` required
+  - `page` in `query`
+  - `limit` in `query`
+
+### api_get_comment_count_api_v1_discussions_discussion_uuid_comments_count_get
+
+- Operation ID: `api_get_comment_count_api_v1_discussions_discussion_uuid_comments_count_get`
+- Route: `GET /api/v1/discussions/{discussion_uuid}/comments/count`
+- Mode: READ
+- Summary: Get comment count for a discussion
+- Parameters:
+  - `discussion_uuid` in `path` required
+
+### api_get_reactions_api_v1_discussions_discussion_uuid_reactions_get
+
+- Operation ID: `api_get_reactions_api_v1_discussions_discussion_uuid_reactions_get`
+- Route: `GET /api/v1/discussions/{discussion_uuid}/reactions`
+- Mode: READ
+- Summary: List reactions on a discussion
+- Parameters:
+  - `discussion_uuid` in `path` required
+
+### api_toggle_reaction_api_v1_discussions_discussion_uuid_reactions_post
+
+- Operation ID: `api_toggle_reaction_api_v1_discussions_discussion_uuid_reactions_post`
+- Route: `POST /api/v1/discussions/{discussion_uuid}/reactions`
+- Mode: WRITE
+- Summary: Toggle a reaction on a discussion
+- Parameters:
+  - `discussion_uuid` in `path` required
+- Body: JSON request body accepted.