> ## 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. # Update Tutor > Update an org tutor's profile fields. Only `bio`, `teaching_mode` (online | in_person | both), and `is_published` are writable — partial update, send only the fields you want to change. Bank/payout/ Stripe/role/email fields are never accepted, and there is no per-tutor rate field (rate lives in the org matrix). Returns the full updated tutor. 404 if `{tutor_id}` isn't an accepted member of your org. ## OpenAPI ````yaml /openapi.json put /v1/tutors/{tutor_id} openapi: 3.1.0 info: title: ClassQuill Public API description: >- REST API for ClassQuill 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 ClassQuill 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/tutors/{tutor_id}: put: tags: - Tutors summary: Update Tutor description: >- Update an org tutor's profile fields. Only `bio`, `teaching_mode` (online | in_person | both), and `is_published` are writable — partial update, send only the fields you want to change. Bank/payout/ Stripe/role/email fields are never accepted, and there is no per-tutor rate field (rate lives in the org matrix). Returns the full updated tutor. 404 if `{tutor_id}` isn't an accepted member of your org. operationId: update_tutor_v1_tutors__tutor_id__put parameters: - name: tutor_id in: path required: true schema: type: string title: Tutor Id requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/TutorUpdate' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/Tutor' '401': description: Missing, malformed, revoked, or expired credentials. content: application/json: schema: $ref: '#/components/schemas/ApiError' '403': description: The credential lacks the scope this endpoint requires. content: application/json: schema: $ref: '#/components/schemas/ApiError' '404': description: >- Not found — the record doesn't exist or belongs to another organisation. content: application/json: schema: $ref: '#/components/schemas/ApiError' '422': description: Validation error — `error.details.errors` lists the fields. content: application/json: schema: $ref: '#/components/schemas/ApiError' '429': description: >- Rate limit exceeded — honour Retry-After and the RateLimit-* headers. content: application/json: schema: $ref: '#/components/schemas/ApiError' components: schemas: TutorUpdate: properties: bio: anyOf: - type: string - type: 'null' title: Bio teaching_mode: anyOf: - type: string - type: 'null' title: Teaching Mode description: online | in_person | both is_published: anyOf: - type: boolean - type: 'null' title: Is Published additionalProperties: false type: object title: TutorUpdate description: >- PUT /v1/tutors/{id} → tutor_profiles. Partial update; only these fields are writable. Bank/payout/Stripe/role/email fields are never accepted. (No rate field — tutor_profiles.hourly_rate was dropped in phase_1c; rate lives in the org matrix.) Tutor: properties: id: type: string title: Id first_name: anyOf: - type: string - type: 'null' title: First Name last_name: anyOf: - type: string - type: 'null' title: Last Name full_name: anyOf: - type: string - type: 'null' title: Full Name email: anyOf: - type: string - type: 'null' title: Email placeholder_email: anyOf: - type: boolean - type: 'null' title: Placeholder Email role: anyOf: - type: string - type: 'null' title: Role status: anyOf: - type: string - type: 'null' title: Status bio: anyOf: - type: string - type: 'null' title: Bio teaching_mode: anyOf: - type: string - type: 'null' title: Teaching Mode is_published: anyOf: - type: boolean - type: 'null' title: Is Published avatar_url: anyOf: - type: string - type: 'null' title: Avatar Url handle: anyOf: - type: string - type: 'null' title: Handle subjects: items: type: string type: array title: Subjects created_at: anyOf: - type: string - type: 'null' title: Created At home_suburb: anyOf: - type: string - type: 'null' title: Home Suburb home_postcode: anyOf: - type: string - type: 'null' title: Home Postcode home_lat: anyOf: - type: number - type: 'null' title: Home Lat home_lng: anyOf: - type: number - type: 'null' title: Home Lng service_postcodes: items: type: string type: array title: Service Postcodes default: [] serves_all_areas: anyOf: - type: boolean - type: 'null' title: Serves All Areas max_travel_km: anyOf: - type: integer - type: 'null' title: Max Travel Km in_person_arrangements: items: type: string type: array title: In Person Arrangements default: [] tutor_subjects: items: type: string type: array title: Tutor Subjects default: [] specialisations: items: type: string type: array title: Specialisations distance_km: anyOf: - type: number - type: 'null' title: Distance Km covers_area: anyOf: - type: boolean - type: 'null' title: Covers Area type: object required: - id title: Tutor ApiError: description: Canonical error envelope for every /v1 error response (4xx/5xx). properties: error: $ref: '#/components/schemas/ApiErrorBody' required: - error title: ApiError type: object ApiErrorBody: description: The `error` object every /v1 error response carries. properties: code: description: >- Stable machine-readable error code: bad_request, unauthorized, forbidden, not_found, conflict, validation_error, rate_limited, or internal_error. examples: - not_found title: Code type: string message: description: Human-readable explanation, safe to surface to end users. examples: - Session not found title: Message type: string status: description: The HTTP status code, repeated in the body. examples: - 404 title: Status type: integer details: additionalProperties: true description: >- Error-specific context. 422 carries the field errors under `errors`; 429 carries `retry_after_seconds`. title: Details type: object required: - code - message - status title: ApiErrorBody type: object securitySchemes: ApiKeyAuth: type: apiKey in: header name: Authorization description: Org API key as `Token token=ei_live_...` ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.