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). workspaces lists where this connection may act; switch_workspace moves it there for every call after. Plan, credits, members, keys, sign-in and per-machine settings are not here. Free.

POST

tools

manage_settings

manage settings

curl --request POST \
  --url https://eversince.ai/api/v1/tools/manage_settings \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "workspaces": true,
  "switch_workspace": "<string>",
  "video_model": "<string>",
  "image_model": "<string>",
  "music_model": "<string>",
  "timezone": "<string>",
  "workspace_name": "<string>",
  "workspace_icon": "<string>",
  "file_new_items": {
    "uploads": true,
    "timeline_renders": true,
    "canvas_exports": true,
    "generations": true,
    "stock_photos": true
  },
  "free_cloud_space_when_links_end": true,
  "sync_files_to_cloud": true,
  "context": "<string>"
}
'

import requests

url = "https://eversince.ai/api/v1/tools/manage_settings"

payload = {
    "workspaces": True,
    "switch_workspace": "<string>",
    "video_model": "<string>",
    "image_model": "<string>",
    "music_model": "<string>",
    "timezone": "<string>",
    "workspace_name": "<string>",
    "workspace_icon": "<string>",
    "file_new_items": {
        "uploads": True,
        "timeline_renders": True,
        "canvas_exports": True,
        "generations": True,
        "stock_photos": True
    },
    "free_cloud_space_when_links_end": True,
    "sync_files_to_cloud": True,
    "context": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    workspaces: true,
    switch_workspace: '<string>',
    video_model: '<string>',
    image_model: '<string>',
    music_model: '<string>',
    timezone: '<string>',
    workspace_name: '<string>',
    workspace_icon: '<string>',
    file_new_items: {
      uploads: true,
      timeline_renders: true,
      canvas_exports: true,
      generations: true,
      stock_photos: true
    },
    free_cloud_space_when_links_end: true,
    sync_files_to_cloud: true,
    context: '<string>'
  })
};

fetch('https://eversince.ai/api/v1/tools/manage_settings', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "ok": true,
  "data": {},
  "meta": {
    "request_id": "<string>",
    "cost": {},
    "cloud_processing": {
      "ran_on": "cloud",
      "minutes": 123,
      "charged_minutes": 123,
      "queued_minutes": 123,
      "left_minutes": 123,
      "held_minutes": 123,
      "bought_minutes": 123,
      "note": "<string>"
    }
  },
  "media": [
    {}
  ]
}

{
  "ok": false,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "retryable": true,
    "suggested_action": "<string>",
    "cloud_processing": {
      "ran_on": "cloud",
      "minutes": 123,
      "charged_minutes": 123,
      "queued_minutes": 123,
      "left_minutes": 123,
      "held_minutes": 123,
      "bought_minutes": 123,
      "note": "<string>"
    }
  }
}

Authorizations

Authorization

string

header

required

An API key (es_live_…) from Settings, under API keys, or an OAuth access token.

Headers

Idempotency-Key

string

Retry a paid dispatch safely: the same key returns the job already dispatched instead of charging again.

x-workspace-id

string

The workspace this one call acts in, when it is not the default: for a key or a connected agent, one of the workspaces the user allowed it.

Body

application/json

workspaces

boolean

List the workspaces this connection may act in, the current one marked. Free.

switch_workspace

string

Move this connection to another of its workspaces, by id or name, for every call after this one until switched again. Through the desktop app the app opens that workspace; while a recording, upload or render runs there it opens once that ends, and calls until then act in the workspace it has open. The result's opened says whether it opened now.

Maximum string length: 200

video_model

string

The model a video generation uses when none is named. Ids come from list_models.

image_model

string

The model an image generation uses when none is named.

music_model

string

The model generate_audio uses for music when none is named. Voiceover and sound effects have one provider each.

timezone

string

This user's time zone as an IANA name (Europe/London, America/New_York). It decides what "today" and "this month" mean in calendars.

workspace_name

string

Rename this workspace, up to 60 characters.

Maximum string length: 60

workspace_icon

string | null

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.

file_new_items

object

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.

Show child attributes

free_cloud_space_when_links_end

boolean

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.

sync_files_to_cloud

boolean

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.

context

string

Optional: one sentence shown to the user beside this action.

Maximum string length: 600

Response

Done, or a job started for work that runs longer (follow it with get_jobs).

any

required

data

object

required

meta

object

required

Show child attributes

media

object[]

manage settings

curl --request POST \
  --url https://eversince.ai/api/v1/tools/manage_settings \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "workspaces": true,
  "switch_workspace": "<string>",
  "video_model": "<string>",
  "image_model": "<string>",
  "music_model": "<string>",
  "timezone": "<string>",
  "workspace_name": "<string>",
  "workspace_icon": "<string>",
  "file_new_items": {
    "uploads": true,
    "timeline_renders": true,
    "canvas_exports": true,
    "generations": true,
    "stock_photos": true
  },
  "free_cloud_space_when_links_end": true,
  "sync_files_to_cloud": true,
  "context": "<string>"
}
'

import requests

url = "https://eversince.ai/api/v1/tools/manage_settings"

payload = {
    "workspaces": True,
    "switch_workspace": "<string>",
    "video_model": "<string>",
    "image_model": "<string>",
    "music_model": "<string>",
    "timezone": "<string>",
    "workspace_name": "<string>",
    "workspace_icon": "<string>",
    "file_new_items": {
        "uploads": True,
        "timeline_renders": True,
        "canvas_exports": True,
        "generations": True,
        "stock_photos": True
    },
    "free_cloud_space_when_links_end": True,
    "sync_files_to_cloud": True,
    "context": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    workspaces: true,
    switch_workspace: '<string>',
    video_model: '<string>',
    image_model: '<string>',
    music_model: '<string>',
    timezone: '<string>',
    workspace_name: '<string>',
    workspace_icon: '<string>',
    file_new_items: {
      uploads: true,
      timeline_renders: true,
      canvas_exports: true,
      generations: true,
      stock_photos: true
    },
    free_cloud_space_when_links_end: true,
    sync_files_to_cloud: true,
    context: '<string>'
  })
};

fetch('https://eversince.ai/api/v1/tools/manage_settings', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "ok": true,
  "data": {},
  "meta": {
    "request_id": "<string>",
    "cost": {},
    "cloud_processing": {
      "ran_on": "cloud",
      "minutes": 123,
      "charged_minutes": 123,
      "queued_minutes": 123,
      "left_minutes": 123,
      "held_minutes": 123,
      "bought_minutes": 123,
      "note": "<string>"
    }
  },
  "media": [
    {}
  ]
}

{
  "ok": false,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "retryable": true,
    "suggested_action": "<string>",
    "cloud_processing": {
      "ran_on": "cloud",
      "minutes": 123,
      "charged_minutes": 123,
      "queued_minutes": 123,
      "left_minutes": 123,
      "held_minutes": 123,
      "bought_minutes": 123,
      "note": "<string>"
    }
  }
}

Discovery

Timeline

Workspace

Library

Canvas

Generation

Research

Account

Models

Uploads

Webhooks

manage settings

Authorizations

Headers

Body

Response