> ## Documentation Index > Fetch the complete documentation index at: https://docs.file.ai/llms.txt > Use this file to discover all available pages before exploring further. # Update project setting > This endpoint is used to update the setting of the project. The response will contain the updated setting of the project. This endpoint accepts an optional `Idempotency-Key` request header so a retry cannot apply the change twice. See [Idempotent requests](/docs-api/api-idempotency). ## OpenAPI ````yaml patch /prod/v1/project/setting openapi: 3.0.0 info: title: Public API description: >- ### Welcome to fileAI’s Public API Documentation. This API allows users to check the health of the system, upload and manage files, and manage AI Schemas. Should you have any questions, please reach out to fileAI via the “Contact a Developer” link below. [Contact a Developer](mailto:support@file.ai) ### Prerequisites Before using our API, please ensure you complete the following prerequisites - You must have a fileAI account. Sign up or login [here](https://orion.file.ai/en/sign-up) - You must have an API Key. After creating your fileAI account, you can generate your API Key. Refer to the Authentication section below for more details. ### Authentication All API requests require an API key for authentication. - To obtain your API key, please log in to your fileAI account and navigate to Project Settings in your dashboard - Keep your API key secure and do not share it publicly. ![Authentication](https://static.orion.file.ai/authentication.png) ### How to Use Your API Key Once you have your API key: - Click the Authorize button on the top-right of this page - Enter your API Key under Value - Click Authorize to start making authenticated requests directly from the documentation ![How to Use Your API Key](https://static.orion.file.ai/how-to-use-api-keys.png) version: '1.0' contact: {} servers: - url: https://api.orion.file.ai description: Default. Use this unless your workspace is on an instance. - url: https://api.orion.{instance}.file.ai description: Instance-specific host. variables: instance: default: au enum: - au - sg - jp description: >- Instance hosting your workspace: au (Australia), sg (Singapore), jp (Japan). security: [] tags: - name: Public API V1 paths: /prod/v1/project/setting: patch: tags: - Public API V1 summary: Update project setting description: |- This endpoint is used to update the setting of the project. The response will contain the updated setting of the project. operationId: PublicAPIController_updateProjectSetting parameters: - name: Idempotency-Key in: header description: >- Optional opaque key (max 255 chars, UUIDv4 recommended) making this request idempotent for 24h: a retry with the same key and body replays the original response with Idempotent-Replayed: true. required: false schema: type: string requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/UpdateProjectSettingForPAInput' responses: '200': description: The project setting is updated content: application/json: example: success: true schema: type: object properties: success: type: boolean '401': description: Missing or invalid API key. content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetailsDto' '403': description: Read-only or inactive API key. content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetailsDto' '404': description: Resource not found. content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetailsDto' '422': description: >- Invalid input | Invalid ocr model | Invalid form target language | Invalid isSplit content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetailsDto' examples: Invalid input: summary: Invalid input value: type: https://errors.file.ai/validation-failed title: Validation failed status: 422 detail: Invalid input. instance: /v1/{route} code: VALIDATION_FAILED requestId: 0f1c8e03-978e-40d5-bc93-6894a57f9324 errors: [] message: Invalid input. error: Unprocessable Entity statusCode: 422 Invalid ocr model: summary: Invalid ocr model value: type: https://errors.file.ai/validation-failed title: Validation failed status: 422 detail: Invalid ocr model. instance: /v1/{route} code: VALIDATION_FAILED requestId: 0f1c8e03-978e-40d5-bc93-6894a57f9324 errors: [] message: Invalid ocr model. error: Unprocessable Entity statusCode: 422 Invalid form target language: summary: Invalid form target language value: type: https://errors.file.ai/validation-failed title: Validation failed status: 422 detail: Invalid form target language. instance: /v1/{route} code: VALIDATION_FAILED requestId: 0f1c8e03-978e-40d5-bc93-6894a57f9324 errors: [] message: Invalid form target language. error: Unprocessable Entity statusCode: 422 Invalid isSplit: summary: Invalid isSplit value: type: https://errors.file.ai/validation-failed title: Validation failed status: 422 detail: Invalid isSplit. instance: /v1/{route} code: VALIDATION_FAILED requestId: 0f1c8e03-978e-40d5-bc93-6894a57f9324 errors: [] message: Invalid isSplit. error: Unprocessable Entity statusCode: 422 '429': description: Rate limit exceeded. content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetailsDto' '500': description: Unexpected internal error. content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetailsDto' security: - x-api-key: [] components: schemas: UpdateProjectSettingForPAInput: type: object properties: ocrModel: type: string description: OCR model enum: - Beethoven_ENG_O5.1 - Beethoven_ENG_G5.0 - Beethoven_ENG_O5.1 - Beethoven_ENG_O5.2 - Beethoven_ENG_O5.3 - Beethoven_ENG_O5.4 - Beethoven_ENG_O5.5 - Beethoven_ENG_O5.6 - Beethoven_CUS_O5.1 - Beethoven_ZH_O5.9 - Beethoven_ENG_G5.2 - Beethoven_ENG_G5.3 - Beethoven_ENG_G5.4 - Beethoven_ENG_G5.5 - Beethoven_ENG_GP25.1 - Unified (google-document-ai-ocr-gemini-v10) - Beethoven_CUS_O5.2 - Beethoven_ENG_GP25 - Beethoven_ENG_GP25.2 - Aegis (google-document-ai-ocr-gemini-aegis-v1) - Beethoven_TH_O5.0 - Beethoven_TH_O5.1 - Beethoven_TH_G5.1 - Beethoven_JP_O5.1 - Beethoven_JP_O5.2 - Beethoven_JP_O5.3 - Beethoven_JP_G5.1 - Beethoven_JP_G5.2 - Beethoven_JP_G5.3 - Beethoven_JP_G5.4 - Beethoven_CUS_GP25.1 - Beethoven_ENG_GP3 - Beethoven_Direct_Form_Filling (GP2.5) example: Beethoven_ENG_O5.1 formTargetLanguage: type: string description: Form target language enum: - English - Afrikaans - Albanian - Amharic - Arabic - Armenian - Assamese - Azerbaijani - Basque - Belarusian - Bengali - Bosnian - Bulgarian - Burmese - Catalan - Cebuano - Chinese - Corsican - Croatian - Czech - Danish - Dutch - Esperanto - Estonian - Finnish - French - Frisian - Galician - Georgian - German - Greek - Gujarati - Haitian Creole - Hausa - Hawaiian - Hebrew - Hindi - Hmong - Hungarian - Icelandic - Igbo - Indonesian - Irish - Italian - Japanese - Javanese - Kannada - Kazakh - Khmer - Kinyarwanda - Korean - Kurdish - Kyrgyz - Laothian - Latin - Latvian - Lithuanian - Luxembourgish - Macedonian - Malagasy - Malay - Malayalam - Maltese - Maori - Marathi - Mongolian - Nepali - Norwegian - Nyanja - Oriya - Persian - Polish - Portuguese - Punjabi - Romanian - Russian - Samoan - Scots Gaelic - Serbian - Sesotho - Shona - Sinhalese - Slovak - Slovenian - Somali - Spanish - Sundanese - Swahili - Swedish - Tajik - Tamil - Tatar - Telugu - Thai - Tibetan - Tagalog - Turkish - Turkmen - Uighur - Ukrainian - Urdu - Uzbek - Vietnamese - Welsh - Wolof - Xhosa - Yiddish - Yoruba - Zulu example: English isSplit: type: boolean description: Is split example: false ProblemDetailsDto: type: object properties: type: type: string description: A URI identifying the problem type. example: https://errors.file.ai/validation-failed title: type: string description: Stable, human-readable summary of the problem type. example: Validation failed status: type: number description: HTTP status code. example: 422 detail: type: string description: Human-readable explanation specific to this occurrence. example: One or more fields are invalid. instance: type: string description: URI reference for this occurrence (the request path). example: /v1/files/upload code: type: string description: Stable machine-readable error code. example: VALIDATION_FAILED requestId: type: string description: Correlation id for this request. example: 0f1c8e03-978e-40d5-bc93-6894a57f9324 errors: description: Field-level violations (validation only). type: array items: $ref: '#/components/schemas/ProblemErrorItemDto' retryAfter: type: number description: Seconds until the client may retry (present on 429 only). example: 42 message: type: string description: Legacy key (deprecated — use `detail`/`title`). example: Validation failed error: type: string description: Legacy key (deprecated — use `title`). example: Unprocessable Entity statusCode: type: number description: Legacy key (deprecated — use `status`). example: 422 required: - type - title - status - detail - instance - code - requestId - errors - message - error - statusCode ProblemErrorItemDto: type: object properties: code: type: string example: REQUIRED detail: type: string example: must not be empty pointer: type: string description: JSON Pointer to the offending body field. example: '#/fileName' parameter: type: string description: Name of the offending query/header parameter. example: limit required: - code - detail securitySchemes: x-api-key: type: apiKey in: header name: x-api-key description: API key for authentication ````