TODO for AI API

user

Endpoint

User profile

GET

https://api.todofor.ai/api/v1

/users/profile

Returns the authenticated user profile including settings and preferences.

User profile › Responses

Successful response

userobject · required
settingsobject · required
onboardingobject · required
Per-user onboarding state. Stores draft user input + wizard progress. Step "completion" is derived from real product state, not stored here. No secrets — vault tokens stay in AppSettings.vaultProviders.

User exportData

GET

https://api.todofor.ai/api/v1

/users/export

Returns account records and file metadata as portable JSON. Known credential fields, vault values, and file bytes are omitted; user-authored content is exported as stored.

User exportData › Responses

Successful response

exportedAtstring · required
userrequired
profilerequired
settingsrequired
onboardingrequired
authSessionsarray · required
authAccountsarray · required
projectsarray · required
projectSettingsarray · required
todosarray · required
messagesarray · required
agentSettingsarray · required
edgesarray · required
devicesarray · required
apiKeysarray · required
tasksarray · required
scheduledTasksarray · required
usagearray · required
transactionsarray · required
externalDataSourcesarray · required
todoCostsarray · required
hexGridsarray · required
gridTilesarray · required
attachmentsarray · required
businessContextsarray · required
vaultobject · required

User deleteAccount

DELETE

https://api.todofor.ai/api/v1

/users/account

Permanently deletes the authenticated account and all user-owned data.

User deleteAccount › Request Body

User deleteAccount › Responses

Successful response

successboolean · required

User setDefaultProject

POST

https://api.todofor.ai/api/v1

/users/default-project

Sets the project the user lands on at /. Accepts any project the user can access, including shared team projects.

User setDefaultProject › Request Body

projectIdstring · required

User setDefaultProject › Responses

Successful response

null

User updateProjectAgentMapping

POST

https://api.todofor.ai/api/v1

/users/project-agent-mapping

Updates the default agent settings to use for new todos in a specific project.

User updateProjectAgentMapping › Request Body

projectIdstring · required
agentSettingsIdstring · required

User updateProjectAgentMapping › Responses

Successful response

null

usage

User profile

GET

https://api.todofor.ai/api/v1

/users/profile

Returns the authenticated user profile including settings and preferences.

User profile › Responses

Successful response

userobject · required
settingsobject · required
onboardingobject · required
Per-user onboarding state. Stores draft user input + wizard progress. Step "completion" is derived from real product state, not stored here. No secrets — vault tokens stay in AppSettings.vaultProviders.

User exportData

GET

https://api.todofor.ai/api/v1

/users/export

Returns account records and file metadata as portable JSON. Known credential fields, vault values, and file bytes are omitted; user-authored content is exported as stored.

User exportData › Responses

Successful response

exportedAtstring · required
userrequired
profilerequired
settingsrequired
onboardingrequired
authSessionsarray · required
authAccountsarray · required
projectsarray · required
projectSettingsarray · required
todosarray · required
messagesarray · required
agentSettingsarray · required
edgesarray · required
devicesarray · required
apiKeysarray · required
tasksarray · required
scheduledTasksarray · required
usagearray · required
transactionsarray · required
externalDataSourcesarray · required
todoCostsarray · required
hexGridsarray · required
gridTilesarray · required
attachmentsarray · required
businessContextsarray · required
vaultobject · required

User setDefaultProject

POST

https://api.todofor.ai/api/v1

/users/default-project

Sets the project the user lands on at /. Accepts any project the user can access, including shared team projects.

User setDefaultProject › Request Body

projectIdstring · required

User setDefaultProject › Responses

Successful response

null

User updateProjectAgentMapping

POST

https://api.todofor.ai/api/v1

/users/project-agent-mapping

Updates the default agent settings to use for new todos in a specific project.

User updateProjectAgentMapping › Request Body

projectIdstring · required
agentSettingsIdstring · required

User updateProjectAgentMapping › Responses

Successful response

null