learnhouse-agent/skills/playgrounds/SKILL.md

name, description

name	description
playgrounds-routes	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.

iterate_playground_session_api_v1_playgrounds_generat_fa5ceb5c12

• 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_105a9dd82d

• 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

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.

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_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_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_duplicate_playground_api_v1_playgrounds_playgroun_da97e869e2

• 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_get_playground_reactions_api_v1_playgrounds_playg_a355ed4ba4

• 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_pla_9e9d2434c0

• 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.

api_update_playground_thumbnail_api_v1_playgrounds_pl_f479a3908f

• 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_get_playground_usergroups_api_v1_playgrounds_play_59ff5be511

• 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_remove_usergroup_from_playground_api_v1_playgroun_f515e2a2bf

• 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_add_usergroup_to_playground_api_v1_playgrounds_pl_f7e126f3af

• 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