> ## Documentation Index > Fetch the complete documentation index at: https://docs.eversince.ai/llms.txt > Use this file to discover all available pages before exploring further. # manage settings > Read or change account and workspace settings: the default model per medium (video, image, music), this user's time zone, the workspace's name and icon, whether new items are filed into the app's own folders by kind, whether ending a public link frees cloud copies a machine still holds, and whether desktop files also sync to the cloud. Called with nothing it reads them all; a call passes only what changes. Workspace settings are the owner's (get_workspace_overview returns the role). Plan, credits, members, keys, sign-in and per-machine settings are not here. Free. ## OpenAPI ````yaml /openapi.json post /tools/manage_settings openapi: 3.1.0 info: title: Eversince API version: '1' description: >- Every Eversince tool as one POST call, plus the routes beside them: the tool list, account and keys, uploads, webhooks and models. The prose is at https://docs.eversince.ai. servers: - url: https://eversince.ai/api/v1 security: - bearer: [] tags: - name: Discovery description: The tool list, the same on the MCP server, the REST API and the CLI. - name: Workspace description: Jobs, balances, settings, templates, skills and the overview. - name: Library description: >- Items, search, import, reading media, comments, boards, calendars, the brand kit and public links. - name: Timeline description: 'Video editing: timelines, clips, captions, sound, language and rendering.' - name: Canvas description: 'Still editing: canvases, slides, layers and rendering.' - name: Generation description: Image, video and audio generation, upscaling, cutouts and models. - name: Research description: 'What platforms publish: pulling and keeping posts.' - name: Account description: Balances, keys, workspaces and script sessions. - name: Uploads description: Files into the library by presigned upload or by URL. - name: Webhooks description: Job results posted to a URL as they complete. - name: Models description: Generation models and cost estimates. paths: /tools/manage_settings: post: tags: - Workspace summary: manage settings description: >- Read or change account and workspace settings: the default model per medium (video, image, music), this user's time zone, the workspace's name and icon, whether new items are filed into the app's own folders by kind, whether ending a public link frees cloud copies a machine still holds, and whether desktop files also sync to the cloud. Called with nothing it reads them all; a call passes only what changes. Workspace settings are the owner's (get_workspace_overview returns the role). Plan, credits, members, keys, sign-in and per-machine settings are not here. Free. operationId: manage_settings parameters: - $ref: '#/components/parameters/IdempotencyKey' - $ref: '#/components/parameters/WorkspaceId' requestBody: required: true content: application/json: schema: type: object properties: video_model: description: >- The model a video generation uses when none is named. Ids come from list_models. type: string image_model: description: The model an image generation uses when none is named. type: string music_model: description: >- The model generate_audio uses for music when none is named. Voiceover and sound effects have one provider each. type: string timezone: description: >- This user's time zone as an IANA name (Europe/London, America/New_York). It decides what "today" and "this month" mean in calendars. type: string workspace_name: description: Rename this workspace, up to 60 characters. type: string maxLength: 60 workspace_icon: description: >- An image in the library, by id or ref, made this workspace's icon. null removes it and the name's first letter is drawn instead. anyOf: - type: string - type: 'null' file_new_items: description: >- Per kind, whether a new item with no folder chosen is filed into the app's own folder for it. All on unless switched off; a kind set false lands at the top level. Pass only the kinds that change. type: object properties: uploads: type: boolean generations: type: boolean timeline_renders: type: boolean canvas_exports: type: boolean attachments: type: boolean stock_photos: type: boolean additionalProperties: false free_cloud_space_when_links_end: description: >- When a public link is taken down, a file the link itself put in the cloud drops that copy, if a machine still holds it and nothing else needs it. On unless switched off. type: boolean sync_files_to_cloud: description: >- Files on a desktop also go to the cloud while the owner's storage has room, so the web, phones, members and cloud agents can use them. On unless switched off; off keeps new files on the computer they came from. type: boolean context: description: 'Optional: one sentence shown to the user beside this action.' type: string maxLength: 600 responses: '200': description: >- Done, or a job started for work that runs longer (follow it with get_jobs). content: application/json: schema: type: object required: - ok - data - meta properties: ok: const: true data: type: object additionalProperties: true meta: type: object properties: request_id: type: string cost: $ref: '#/components/schemas/Cost' cloud_processing: $ref: '#/components/schemas/CloudProcessing' media: type: array items: type: object additionalProperties: true default: $ref: '#/components/responses/Error' components: parameters: IdempotencyKey: name: Idempotency-Key in: header required: false schema: type: string description: >- Retry a paid dispatch safely: the same key returns the job already dispatched instead of charging again. WorkspaceId: name: x-workspace-id in: header required: false schema: type: string description: The workspace this one call acts in, when it is not the key's own. schemas: Cost: type: object description: AI credits the call cost. additionalProperties: true CloudProcessing: type: object description: Cloud processing the call used, and what is left. properties: ran_on: const: cloud minutes: type: number queued_minutes: type: number left_minutes: type: number bought_minutes: type: number note: type: string Error: type: object required: - ok - error properties: ok: const: false error: type: object required: - code - message - retryable properties: code: type: string message: type: string description: What went wrong, in words to act on. retryable: type: boolean suggested_action: type: string description: The next step that works. cloud_processing: $ref: '#/components/schemas/CloudProcessing' responses: Error: description: The call was refused or failed. content: application/json: schema: $ref: '#/components/schemas/Error' securitySchemes: bearer: type: http scheme: bearer description: >- An API key (es_live_…) from Settings, under API keys, or an OAuth access token. ````