create.yaml 1.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142
  1. operationId: sessionCreate
  2. summary: Create
  3. security:
  4. - UserAuth: [tokens]
  5. description: Create a new session. Will also be the first turn to set the scene.
  6. tags: [Session]
  7. parameters:
  8. - name: game_id
  9. in: path
  10. description: Game ID
  11. required: true
  12. schema:
  13. type: string
  14. format: uuid
  15. example: 019eb91d-9820-7624-b22b-4e2423b1942b
  16. responses:
  17. "200":
  18. description: Session started
  19. content:
  20. application/json:
  21. schema:
  22. type: object
  23. properties:
  24. session:
  25. $ref: "#/components/schemas/Session"
  26. turn:
  27. $ref: "#/components/schemas/Turn"
  28. tokens_remaining:
  29. type: number
  30. description: Tokens that the user has remaining
  31. example: 998060
  32. "400":
  33. $ref: "#/components/responses/400"
  34. "401":
  35. $ref: "#/components/responses/401"
  36. "403":
  37. $ref: "#/components/responses/403"
  38. "404":
  39. $ref: "#/components/responses/404"
  40. "500":
  41. $ref: "#/components/responses/500"