> ## Documentation Index > Fetch the complete documentation index at: https://docs.classquill.com/llms.txt > Use this file to discover all available pages before exploring further. # Create Session > Create a SCHEDULED session. Creates a `tutor_sessions` row with status='scheduled' and a participant whose per-hour rate snapshot is resolved server-side from the org rate matrix. No charge is initiated — settlement flows through the existing Stripe PaymentIntent + webhook, and the tutor-owed ledger row is written only on completion (see PUT /v1/sessions/{id}/complete). `organization_id`, `creator_id`, `status`, the rate snapshot, and timestamps are all server-set. `tutor_id`/`student_id` must be org-scoped (404 otherwise). The money-moving write runs inside a single transactional RPC. Requires the `sessions:write` scope. Honours `Idempotency-Key`. ## OpenAPI ````yaml /openapi.json post /v1/sessions openapi: 3.1.0 info: title: EquateIt Public API description: >- REST API for EquateIt tutoring organisations. Pipe your sessions, invoices, payments, tutor earnings, students, and more into your own tools. Most endpoints are reads; a focused set of writes (each gated by a *:write scope) create or update data, including creating student/tutor/parent accounts. Authenticate every request with an org API key: Authorization: Token token=ei_live_... Mint keys in the EquateIt app under Settings → Developers. version: 1.0.0 servers: [] security: - ApiKeyAuth: [] tags: - name: General - name: Sessions - name: Tutors - name: Students & Parents - name: Billing - name: Curriculum - name: Coursework - name: Operations - name: Pricing - name: Bookings - name: Blog - name: Reports paths: /v1/sessions: post: tags: - Sessions summary: Create Session description: >- Create a SCHEDULED session. Creates a `tutor_sessions` row with status='scheduled' and a participant whose per-hour rate snapshot is resolved server-side from the org rate matrix. No charge is initiated — settlement flows through the existing Stripe PaymentIntent + webhook, and the tutor-owed ledger row is written only on completion (see PUT /v1/sessions/{id}/complete). `organization_id`, `creator_id`, `status`, the rate snapshot, and timestamps are all server-set. `tutor_id`/`student_id` must be org-scoped (404 otherwise). The money-moving write runs inside a single transactional RPC. Requires the `sessions:write` scope. Honours `Idempotency-Key`. operationId: create_session_v1_sessions_post parameters: - name: Idempotency-Key in: header required: false schema: anyOf: - type: string - type: 'null' title: Idempotency-Key requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/SessionCreate' responses: '201': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/Session' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' components: schemas: SessionCreate: properties: tutor_id: type: string title: Tutor Id student_id: type: string title: Student Id math_level_id: type: string title: Math Level Id description: Subject identifier, e.g. 'methods_34' starts_at: type: string title: Starts At description: ISO 8601 timestamp ends_at: type: string title: Ends At description: ISO 8601 timestamp; must be after starts_at duration_minutes: type: integer title: Duration Minutes description: One of 30, 45, 60 (tutor_sessions CHECK) mode: type: string title: Mode description: online | in_person title: anyOf: - type: string - type: 'null' title: Title description: Optional; defaults server-side if omitted additionalProperties: false type: object required: - tutor_id - student_id - math_level_id - starts_at - ends_at - duration_minutes - mode title: SessionCreate description: >- POST /v1/sessions → tutor_sessions. Creates a SCHEDULED session only. No charge is initiated here (see public_writes_batch2.py — real charging stays in the existing Stripe PaymentIntent + webhook flow). `organization_id`, `creator_id`, `status` ('scheduled'), the per-hour rate snapshot (resolved from the org rate matrix onto the session's participant), and timestamps are ALL server-set. `tutor_id` / `student_id` must be org-scoped. `math_level_id` is the subject identifier (text, e.g. 'methods_34'). Session: properties: id: type: string title: Id status: anyOf: - type: string - type: 'null' title: Status title: anyOf: - type: string - type: 'null' title: Title tutor_id: anyOf: - type: string - type: 'null' title: Tutor Id student_id: anyOf: - type: string - type: 'null' title: Student Id starts_at: anyOf: - type: string - type: 'null' title: Starts At ends_at: anyOf: - type: string - type: 'null' title: Ends At duration_minutes: anyOf: - type: integer - type: 'null' title: Duration Minutes tutor_pay_rate_cents: anyOf: - type: integer - type: 'null' title: Tutor Pay Rate Cents student_rate_cents: anyOf: - type: integer - type: 'null' title: Student Rate Cents amount_owed_cents: anyOf: - type: integer - type: 'null' title: Amount Owed Cents mode: anyOf: - type: string - type: 'null' title: Mode subject_id: anyOf: - type: string - type: 'null' title: Subject Id created_at: anyOf: - type: string - type: 'null' title: Created At completed_at: anyOf: - type: string - type: 'null' title: Completed At type: object required: - id title: Session HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type type: object required: - loc - msg - type title: ValidationError securitySchemes: ApiKeyAuth: type: apiKey in: header name: Authorization description: Org API key as `Token token=ei_live_...` ````