> ## 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 Question > Create a question in your org's private question bank. The question is stamped with `organization_id` (the calling org) and no `user_id` — org-owned content survives individual tutor turnover. It then appears in the default `GET /v1/questions` union for this org (and in the in-app Question Bank's "Org Bank" scope), but never in the shared catalogue. Honours `Idempotency-Key`. Requires `coursework:write` (the coarse `write` umbrella grants it). ## OpenAPI ````yaml /openapi.json post /v1/questions 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/questions: post: tags: - Coursework summary: Create Question description: >- Create a question in your org's private question bank. The question is stamped with `organization_id` (the calling org) and no `user_id` — org-owned content survives individual tutor turnover. It then appears in the default `GET /v1/questions` union for this org (and in the in-app Question Bank's "Org Bank" scope), but never in the shared catalogue. Honours `Idempotency-Key`. Requires `coursework:write` (the coarse `write` umbrella grants it). operationId: create_question_v1_questions_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/QuestionCreate' responses: '201': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/Question' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' components: schemas: QuestionCreate: properties: intro_text: anyOf: - type: string - type: 'null' title: Intro Text topic: anyOf: - type: string - type: 'null' title: Topic description: math_level_id, e.g. 'methods_34' tags: anyOf: - items: type: string type: array - type: 'null' title: Tags parts: items: $ref: '#/components/schemas/QuestionPartCreate' type: array minItems: 1 title: Parts additionalProperties: false type: object required: - parts title: QuestionCreate description: >- POST /v1/questions → questions_v2 (+ question_parts). Creates a question in the key's org private bank: organization_id is server-set to the key's org, user_id is NULL (org-owned), and `source` stays NULL (never a platform label). At least one part is required. Question: properties: id: type: string title: Id source: anyOf: - type: string - type: 'null' title: Source topic: anyOf: - type: string - type: 'null' title: Topic tags: items: type: string type: array title: Tags default: [] intro_text: anyOf: - type: string - type: 'null' title: Intro Text is_official_vce: anyOf: - type: boolean - type: 'null' title: Is Official Vce is_current_study_design: anyOf: - type: boolean - type: 'null' title: Is Current Study Design question_number: anyOf: - type: integer - type: 'null' title: Question Number total_marks: anyOf: - type: integer - type: 'null' title: Total Marks owned_by_org: anyOf: - type: boolean - type: 'null' title: Owned By Org author_id: anyOf: - type: string - type: 'null' title: Author Id created_at: anyOf: - type: string - type: 'null' title: Created At type: object required: - id title: Question HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError QuestionPartCreate: properties: content: type: string minLength: 1 title: Content label: anyOf: - type: string - type: 'null' title: Label position: anyOf: - type: integer - type: 'null' title: Position marks: anyOf: - type: integer - type: 'null' title: Marks difficulty: anyOf: - type: string enum: - Easy - Medium - Hard - type: 'null' title: Difficulty answer: anyOf: - type: string - type: 'null' title: Answer solution: anyOf: - type: string - type: 'null' title: Solution is_multi_choice: type: boolean title: Is Multi Choice default: false mcq_options: anyOf: - items: {} type: array - type: 'null' title: Mcq Options curriculum_level_id: anyOf: - type: string - type: 'null' title: Curriculum Level Id additionalProperties: false type: object required: - content title: QuestionPartCreate description: >- One part of a question created via POST /v1/questions. `difficulty` is validated here (Literal) so an invalid value 422s at the API boundary rather than being silently dropped by the create pipeline (the question_parts difficulty CHECK is the DB backstop). `content` is required. 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_...` ````