Launch a space (create a join link)
lessonspace_launch_spaceDestructive
WRITE: create a space, or reuse the one with the same id, and get a join link (client_url) for one participant. The link is a live credential for a real person: share it only with that person and never post it elsewhere. Calling again with the same id reuses the space but issues a new link; it is not safe to repeat blindly. Lessonspace's own secret is never returned. POST /spaces/launch/.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Your id for the space. The same id returns the same space; a new id creates a new space. | |
| name | No | Display name of the space (defaults to the id). | |
| user | No | The participant this link is for. | |
| locale | No | Interface language. | |
| server | No | Region of the space. If omitted, Lessonspace picks it from the IP location of this server, which is near the AI platform and not near the participant. When the user's region matters, pass the `region` of an existing space from lessonspace_list_spaces. | |
| not_after | No | The link stops working at this time (default and maximum: 7 days after not_before, or after now). | |
| record_av | No | Record audio and video. | |
| summarise | No | Create an AI lesson summary. | |
| not_before | No | The link works from this time (default: now). | |
| space_tags | No | Tags put on the space. | |
| transcribe | No | Transcribe the session (needed for lessonspace_get_session_transcript). | |
| allow_guests | No | Let people without an invitation join (Lessonspace default true). | |
| session_tags | No | Tags put on the session (for filtering later). | |
| record_content | No | Record the whiteboard and documents (defaults to record_av). | |
| video_layout_mode | No |