deploy

skills/playgrounds/SKILL.md

@@ -0,0 +1,153 @@
+---
+name: playgrounds-routes
+description: Handle 15 OpenAPI operation(s) under /api/v1/playgrounds for the playgrounds route group.
+---
+
+# playgrounds API Routes
+
+Handle 15 OpenAPI operation(s) under /api/v1/playgrounds for the playgrounds 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_create_playground_api_v1_playgrounds_post
+
+- Operation ID: `api_create_playground_api_v1_playgrounds_post`
+- Route: `POST /api/v1/playgrounds/`
+- Mode: WRITE
+- Summary: Create a playground
+- Parameters:
+  - `org_id` in `query` required
+- Body: JSON request body accepted.
+
+### api_list_org_playgrounds_api_v1_playgrounds_org_org_id_get
+
+- Operation ID: `api_list_org_playgrounds_api_v1_playgrounds_org_org_id_get`
+- Route: `GET /api/v1/playgrounds/org/{org_id}`
+- Mode: READ
+- Summary: List playgrounds for an organization
+- Parameters:
+  - `org_id` in `path` required
+
+### api_get_playground_api_v1_playgrounds_playground_uuid_get
+
+- Operation ID: `api_get_playground_api_v1_playgrounds_playground_uuid_get`
+- Route: `GET /api/v1/playgrounds/{playground_uuid}`
+- Mode: READ
+- Summary: Get a playground by UUID
+- Parameters:
+  - `playground_uuid` in `path` required
+
+### api_update_playground_api_v1_playgrounds_playground_uuid_put
+
+- Operation ID: `api_update_playground_api_v1_playgrounds_playground_uuid_put`
+- Route: `PUT /api/v1/playgrounds/{playground_uuid}`
+- Mode: WRITE
+- Summary: Update a playground
+- Parameters:
+  - `playground_uuid` in `path` required
+- Body: JSON request body accepted.
+
+### api_delete_playground_api_v1_playgrounds_playground_uuid_delete
+
+- Operation ID: `api_delete_playground_api_v1_playgrounds_playground_uuid_delete`
+- Route: `DELETE /api/v1/playgrounds/{playground_uuid}`
+- Mode: WRITE
+- Summary: Delete a playground
+- Parameters:
+  - `playground_uuid` in `path` required
+
+### api_duplicate_playground_api_v1_playgrounds_playground_uuid_duplicate_post
+
+- Operation ID: `api_duplicate_playground_api_v1_playgrounds_playground_uuid_duplicate_post`
+- Route: `POST /api/v1/playgrounds/{playground_uuid}/duplicate`
+- Mode: WRITE
+- Summary: Duplicate a playground
+- Parameters:
+  - `playground_uuid` in `path` required
+
+### api_update_playground_thumbnail_api_v1_playgrounds_playground_uuid_thumbnail_pos
+
+- Operation ID: `api_update_playground_thumbnail_api_v1_playgrounds_playground_uuid_thumbnail_pos`
+- Route: `POST /api/v1/playgrounds/{playground_uuid}/thumbnail`
+- Mode: WRITE
+- Summary: Upload a playground thumbnail
+- Parameters:
+  - `playground_uuid` in `path` required
+- Body: JSON request body accepted.
+
+### api_add_usergroup_to_playground_api_v1_playgrounds_playground_uuid_usergroups_us
+
+- Operation ID: `api_add_usergroup_to_playground_api_v1_playgrounds_playground_uuid_usergroups_us`
+- Route: `POST /api/v1/playgrounds/{playground_uuid}/usergroups/{usergroup_uuid}`
+- Mode: WRITE
+- Summary: Grant a usergroup access to a playground
+- Parameters:
+  - `playground_uuid` in `path` required
+  - `usergroup_uuid` in `path` required
+
+### api_remove_usergroup_from_playground_api_v1_playgrounds_playground_uuid_usergrou
+
+- Operation ID: `api_remove_usergroup_from_playground_api_v1_playgrounds_playground_uuid_usergrou`
+- Route: `DELETE /api/v1/playgrounds/{playground_uuid}/usergroups/{usergroup_uuid}`
+- Mode: WRITE
+- Summary: Revoke a usergroup from a playground
+- Parameters:
+  - `playground_uuid` in `path` required
+  - `usergroup_uuid` in `path` required
+
+### api_get_playground_usergroups_api_v1_playgrounds_playground_uuid_usergroups_get
+
+- Operation ID: `api_get_playground_usergroups_api_v1_playgrounds_playground_uuid_usergroups_get`
+- Route: `GET /api/v1/playgrounds/{playground_uuid}/usergroups`
+- Mode: READ
+- Summary: List usergroups attached to a playground
+- Parameters:
+  - `playground_uuid` in `path` required
+
+### api_get_playground_reactions_api_v1_playgrounds_playground_uuid_reactions_get
+
+- Operation ID: `api_get_playground_reactions_api_v1_playgrounds_playground_uuid_reactions_get`
+- Route: `GET /api/v1/playgrounds/{playground_uuid}/reactions`
+- Mode: READ
+- Summary: List reactions on a playground
+- Parameters:
+  - `playground_uuid` in `path` required
+
+### api_toggle_playground_reaction_api_v1_playgrounds_playground_uuid_reactions_post
+
+- Operation ID: `api_toggle_playground_reaction_api_v1_playgrounds_playground_uuid_reactions_post`
+- Route: `POST /api/v1/playgrounds/{playground_uuid}/reactions`
+- Mode: WRITE
+- Summary: Toggle a reaction on a playground
+- Parameters:
+  - `playground_uuid` in `path` required
+- Body: JSON request body accepted.
+
+### start_playground_session_api_v1_playgrounds_generate_start_post
+
+- Operation ID: `start_playground_session_api_v1_playgrounds_generate_start_post`
+- Route: `POST /api/v1/playgrounds/generate/start`
+- Mode: WRITE
+- Summary: Start a playground generation session
+- Body: JSON request body accepted.
+
+### iterate_playground_session_api_v1_playgrounds_generate_iterate_post
+
+- Operation ID: `iterate_playground_session_api_v1_playgrounds_generate_iterate_post`
+- Route: `POST /api/v1/playgrounds/generate/iterate`
+- Mode: WRITE
+- Summary: Iterate on a playground generation session
+- Body: JSON request body accepted.
+
+### get_session_state_api_v1_playgrounds_generate_session_session_uuid_get
+
+- Operation ID: `get_session_state_api_v1_playgrounds_generate_session_session_uuid_get`
+- Route: `GET /api/v1/playgrounds/generate/session/{session_uuid}`
+- Mode: READ
+- Summary: Get playground generation session state
+- Parameters:
+  - `session_uuid` in `path` required