POST/api/todo/v1/commands

command /api/todo/v1/commands

Human command endpoint. Non-human identities are denied consequential write scopes; this is not a generic external OAuth API.

App: To Do
Contract: To Do module API 1.9.0
Lifecycle: preview
Runtime: restricted
Operation ID: mop_NrOVEeJrFiRIF8vvxxI4Gr9dAPPJ0Zs4
Canonical origin: https://api.runonvision.com

Availability: This is a preview contract with runtime status restricted. Publication documents an approved interface; it does not imply public production access.

Purpose and use cases

The owning App is Vision To Do. To Do owns task data, domain rules, workspace authorization and command execution. Vision Core brokers human operation grants. Publishing this snapshot creates no new client grants or external access.

Request

POST https://api.runonvision.com/api/todo/v1/commands

Authentication and authorization

Send a Vision-issued bearer token for the exact App audience. The token must include the todo entitlement and satisfy the explicit to do workspace bound to the authenticated identity binding.

Required scope: todo:tasks:write

Human roles are not declared in OpenAPI. Record-level and business permission checks remain the owning App's authority.

Headers

Authorization: Bearer <access-token> — required.
Accept: application/json — recommended where a JSON response is declared.
Content-Type: application/json — required for the documented request representation.

Undeclared tracing, idempotency, conditional-request, and version headers are not assumed on this page.

Path and query parameters

This operation declares no path or query parameters.

Request body

Media type: application/json. The body is required.

object | object | object | object | object | object | object | object | object | object | object | object | object | object | object | object | object | object

Runnable examples

Placeholder values are generated from the approved schema and are not live credentials or customer data. Replace every angle-bracket or shell variable value. Examples cannot be run until the App has a routed base URL and your client has the required grant.

Task Set Status

Set commandType to "task.set_status".

Field	Type	Rules	Description
commandType	"task.set_status"	required	Not described in the contract.
data	object	required	Not described in the contract.
data.status	pending \| in_progress \| completed \| cancelled	required	Not described in the contract.
idempotencyKey	string	required; minimum length 16; maximum length 160; pattern ^[A-Za-z0-9._:-]+$	Not described in the contract.
schemaVersion	"vision-todo-command.v1"	required	Not described in the contract.
targetReference	string · uuid	required; pattern ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}\|00000000-0000-0000-0000-000000000000\|ffffffff-ffff-ffff-ffff-ffffffffffff)$	Not described in the contract.

Task Set Status — cURL

curl 'https://api.runonvision.com/api/todo/v1/commands' \
  --request POST \
  --header 'authorization: Bearer ***' \
  --header 'accept: application/json' \
  --header 'content-type: application/json' \
  --data '{
    "commandType": "task.set_status",
    "data": {
      "status": "pending"
    },
    "idempotencyKey": "<idempotencyKey>",
    "schemaVersion": "vision-todo-command.v1",
    "targetReference": "00000000-0000-4000-8000-000000000001"
  }'

Task Set Status — JavaScript (server-side)

const response = await fetch('https://api.runonvision.com/api/todo/v1/commands', {
  method: 'POST',
  headers: {
  "authorization": "Bearer <ACCESS_TOKEN>",
  "accept": "application/json",
  "content-type": "application/json"
},
  body: JSON.stringify({
  "commandType": "task.set_status",
  "data": {
    "status": "pending"
  },
  "idempotencyKey": "<idempotencyKey>",
  "schemaVersion": "vision-todo-command.v1",
  "targetReference": "00000000-0000-4000-8000-000000000001"
}),
})

if (!response.ok) throw new Error(`Vision API ${response.status}`)
const result = await response.json()

Task Set Status — Python 3 standard library

import json
import urllib.request

request = urllib.request.Request(
    'https://api.runonvision.com/api/todo/v1/commands',
    data=json.dumps({"commandType":"task.set_status","data":{"status":"pending"},"idempotencyKey":"<idempotencyKey>","schemaVersion":"vision-todo-command.v1","targetReference":"00000000-0000-4000-8000-000000000001"}).encode(),
    headers={
    "Authorization": "Bearer <ACCESS_TOKEN>",
    "Accept": "application/json",
    "content-type": "application/json"
},
    method='POST',
)
with urllib.request.urlopen(request, timeout=30) as response:
    result = json.load(response)

Task Set Starred

Set commandType to "task.set_starred".

Field	Type	Rules	Description
commandType	"task.set_starred"	required	Not described in the contract.
data	object	required	Not described in the contract.
data.starred	boolean \| true \| false	required	Not described in the contract.
idempotencyKey	string	required; minimum length 16; maximum length 160; pattern ^[A-Za-z0-9._:-]+$	Not described in the contract.
schemaVersion	"vision-todo-command.v1"	required	Not described in the contract.
targetReference	string · uuid	required; pattern ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}\|00000000-0000-0000-0000-000000000000\|ffffffff-ffff-ffff-ffff-ffffffffffff)$	Not described in the contract.

Task Set Starred — cURL

curl 'https://api.runonvision.com/api/todo/v1/commands' \
  --request POST \
  --header 'authorization: Bearer ***' \
  --header 'accept: application/json' \
  --header 'content-type: application/json' \
  --data '{
    "commandType": "task.set_starred",
    "data": {
      "starred": true
    },
    "idempotencyKey": "<idempotencyKey>",
    "schemaVersion": "vision-todo-command.v1",
    "targetReference": "00000000-0000-4000-8000-000000000001"
  }'

Task Set Starred — JavaScript (server-side)

const response = await fetch('https://api.runonvision.com/api/todo/v1/commands', {
  method: 'POST',
  headers: {
  "authorization": "Bearer <ACCESS_TOKEN>",
  "accept": "application/json",
  "content-type": "application/json"
},
  body: JSON.stringify({
  "commandType": "task.set_starred",
  "data": {
    "starred": true
  },
  "idempotencyKey": "<idempotencyKey>",
  "schemaVersion": "vision-todo-command.v1",
  "targetReference": "00000000-0000-4000-8000-000000000001"
}),
})

if (!response.ok) throw new Error(`Vision API ${response.status}`)
const result = await response.json()

Task Set Starred — Python 3 standard library

import json
import urllib.request

request = urllib.request.Request(
    'https://api.runonvision.com/api/todo/v1/commands',
    data=json.dumps({"commandType":"task.set_starred","data":{"starred":true},"idempotencyKey":"<idempotencyKey>","schemaVersion":"vision-todo-command.v1","targetReference":"00000000-0000-4000-8000-000000000001"}).encode(),
    headers={
    "Authorization": "Bearer <ACCESS_TOKEN>",
    "Accept": "application/json",
    "content-type": "application/json"
},
    method='POST',
)
with urllib.request.urlopen(request, timeout=30) as response:
    result = json.load(response)

Task Set Archived

Set commandType to "task.set_archived".

Field	Type	Rules	Description
commandType	"task.set_archived"	required	Not described in the contract.
data	object	required	Not described in the contract.
data.archived	boolean \| true \| false	required	Not described in the contract.
idempotencyKey	string	required; minimum length 16; maximum length 160; pattern ^[A-Za-z0-9._:-]+$	Not described in the contract.
schemaVersion	"vision-todo-command.v1"	required	Not described in the contract.
targetReference	string · uuid	required; pattern ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}\|00000000-0000-0000-0000-000000000000\|ffffffff-ffff-ffff-ffff-ffffffffffff)$	Not described in the contract.

Task Set Archived — cURL

curl 'https://api.runonvision.com/api/todo/v1/commands' \
  --request POST \
  --header 'authorization: Bearer ***' \
  --header 'accept: application/json' \
  --header 'content-type: application/json' \
  --data '{
    "commandType": "task.set_archived",
    "data": {
      "archived": true
    },
    "idempotencyKey": "<idempotencyKey>",
    "schemaVersion": "vision-todo-command.v1",
    "targetReference": "00000000-0000-4000-8000-000000000001"
  }'

Task Set Archived — JavaScript (server-side)

const response = await fetch('https://api.runonvision.com/api/todo/v1/commands', {
  method: 'POST',
  headers: {
  "authorization": "Bearer <ACCESS_TOKEN>",
  "accept": "application/json",
  "content-type": "application/json"
},
  body: JSON.stringify({
  "commandType": "task.set_archived",
  "data": {
    "archived": true
  },
  "idempotencyKey": "<idempotencyKey>",
  "schemaVersion": "vision-todo-command.v1",
  "targetReference": "00000000-0000-4000-8000-000000000001"
}),
})

if (!response.ok) throw new Error(`Vision API ${response.status}`)
const result = await response.json()

Task Set Archived — Python 3 standard library

import json
import urllib.request

request = urllib.request.Request(
    'https://api.runonvision.com/api/todo/v1/commands',
    data=json.dumps({"commandType":"task.set_archived","data":{"archived":true},"idempotencyKey":"<idempotencyKey>","schemaVersion":"vision-todo-command.v1","targetReference":"00000000-0000-4000-8000-000000000001"}).encode(),
    headers={
    "Authorization": "Bearer <ACCESS_TOKEN>",
    "Accept": "application/json",
    "content-type": "application/json"
},
    method='POST',
)
with urllib.request.urlopen(request, timeout=30) as response:
    result = json.load(response)

Task Create

Set commandType to "task.create".

Field	Type	Rules	Description
commandType	"task.create"	required	Not described in the contract.
data	object	required	Not described in the contract.
data.allDay	boolean \| true \| false	optional	Not described in the contract.
data.assignedToUserId	string · uuid \| null	optional	Not described in the contract.
data.description	string \| null	optional	Not described in the contract.
data.dueAt	string \| null	optional	Not described in the contract.
data.linkAppId	string	optional; pattern ^[a-z][a-z0-9-]{1,39}$	Not described in the contract.
data.linkLabel	string	optional; minimum length 1; maximum length 240	Not described in the contract.
data.linkReference	string	optional; minimum length 1; maximum length 200	Not described in the contract.
data.listId	string · uuid \| null	optional	Not described in the contract.
data.newListName	string	optional; minimum length 1; maximum length 120	Not described in the contract.
data.priority	none \| low \| medium \| high	optional	Not described in the contract.
data.recurrenceFrom	due \| completion \| null	optional	Not described in the contract.
data.recurrenceRule	string \| null	optional	Not described in the contract.
data.reminderAt	string \| null	optional	Not described in the contract.
data.status	pending \| in_progress \| completed \| cancelled	optional	Not described in the contract.
data.subtasks	array	optional; maximum items 50	Not described in the contract.
data.title	string	required; minimum length 1; maximum length 300	Not described in the contract.
idempotencyKey	string	required; minimum length 16; maximum length 160; pattern ^[A-Za-z0-9._:-]+$	Not described in the contract.
schemaVersion	"vision-todo-command.v1"	required	Not described in the contract.

Task Create — cURL

curl 'https://api.runonvision.com/api/todo/v1/commands' \
  --request POST \
  --header 'authorization: Bearer ***' \
  --header 'accept: application/json' \
  --header 'content-type: application/json' \
  --data '{
    "commandType": "task.create",
    "data": {
      "allDay": true,
      "assignedToUserId": "00000000-0000-4000-8000-000000000001",
      "description": "<description>",
      "dueAt": "<dueAt>",
      "linkAppId": "<linkAppId>",
      "linkLabel": "<linkLabel>",
      "linkReference": "<linkReference>",
      "listId": "00000000-0000-4000-8000-000000000001",
      "newListName": "<newListName>",
      "priority": "none",
      "recurrenceFrom": "due",
      "recurrenceRule": "<recurrenceRule>",
      "reminderAt": "<reminderAt>",
      "status": "pending",
      "subtasks": [
        "<subtasks>"
      ],
      "title": "<title>"
    },
    "idempotencyKey": "<idempotencyKey>",
    "schemaVersion": "vision-todo-command.v1"
  }'

Task Create — JavaScript (server-side)

const response = await fetch('https://api.runonvision.com/api/todo/v1/commands', {
  method: 'POST',
  headers: {
  "authorization": "Bearer <ACCESS_TOKEN>",
  "accept": "application/json",
  "content-type": "application/json"
},
  body: JSON.stringify({
  "commandType": "task.create",
  "data": {
    "allDay": true,
    "assignedToUserId": "00000000-0000-4000-8000-000000000001",
    "description": "<description>",
    "dueAt": "<dueAt>",
    "linkAppId": "<linkAppId>",
    "linkLabel": "<linkLabel>",
    "linkReference": "<linkReference>",
    "listId": "00000000-0000-4000-8000-000000000001",
    "newListName": "<newListName>",
    "priority": "none",
    "recurrenceFrom": "due",
    "recurrenceRule": "<recurrenceRule>",
    "reminderAt": "<reminderAt>",
    "status": "pending",
    "subtasks": [
      "<subtasks>"
    ],
    "title": "<title>"
  },
  "idempotencyKey": "<idempotencyKey>",
  "schemaVersion": "vision-todo-command.v1"
}),
})

if (!response.ok) throw new Error(`Vision API ${response.status}`)
const result = await response.json()

Task Create — Python 3 standard library

import json
import urllib.request

request = urllib.request.Request(
    'https://api.runonvision.com/api/todo/v1/commands',
    data=json.dumps({"commandType":"task.create","data":{"allDay":true,"assignedToUserId":"00000000-0000-4000-8000-000000000001","description":"<description>","dueAt":"<dueAt>","linkAppId":"<linkAppId>","linkLabel":"<linkLabel>","linkReference":"<linkReference>","listId":"00000000-0000-4000-8000-000000000001","newListName":"<newListName>","priority":"none","recurrenceFrom":"due","recurrenceRule":"<recurrenceRule>","reminderAt":"<reminderAt>","status":"pending","subtasks":["<subtasks>"],"title":"<title>"},"idempotencyKey":"<idempotencyKey>","schemaVersion":"vision-todo-command.v1"}).encode(),
    headers={
    "Authorization": "Bearer <ACCESS_TOKEN>",
    "Accept": "application/json",
    "content-type": "application/json"
},
    method='POST',
)
with urllib.request.urlopen(request, timeout=30) as response:
    result = json.load(response)

Task Update

Set commandType to "task.update".

Field	Type	Rules	Description
commandType	"task.update"	required	Not described in the contract.
data	object	required	Not described in the contract.
data.allDay	boolean \| true \| false	optional	Not described in the contract.
data.assignedToUserId	string · uuid \| null	optional	Not described in the contract.
data.deadlineAt	string \| null	optional	Not described in the contract.
data.description	string \| null	optional	Not described in the contract.
data.dueAt	string \| null	optional	Not described in the contract.
data.listId	string · uuid	optional; pattern ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}\|00000000-0000-0000-0000-000000000000\|ffffffff-ffff-ffff-ffff-ffffffffffff)$	Not described in the contract.
data.newListName	string	optional; minimum length 1; maximum length 120	Not described in the contract.
data.priority	none \| low \| medium \| high	optional	Not described in the contract.
data.recurrenceFrom	due \| completion \| null	optional	Not described in the contract.
data.recurrenceRule	string \| null	optional	Not described in the contract.
data.reminderAt	string \| null	optional	Not described in the contract.
data.startAt	string \| null	optional	Not described in the contract.
data.status	pending \| in_progress \| completed \| cancelled	optional	Not described in the contract.
data.title	string	optional; minimum length 1; maximum length 300	Not described in the contract.
idempotencyKey	string	required; minimum length 16; maximum length 160; pattern ^[A-Za-z0-9._:-]+$	Not described in the contract.
schemaVersion	"vision-todo-command.v1"	required	Not described in the contract.
targetReference	string · uuid	required; pattern ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}\|00000000-0000-0000-0000-000000000000\|ffffffff-ffff-ffff-ffff-ffffffffffff)$	Not described in the contract.

Task Update — cURL

curl 'https://api.runonvision.com/api/todo/v1/commands' \
  --request POST \
  --header 'authorization: Bearer ***' \
  --header 'accept: application/json' \
  --header 'content-type: application/json' \
  --data '{
    "commandType": "task.update",
    "data": {
      "allDay": true,
      "assignedToUserId": "00000000-0000-4000-8000-000000000001",
      "deadlineAt": "<deadlineAt>",
      "description": "<description>",
      "dueAt": "<dueAt>",
      "listId": "00000000-0000-4000-8000-000000000001",
      "newListName": "<newListName>",
      "priority": "none",
      "recurrenceFrom": "due",
      "recurrenceRule": "<recurrenceRule>",
      "reminderAt": "<reminderAt>",
      "startAt": "<startAt>",
      "status": "pending",
      "title": "<title>"
    },
    "idempotencyKey": "<idempotencyKey>",
    "schemaVersion": "vision-todo-command.v1",
    "targetReference": "00000000-0000-4000-8000-000000000001"
  }'

Task Update — JavaScript (server-side)

const response = await fetch('https://api.runonvision.com/api/todo/v1/commands', {
  method: 'POST',
  headers: {
  "authorization": "Bearer <ACCESS_TOKEN>",
  "accept": "application/json",
  "content-type": "application/json"
},
  body: JSON.stringify({
  "commandType": "task.update",
  "data": {
    "allDay": true,
    "assignedToUserId": "00000000-0000-4000-8000-000000000001",
    "deadlineAt": "<deadlineAt>",
    "description": "<description>",
    "dueAt": "<dueAt>",
    "listId": "00000000-0000-4000-8000-000000000001",
    "newListName": "<newListName>",
    "priority": "none",
    "recurrenceFrom": "due",
    "recurrenceRule": "<recurrenceRule>",
    "reminderAt": "<reminderAt>",
    "startAt": "<startAt>",
    "status": "pending",
    "title": "<title>"
  },
  "idempotencyKey": "<idempotencyKey>",
  "schemaVersion": "vision-todo-command.v1",
  "targetReference": "00000000-0000-4000-8000-000000000001"
}),
})

if (!response.ok) throw new Error(`Vision API ${response.status}`)
const result = await response.json()

Task Update — Python 3 standard library

import json
import urllib.request

request = urllib.request.Request(
    'https://api.runonvision.com/api/todo/v1/commands',
    data=json.dumps({"commandType":"task.update","data":{"allDay":true,"assignedToUserId":"00000000-0000-4000-8000-000000000001","deadlineAt":"<deadlineAt>","description":"<description>","dueAt":"<dueAt>","listId":"00000000-0000-4000-8000-000000000001","newListName":"<newListName>","priority":"none","recurrenceFrom":"due","recurrenceRule":"<recurrenceRule>","reminderAt":"<reminderAt>","startAt":"<startAt>","status":"pending","title":"<title>"},"idempotencyKey":"<idempotencyKey>","schemaVersion":"vision-todo-command.v1","targetReference":"00000000-0000-4000-8000-000000000001"}).encode(),
    headers={
    "Authorization": "Bearer <ACCESS_TOKEN>",
    "Accept": "application/json",
    "content-type": "application/json"
},
    method='POST',
)
with urllib.request.urlopen(request, timeout=30) as response:
    result = json.load(response)

Subtask Create

Set commandType to "subtask.create".

Field	Type	Rules	Description
commandType	"subtask.create"	required	Not described in the contract.
data	object	required	Not described in the contract.
data.taskId	string · uuid	optional; pattern ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}\|00000000-0000-0000-0000-000000000000\|ffffffff-ffff-ffff-ffff-ffffffffffff)$	Not described in the contract.
data.title	string	required; minimum length 1; maximum length 300	Not described in the contract.
idempotencyKey	string	required; minimum length 16; maximum length 160; pattern ^[A-Za-z0-9._:-]+$	Not described in the contract.
schemaVersion	"vision-todo-command.v1"	required	Not described in the contract.
targetReference	string · uuid	optional; pattern ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}\|00000000-0000-0000-0000-000000000000\|ffffffff-ffff-ffff-ffff-ffffffffffff)$	Not described in the contract.

Subtask Create — cURL

curl 'https://api.runonvision.com/api/todo/v1/commands' \
  --request POST \
  --header 'authorization: Bearer ***' \
  --header 'accept: application/json' \
  --header 'content-type: application/json' \
  --data '{
    "commandType": "subtask.create",
    "data": {
      "taskId": "00000000-0000-4000-8000-000000000001",
      "title": "<title>"
    },
    "idempotencyKey": "<idempotencyKey>",
    "schemaVersion": "vision-todo-command.v1",
    "targetReference": "00000000-0000-4000-8000-000000000001"
  }'

Subtask Create — JavaScript (server-side)

const response = await fetch('https://api.runonvision.com/api/todo/v1/commands', {
  method: 'POST',
  headers: {
  "authorization": "Bearer <ACCESS_TOKEN>",
  "accept": "application/json",
  "content-type": "application/json"
},
  body: JSON.stringify({
  "commandType": "subtask.create",
  "data": {
    "taskId": "00000000-0000-4000-8000-000000000001",
    "title": "<title>"
  },
  "idempotencyKey": "<idempotencyKey>",
  "schemaVersion": "vision-todo-command.v1",
  "targetReference": "00000000-0000-4000-8000-000000000001"
}),
})

if (!response.ok) throw new Error(`Vision API ${response.status}`)
const result = await response.json()

Subtask Create — Python 3 standard library

import json
import urllib.request

request = urllib.request.Request(
    'https://api.runonvision.com/api/todo/v1/commands',
    data=json.dumps({"commandType":"subtask.create","data":{"taskId":"00000000-0000-4000-8000-000000000001","title":"<title>"},"idempotencyKey":"<idempotencyKey>","schemaVersion":"vision-todo-command.v1","targetReference":"00000000-0000-4000-8000-000000000001"}).encode(),
    headers={
    "Authorization": "Bearer <ACCESS_TOKEN>",
    "Accept": "application/json",
    "content-type": "application/json"
},
    method='POST',
)
with urllib.request.urlopen(request, timeout=30) as response:
    result = json.load(response)

Subtask Set Done

Set commandType to "subtask.set_done".

Field	Type	Rules	Description
commandType	"subtask.set_done"	required	Not described in the contract.
data	object	required	Not described in the contract.
data.done	boolean \| true \| false	required	Not described in the contract.
idempotencyKey	string	required; minimum length 16; maximum length 160; pattern ^[A-Za-z0-9._:-]+$	Not described in the contract.
schemaVersion	"vision-todo-command.v1"	required	Not described in the contract.
targetReference	string · uuid	required; pattern ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}\|00000000-0000-0000-0000-000000000000\|ffffffff-ffff-ffff-ffff-ffffffffffff)$	Not described in the contract.

Subtask Set Done — cURL

curl 'https://api.runonvision.com/api/todo/v1/commands' \
  --request POST \
  --header 'authorization: Bearer ***' \
  --header 'accept: application/json' \
  --header 'content-type: application/json' \
  --data '{
    "commandType": "subtask.set_done",
    "data": {
      "done": true
    },
    "idempotencyKey": "<idempotencyKey>",
    "schemaVersion": "vision-todo-command.v1",
    "targetReference": "00000000-0000-4000-8000-000000000001"
  }'

Subtask Set Done — JavaScript (server-side)

const response = await fetch('https://api.runonvision.com/api/todo/v1/commands', {
  method: 'POST',
  headers: {
  "authorization": "Bearer <ACCESS_TOKEN>",
  "accept": "application/json",
  "content-type": "application/json"
},
  body: JSON.stringify({
  "commandType": "subtask.set_done",
  "data": {
    "done": true
  },
  "idempotencyKey": "<idempotencyKey>",
  "schemaVersion": "vision-todo-command.v1",
  "targetReference": "00000000-0000-4000-8000-000000000001"
}),
})

if (!response.ok) throw new Error(`Vision API ${response.status}`)
const result = await response.json()

Subtask Set Done — Python 3 standard library

import json
import urllib.request

request = urllib.request.Request(
    'https://api.runonvision.com/api/todo/v1/commands',
    data=json.dumps({"commandType":"subtask.set_done","data":{"done":true},"idempotencyKey":"<idempotencyKey>","schemaVersion":"vision-todo-command.v1","targetReference":"00000000-0000-4000-8000-000000000001"}).encode(),
    headers={
    "Authorization": "Bearer <ACCESS_TOKEN>",
    "Accept": "application/json",
    "content-type": "application/json"
},
    method='POST',
)
with urllib.request.urlopen(request, timeout=30) as response:
    result = json.load(response)

Subtask Rename

Set commandType to "subtask.rename".

Field	Type	Rules	Description
commandType	"subtask.rename"	required	Not described in the contract.
data	object	required	Not described in the contract.
data.title	string	required; minimum length 1; maximum length 300	Not described in the contract.
idempotencyKey	string	required; minimum length 16; maximum length 160; pattern ^[A-Za-z0-9._:-]+$	Not described in the contract.
schemaVersion	"vision-todo-command.v1"	required	Not described in the contract.
targetReference	string · uuid	required; pattern ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}\|00000000-0000-0000-0000-000000000000\|ffffffff-ffff-ffff-ffff-ffffffffffff)$	Not described in the contract.

Subtask Rename — cURL

curl 'https://api.runonvision.com/api/todo/v1/commands' \
  --request POST \
  --header 'authorization: Bearer ***' \
  --header 'accept: application/json' \
  --header 'content-type: application/json' \
  --data '{
    "commandType": "subtask.rename",
    "data": {
      "title": "<title>"
    },
    "idempotencyKey": "<idempotencyKey>",
    "schemaVersion": "vision-todo-command.v1",
    "targetReference": "00000000-0000-4000-8000-000000000001"
  }'

Subtask Rename — JavaScript (server-side)

const response = await fetch('https://api.runonvision.com/api/todo/v1/commands', {
  method: 'POST',
  headers: {
  "authorization": "Bearer <ACCESS_TOKEN>",
  "accept": "application/json",
  "content-type": "application/json"
},
  body: JSON.stringify({
  "commandType": "subtask.rename",
  "data": {
    "title": "<title>"
  },
  "idempotencyKey": "<idempotencyKey>",
  "schemaVersion": "vision-todo-command.v1",
  "targetReference": "00000000-0000-4000-8000-000000000001"
}),
})

if (!response.ok) throw new Error(`Vision API ${response.status}`)
const result = await response.json()

Subtask Rename — Python 3 standard library

import json
import urllib.request

request = urllib.request.Request(
    'https://api.runonvision.com/api/todo/v1/commands',
    data=json.dumps({"commandType":"subtask.rename","data":{"title":"<title>"},"idempotencyKey":"<idempotencyKey>","schemaVersion":"vision-todo-command.v1","targetReference":"00000000-0000-4000-8000-000000000001"}).encode(),
    headers={
    "Authorization": "Bearer <ACCESS_TOKEN>",
    "Accept": "application/json",
    "content-type": "application/json"
},
    method='POST',
)
with urllib.request.urlopen(request, timeout=30) as response:
    result = json.load(response)

Subtask Delete

Set commandType to "subtask.delete".

Field	Type	Rules	Description
commandType	"subtask.delete"	required	Not described in the contract.
data	object	optional	Not described in the contract.
idempotencyKey	string	required; minimum length 16; maximum length 160; pattern ^[A-Za-z0-9._:-]+$	Not described in the contract.
schemaVersion	"vision-todo-command.v1"	required	Not described in the contract.
targetReference	string · uuid	required; pattern ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}\|00000000-0000-0000-0000-000000000000\|ffffffff-ffff-ffff-ffff-ffffffffffff)$	Not described in the contract.

Subtask Delete — cURL

curl 'https://api.runonvision.com/api/todo/v1/commands' \
  --request POST \
  --header 'authorization: Bearer ***' \
  --header 'accept: application/json' \
  --header 'content-type: application/json' \
  --data '{
    "commandType": "subtask.delete",
    "data": {},
    "idempotencyKey": "<idempotencyKey>",
    "schemaVersion": "vision-todo-command.v1",
    "targetReference": "00000000-0000-4000-8000-000000000001"
  }'

Subtask Delete — JavaScript (server-side)

const response = await fetch('https://api.runonvision.com/api/todo/v1/commands', {
  method: 'POST',
  headers: {
  "authorization": "Bearer <ACCESS_TOKEN>",
  "accept": "application/json",
  "content-type": "application/json"
},
  body: JSON.stringify({
  "commandType": "subtask.delete",
  "data": {},
  "idempotencyKey": "<idempotencyKey>",
  "schemaVersion": "vision-todo-command.v1",
  "targetReference": "00000000-0000-4000-8000-000000000001"
}),
})

if (!response.ok) throw new Error(`Vision API ${response.status}`)
const result = await response.json()

Subtask Delete — Python 3 standard library

import json
import urllib.request

request = urllib.request.Request(
    'https://api.runonvision.com/api/todo/v1/commands',
    data=json.dumps({"commandType":"subtask.delete","data":{},"idempotencyKey":"<idempotencyKey>","schemaVersion":"vision-todo-command.v1","targetReference":"00000000-0000-4000-8000-000000000001"}).encode(),
    headers={
    "Authorization": "Bearer <ACCESS_TOKEN>",
    "Accept": "application/json",
    "content-type": "application/json"
},
    method='POST',
)
with urllib.request.urlopen(request, timeout=30) as response:
    result = json.load(response)

Task Delete

Set commandType to "task.delete".

Field	Type	Rules	Description
commandType	"task.delete"	required	Not described in the contract.
data	object	optional	Not described in the contract.
idempotencyKey	string	required; minimum length 16; maximum length 160; pattern ^[A-Za-z0-9._:-]+$	Not described in the contract.
schemaVersion	"vision-todo-command.v1"	required	Not described in the contract.
targetReference	string · uuid	required; pattern ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}\|00000000-0000-0000-0000-000000000000\|ffffffff-ffff-ffff-ffff-ffffffffffff)$	Not described in the contract.

Task Delete — cURL

curl 'https://api.runonvision.com/api/todo/v1/commands' \
  --request POST \
  --header 'authorization: Bearer ***' \
  --header 'accept: application/json' \
  --header 'content-type: application/json' \
  --data '{
    "commandType": "task.delete",
    "data": {},
    "idempotencyKey": "<idempotencyKey>",
    "schemaVersion": "vision-todo-command.v1",
    "targetReference": "00000000-0000-4000-8000-000000000001"
  }'

Task Delete — JavaScript (server-side)

const response = await fetch('https://api.runonvision.com/api/todo/v1/commands', {
  method: 'POST',
  headers: {
  "authorization": "Bearer <ACCESS_TOKEN>",
  "accept": "application/json",
  "content-type": "application/json"
},
  body: JSON.stringify({
  "commandType": "task.delete",
  "data": {},
  "idempotencyKey": "<idempotencyKey>",
  "schemaVersion": "vision-todo-command.v1",
  "targetReference": "00000000-0000-4000-8000-000000000001"
}),
})

if (!response.ok) throw new Error(`Vision API ${response.status}`)
const result = await response.json()

Task Delete — Python 3 standard library

import json
import urllib.request

request = urllib.request.Request(
    'https://api.runonvision.com/api/todo/v1/commands',
    data=json.dumps({"commandType":"task.delete","data":{},"idempotencyKey":"<idempotencyKey>","schemaVersion":"vision-todo-command.v1","targetReference":"00000000-0000-4000-8000-000000000001"}).encode(),
    headers={
    "Authorization": "Bearer <ACCESS_TOKEN>",
    "Accept": "application/json",
    "content-type": "application/json"
},
    method='POST',
)
with urllib.request.urlopen(request, timeout=30) as response:
    result = json.load(response)

List Create

Set commandType to "list.create".

Field	Type	Rules	Description
commandType	"list.create"	required	Not described in the contract.
data	object	required	Not described in the contract.
data.color	string \| null	optional	Not described in the contract.
data.name	string	required; minimum length 1; maximum length 120	Not described in the contract.
idempotencyKey	string	required; minimum length 16; maximum length 160; pattern ^[A-Za-z0-9._:-]+$	Not described in the contract.
schemaVersion	"vision-todo-command.v1"	required	Not described in the contract.

List Create — cURL

curl 'https://api.runonvision.com/api/todo/v1/commands' \
  --request POST \
  --header 'authorization: Bearer ***' \
  --header 'accept: application/json' \
  --header 'content-type: application/json' \
  --data '{
    "commandType": "list.create",
    "data": {
      "color": "<color>",
      "name": "<name>"
    },
    "idempotencyKey": "<idempotencyKey>",
    "schemaVersion": "vision-todo-command.v1"
  }'

List Create — JavaScript (server-side)

const response = await fetch('https://api.runonvision.com/api/todo/v1/commands', {
  method: 'POST',
  headers: {
  "authorization": "Bearer <ACCESS_TOKEN>",
  "accept": "application/json",
  "content-type": "application/json"
},
  body: JSON.stringify({
  "commandType": "list.create",
  "data": {
    "color": "<color>",
    "name": "<name>"
  },
  "idempotencyKey": "<idempotencyKey>",
  "schemaVersion": "vision-todo-command.v1"
}),
})

if (!response.ok) throw new Error(`Vision API ${response.status}`)
const result = await response.json()

List Create — Python 3 standard library

import json
import urllib.request

request = urllib.request.Request(
    'https://api.runonvision.com/api/todo/v1/commands',
    data=json.dumps({"commandType":"list.create","data":{"color":"<color>","name":"<name>"},"idempotencyKey":"<idempotencyKey>","schemaVersion":"vision-todo-command.v1"}).encode(),
    headers={
    "Authorization": "Bearer <ACCESS_TOKEN>",
    "Accept": "application/json",
    "content-type": "application/json"
},
    method='POST',
)
with urllib.request.urlopen(request, timeout=30) as response:
    result = json.load(response)

List Rename

Set commandType to "list.rename".

Field	Type	Rules	Description
commandType	"list.rename"	required	Not described in the contract.
data	object	required	Not described in the contract.
data.color	string \| null	optional	Not described in the contract.
data.name	string	required; minimum length 1; maximum length 120	Not described in the contract.
idempotencyKey	string	required; minimum length 16; maximum length 160; pattern ^[A-Za-z0-9._:-]+$	Not described in the contract.
schemaVersion	"vision-todo-command.v1"	required	Not described in the contract.
targetReference	string · uuid	required; pattern ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}\|00000000-0000-0000-0000-000000000000\|ffffffff-ffff-ffff-ffff-ffffffffffff)$	Not described in the contract.

List Rename — cURL

curl 'https://api.runonvision.com/api/todo/v1/commands' \
  --request POST \
  --header 'authorization: Bearer ***' \
  --header 'accept: application/json' \
  --header 'content-type: application/json' \
  --data '{
    "commandType": "list.rename",
    "data": {
      "color": "<color>",
      "name": "<name>"
    },
    "idempotencyKey": "<idempotencyKey>",
    "schemaVersion": "vision-todo-command.v1",
    "targetReference": "00000000-0000-4000-8000-000000000001"
  }'

List Rename — JavaScript (server-side)

const response = await fetch('https://api.runonvision.com/api/todo/v1/commands', {
  method: 'POST',
  headers: {
  "authorization": "Bearer <ACCESS_TOKEN>",
  "accept": "application/json",
  "content-type": "application/json"
},
  body: JSON.stringify({
  "commandType": "list.rename",
  "data": {
    "color": "<color>",
    "name": "<name>"
  },
  "idempotencyKey": "<idempotencyKey>",
  "schemaVersion": "vision-todo-command.v1",
  "targetReference": "00000000-0000-4000-8000-000000000001"
}),
})

if (!response.ok) throw new Error(`Vision API ${response.status}`)
const result = await response.json()

List Rename — Python 3 standard library

import json
import urllib.request

request = urllib.request.Request(
    'https://api.runonvision.com/api/todo/v1/commands',
    data=json.dumps({"commandType":"list.rename","data":{"color":"<color>","name":"<name>"},"idempotencyKey":"<idempotencyKey>","schemaVersion":"vision-todo-command.v1","targetReference":"00000000-0000-4000-8000-000000000001"}).encode(),
    headers={
    "Authorization": "Bearer <ACCESS_TOKEN>",
    "Accept": "application/json",
    "content-type": "application/json"
},
    method='POST',
)
with urllib.request.urlopen(request, timeout=30) as response:
    result = json.load(response)

List Set Color

Set commandType to "list.set_color".

Field	Type	Rules	Description
commandType	"list.set_color"	required	Not described in the contract.
data	object	required	Not described in the contract.
data.color	string \| null	optional	Not described in the contract.
idempotencyKey	string	required; minimum length 16; maximum length 160; pattern ^[A-Za-z0-9._:-]+$	Not described in the contract.
schemaVersion	"vision-todo-command.v1"	required	Not described in the contract.
targetReference	string · uuid	required; pattern ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}\|00000000-0000-0000-0000-000000000000\|ffffffff-ffff-ffff-ffff-ffffffffffff)$	Not described in the contract.

List Set Color — cURL

curl 'https://api.runonvision.com/api/todo/v1/commands' \
  --request POST \
  --header 'authorization: Bearer ***' \
  --header 'accept: application/json' \
  --header 'content-type: application/json' \
  --data '{
    "commandType": "list.set_color",
    "data": {
      "color": "<color>"
    },
    "idempotencyKey": "<idempotencyKey>",
    "schemaVersion": "vision-todo-command.v1",
    "targetReference": "00000000-0000-4000-8000-000000000001"
  }'

List Set Color — JavaScript (server-side)

const response = await fetch('https://api.runonvision.com/api/todo/v1/commands', {
  method: 'POST',
  headers: {
  "authorization": "Bearer <ACCESS_TOKEN>",
  "accept": "application/json",
  "content-type": "application/json"
},
  body: JSON.stringify({
  "commandType": "list.set_color",
  "data": {
    "color": "<color>"
  },
  "idempotencyKey": "<idempotencyKey>",
  "schemaVersion": "vision-todo-command.v1",
  "targetReference": "00000000-0000-4000-8000-000000000001"
}),
})

if (!response.ok) throw new Error(`Vision API ${response.status}`)
const result = await response.json()

List Set Color — Python 3 standard library

import json
import urllib.request

request = urllib.request.Request(
    'https://api.runonvision.com/api/todo/v1/commands',
    data=json.dumps({"commandType":"list.set_color","data":{"color":"<color>"},"idempotencyKey":"<idempotencyKey>","schemaVersion":"vision-todo-command.v1","targetReference":"00000000-0000-4000-8000-000000000001"}).encode(),
    headers={
    "Authorization": "Bearer <ACCESS_TOKEN>",
    "Accept": "application/json",
    "content-type": "application/json"
},
    method='POST',
)
with urllib.request.urlopen(request, timeout=30) as response:
    result = json.load(response)

List Delete

Set commandType to "list.delete".

Field	Type	Rules	Description
commandType	"list.delete"	required	Not described in the contract.
data	object	optional	Not described in the contract.
data.moveToListId	string · uuid	optional; pattern ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}\|00000000-0000-0000-0000-000000000000\|ffffffff-ffff-ffff-ffff-ffffffffffff)$	Not described in the contract.
data.tasks	move \| delete	optional	Not described in the contract.
idempotencyKey	string	required; minimum length 16; maximum length 160; pattern ^[A-Za-z0-9._:-]+$	Not described in the contract.
schemaVersion	"vision-todo-command.v1"	required	Not described in the contract.
targetReference	string · uuid	required; pattern ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}\|00000000-0000-0000-0000-000000000000\|ffffffff-ffff-ffff-ffff-ffffffffffff)$	Not described in the contract.

List Delete — cURL

curl 'https://api.runonvision.com/api/todo/v1/commands' \
  --request POST \
  --header 'authorization: Bearer ***' \
  --header 'accept: application/json' \
  --header 'content-type: application/json' \
  --data '{
    "commandType": "list.delete",
    "data": {
      "moveToListId": "00000000-0000-4000-8000-000000000001",
      "tasks": "move"
    },
    "idempotencyKey": "<idempotencyKey>",
    "schemaVersion": "vision-todo-command.v1",
    "targetReference": "00000000-0000-4000-8000-000000000001"
  }'

List Delete — JavaScript (server-side)

const response = await fetch('https://api.runonvision.com/api/todo/v1/commands', {
  method: 'POST',
  headers: {
  "authorization": "Bearer <ACCESS_TOKEN>",
  "accept": "application/json",
  "content-type": "application/json"
},
  body: JSON.stringify({
  "commandType": "list.delete",
  "data": {
    "moveToListId": "00000000-0000-4000-8000-000000000001",
    "tasks": "move"
  },
  "idempotencyKey": "<idempotencyKey>",
  "schemaVersion": "vision-todo-command.v1",
  "targetReference": "00000000-0000-4000-8000-000000000001"
}),
})

if (!response.ok) throw new Error(`Vision API ${response.status}`)
const result = await response.json()

List Delete — Python 3 standard library

import json
import urllib.request

request = urllib.request.Request(
    'https://api.runonvision.com/api/todo/v1/commands',
    data=json.dumps({"commandType":"list.delete","data":{"moveToListId":"00000000-0000-4000-8000-000000000001","tasks":"move"},"idempotencyKey":"<idempotencyKey>","schemaVersion":"vision-todo-command.v1","targetReference":"00000000-0000-4000-8000-000000000001"}).encode(),
    headers={
    "Authorization": "Bearer <ACCESS_TOKEN>",
    "Accept": "application/json",
    "content-type": "application/json"
},
    method='POST',
)
with urllib.request.urlopen(request, timeout=30) as response:
    result = json.load(response)

List Archive

Set commandType to "list.archive".

Field	Type	Rules	Description
commandType	"list.archive"	required	Not described in the contract.
data	object	optional	Not described in the contract.
idempotencyKey	string	required; minimum length 16; maximum length 160; pattern ^[A-Za-z0-9._:-]+$	Not described in the contract.
schemaVersion	"vision-todo-command.v1"	required	Not described in the contract.
targetReference	string · uuid	required; pattern ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}\|00000000-0000-0000-0000-000000000000\|ffffffff-ffff-ffff-ffff-ffffffffffff)$	Not described in the contract.

List Archive — cURL

curl 'https://api.runonvision.com/api/todo/v1/commands' \
  --request POST \
  --header 'authorization: Bearer ***' \
  --header 'accept: application/json' \
  --header 'content-type: application/json' \
  --data '{
    "commandType": "list.archive",
    "data": {},
    "idempotencyKey": "<idempotencyKey>",
    "schemaVersion": "vision-todo-command.v1",
    "targetReference": "00000000-0000-4000-8000-000000000001"
  }'

List Archive — JavaScript (server-side)

const response = await fetch('https://api.runonvision.com/api/todo/v1/commands', {
  method: 'POST',
  headers: {
  "authorization": "Bearer <ACCESS_TOKEN>",
  "accept": "application/json",
  "content-type": "application/json"
},
  body: JSON.stringify({
  "commandType": "list.archive",
  "data": {},
  "idempotencyKey": "<idempotencyKey>",
  "schemaVersion": "vision-todo-command.v1",
  "targetReference": "00000000-0000-4000-8000-000000000001"
}),
})

if (!response.ok) throw new Error(`Vision API ${response.status}`)
const result = await response.json()

List Archive — Python 3 standard library

import json
import urllib.request

request = urllib.request.Request(
    'https://api.runonvision.com/api/todo/v1/commands',
    data=json.dumps({"commandType":"list.archive","data":{},"idempotencyKey":"<idempotencyKey>","schemaVersion":"vision-todo-command.v1","targetReference":"00000000-0000-4000-8000-000000000001"}).encode(),
    headers={
    "Authorization": "Bearer <ACCESS_TOKEN>",
    "Accept": "application/json",
    "content-type": "application/json"
},
    method='POST',
)
with urllib.request.urlopen(request, timeout=30) as response:
    result = json.load(response)

List Restore

Set commandType to "list.restore".

Field	Type	Rules	Description
commandType	"list.restore"	required	Not described in the contract.
data	object	optional	Not described in the contract.
idempotencyKey	string	required; minimum length 16; maximum length 160; pattern ^[A-Za-z0-9._:-]+$	Not described in the contract.
schemaVersion	"vision-todo-command.v1"	required	Not described in the contract.
targetReference	string · uuid	required; pattern ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}\|00000000-0000-0000-0000-000000000000\|ffffffff-ffff-ffff-ffff-ffffffffffff)$	Not described in the contract.

List Restore — cURL

curl 'https://api.runonvision.com/api/todo/v1/commands' \
  --request POST \
  --header 'authorization: Bearer ***' \
  --header 'accept: application/json' \
  --header 'content-type: application/json' \
  --data '{
    "commandType": "list.restore",
    "data": {},
    "idempotencyKey": "<idempotencyKey>",
    "schemaVersion": "vision-todo-command.v1",
    "targetReference": "00000000-0000-4000-8000-000000000001"
  }'

List Restore — JavaScript (server-side)

const response = await fetch('https://api.runonvision.com/api/todo/v1/commands', {
  method: 'POST',
  headers: {
  "authorization": "Bearer <ACCESS_TOKEN>",
  "accept": "application/json",
  "content-type": "application/json"
},
  body: JSON.stringify({
  "commandType": "list.restore",
  "data": {},
  "idempotencyKey": "<idempotencyKey>",
  "schemaVersion": "vision-todo-command.v1",
  "targetReference": "00000000-0000-4000-8000-000000000001"
}),
})

if (!response.ok) throw new Error(`Vision API ${response.status}`)
const result = await response.json()

List Restore — Python 3 standard library

import json
import urllib.request

request = urllib.request.Request(
    'https://api.runonvision.com/api/todo/v1/commands',
    data=json.dumps({"commandType":"list.restore","data":{},"idempotencyKey":"<idempotencyKey>","schemaVersion":"vision-todo-command.v1","targetReference":"00000000-0000-4000-8000-000000000001"}).encode(),
    headers={
    "Authorization": "Bearer <ACCESS_TOKEN>",
    "Accept": "application/json",
    "content-type": "application/json"
},
    method='POST',
)
with urllib.request.urlopen(request, timeout=30) as response:
    result = json.load(response)

Reminder Create

Set commandType to "reminder.create".

Field	Type	Rules	Description
commandType	"reminder.create"	required	Not described in the contract.
data	object	required	Not described in the contract.
data.anchor	absolute \| before_start \| before_due \| before_deadline	optional; default "absolute"	Not described in the contract.
data.channel	in_app \| email \| push	optional	Not described in the contract.
data.note	string \| null	optional	Not described in the contract.
data.offsetMinutes	integer \| null	optional	Not described in the contract.
data.remindAt	string \| null	optional	Not described in the contract.
data.taskId	string · uuid	required; pattern ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}\|00000000-0000-0000-0000-000000000000\|ffffffff-ffff-ffff-ffff-ffffffffffff)$	Not described in the contract.
idempotencyKey	string	required; minimum length 16; maximum length 160; pattern ^[A-Za-z0-9._:-]+$	Not described in the contract.
schemaVersion	"vision-todo-command.v1"	required	Not described in the contract.

Reminder Create — cURL

curl 'https://api.runonvision.com/api/todo/v1/commands' \
  --request POST \
  --header 'authorization: Bearer ***' \
  --header 'accept: application/json' \
  --header 'content-type: application/json' \
  --data '{
    "commandType": "reminder.create",
    "data": {
      "anchor": "absolute",
      "channel": "in_app",
      "note": "<note>",
      "offsetMinutes": 0,
      "remindAt": "<remindAt>",
      "taskId": "00000000-0000-4000-8000-000000000001"
    },
    "idempotencyKey": "<idempotencyKey>",
    "schemaVersion": "vision-todo-command.v1"
  }'

Reminder Create — JavaScript (server-side)

const response = await fetch('https://api.runonvision.com/api/todo/v1/commands', {
  method: 'POST',
  headers: {
  "authorization": "Bearer <ACCESS_TOKEN>",
  "accept": "application/json",
  "content-type": "application/json"
},
  body: JSON.stringify({
  "commandType": "reminder.create",
  "data": {
    "anchor": "absolute",
    "channel": "in_app",
    "note": "<note>",
    "offsetMinutes": 0,
    "remindAt": "<remindAt>",
    "taskId": "00000000-0000-4000-8000-000000000001"
  },
  "idempotencyKey": "<idempotencyKey>",
  "schemaVersion": "vision-todo-command.v1"
}),
})

if (!response.ok) throw new Error(`Vision API ${response.status}`)
const result = await response.json()

Reminder Create — Python 3 standard library

import json
import urllib.request

request = urllib.request.Request(
    'https://api.runonvision.com/api/todo/v1/commands',
    data=json.dumps({"commandType":"reminder.create","data":{"anchor":"absolute","channel":"in_app","note":"<note>","offsetMinutes":0,"remindAt":"<remindAt>","taskId":"00000000-0000-4000-8000-000000000001"},"idempotencyKey":"<idempotencyKey>","schemaVersion":"vision-todo-command.v1"}).encode(),
    headers={
    "Authorization": "Bearer <ACCESS_TOKEN>",
    "Accept": "application/json",
    "content-type": "application/json"
},
    method='POST',
)
with urllib.request.urlopen(request, timeout=30) as response:
    result = json.load(response)

Reminder Delete

Set commandType to "reminder.delete".

Field	Type	Rules	Description
commandType	"reminder.delete"	required	Not described in the contract.
data	object	optional	Not described in the contract.
idempotencyKey	string	required; minimum length 16; maximum length 160; pattern ^[A-Za-z0-9._:-]+$	Not described in the contract.
schemaVersion	"vision-todo-command.v1"	required	Not described in the contract.
targetReference	string · uuid	required; pattern ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}\|00000000-0000-0000-0000-000000000000\|ffffffff-ffff-ffff-ffff-ffffffffffff)$	Not described in the contract.

Reminder Delete — cURL

curl 'https://api.runonvision.com/api/todo/v1/commands' \
  --request POST \
  --header 'authorization: Bearer ***' \
  --header 'accept: application/json' \
  --header 'content-type: application/json' \
  --data '{
    "commandType": "reminder.delete",
    "data": {},
    "idempotencyKey": "<idempotencyKey>",
    "schemaVersion": "vision-todo-command.v1",
    "targetReference": "00000000-0000-4000-8000-000000000001"
  }'

Reminder Delete — JavaScript (server-side)

const response = await fetch('https://api.runonvision.com/api/todo/v1/commands', {
  method: 'POST',
  headers: {
  "authorization": "Bearer <ACCESS_TOKEN>",
  "accept": "application/json",
  "content-type": "application/json"
},
  body: JSON.stringify({
  "commandType": "reminder.delete",
  "data": {},
  "idempotencyKey": "<idempotencyKey>",
  "schemaVersion": "vision-todo-command.v1",
  "targetReference": "00000000-0000-4000-8000-000000000001"
}),
})

if (!response.ok) throw new Error(`Vision API ${response.status}`)
const result = await response.json()

Reminder Delete — Python 3 standard library

import json
import urllib.request

request = urllib.request.Request(
    'https://api.runonvision.com/api/todo/v1/commands',
    data=json.dumps({"commandType":"reminder.delete","data":{},"idempotencyKey":"<idempotencyKey>","schemaVersion":"vision-todo-command.v1","targetReference":"00000000-0000-4000-8000-000000000001"}).encode(),
    headers={
    "Authorization": "Bearer <ACCESS_TOKEN>",
    "Accept": "application/json",
    "content-type": "application/json"
},
    method='POST',
)
with urllib.request.urlopen(request, timeout=30) as response:
    result = json.load(response)

The current TypeScript reference client covers Platform token exchange and core reads. No native SDK helper is declared for this operation; use the HTTP contract directly and follow the SDK guidance.

Responses

Status	Meaning	Schema
200	Successful response	object
201	Successful response	object
400	Invalid request parameters or body (INVALID_REQUEST)	object
401	Vision credential missing or invalid (AUTHENTICATION_REQUIRED or INVALID_CREDENTIAL)	object
403	Scope, grant, identity class, or workspace role denied (PERMISSION_DENIED)	object
404	Requested task, list, subtask, reminder, or other command target was not found (NOT_FOUND)	object
409	Idempotency-key conflict or command rejected in the target's current state (INVALID_REQUEST)	object
413	Command request body exceeds the 32 KiB payload limit (INVALID_REQUEST)	object
503	Database, authorization dependency, or other required dependency unavailable (DEPENDENCY_UNAVAILABLE)	object

Success response schema

Field	Type	Rules	Description
commandReference	string	required; pattern ^TCM-[A-F0-9]{12}$	Not described in the contract.
commandType	task.set_status \| task.set_starred \| task.set_archived \| task.create \| task.update \| subtask.create \| subtask.set_done \| subtask.rename \| subtask.delete \| task.delete \| list.create \| list.rename \| list.set_color \| list.delete \| list.archive \| list.restore \| reminder.create \| reminder.delete	required	Not described in the contract.
replayed	boolean	required	Not described in the contract.
schemaVersion	"vision-todo-command-result.v1"	required	Not described in the contract.
targetReference	string · uuid	required; pattern ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}\|00000000-0000-0000-0000-000000000000\|ffffffff-ffff-ffff-ffff-ffffffffffff)$	Not described in the contract.

200 illustrative response

{
  "commandReference": "<commandReference>",
  "commandType": "task.set_status",
  "replayed": true,
  "schemaVersion": "vision-todo-command-result.v1",
  "targetReference": "00000000-0000-4000-8000-000000000001"
}

Errors and troubleshooting

Error bodies and codes are shown only where the approved contract declares them. Use status, the declared error schema, and any correlation identifier returned by the App; do not infer that two Apps share one envelope.

400 — Invalid request parameters or body (INVALID_REQUEST)
401 — Vision credential missing or invalid (AUTHENTICATION_REQUIRED or INVALID_CREDENTIAL)
403 — Scope, grant, identity class, or workspace role denied (PERMISSION_DENIED)
404 — Requested task, list, subtask, reminder, or other command target was not found (NOT_FOUND)
409 — Idempotency-key conflict or command rejected in the target's current state (INVALID_REQUEST)
413 — Command request body exceeds the 32 KiB payload limit (INVALID_REQUEST)
503 — Database, authorization dependency, or other required dependency unavailable (DEPENDENCY_UNAVAILABLE)

Collection behavior

Pagination: not declared. Filtering/search: not declared. Sorting: not declared.

Cursor lifetime, cursor binding, stable ordering, maximum traversal, and unknown-filter behavior are not assumed unless stated by a parameter description or schema constraint above.

Operational behavior

Rate limit: No operation-specific limit or 429 response is declared.
Retry: Retry only when the documented error model or response headers authorize it. Timeout and backoff values are not declared by this operation.
Idempotency: No idempotency header or replay window is declared.
Concurrency: No ETag, If-Match, or optimistic-version header is declared.

Security and privacy

Keep client credentials and bearer tokens on trusted servers.
Send only to the exact approved HTTPS origin and audience.
Treat response data according to the owning App's classification and retention policy; the OpenAPI contract does not itself grant data access.
Do not log credentials, tokens, complete private payloads, or secrets.

Edge cases and known documentation gaps

Business roles, timeout, retry budget, rate value, idempotency window, and concurrency behavior are absent unless explicitly stated above.

POST /api/todo/v1/contributions/complete — command /api/todo/v1/contributions/complete

Contract history and evidence

Contract version: 1.9.0
Approved snapshot SHA-256: fbbb5025760ff823af1749662c9eb4ea335a8d5f8cc732d77a943e67a4b867d4
Approval: Anthony, 2026-11-03T01:23:29.221Z (anthony-docs-live-20261102)
Download the authoritative OpenAPI 3.1 snapshot

command /api/todo/v1/commands

Purpose and use cases

Request

Authentication and authorization

Headers

Path and query parameters

Request body

Runnable examples

Task Set Status

Task Set Starred

Task Set Archived

Task Create

Task Update

Subtask Create

Subtask Set Done

Subtask Rename

Subtask Delete

Task Delete

List Create

List Rename

List Set Color

List Delete

List Archive

List Restore

Reminder Create

Reminder Delete

Responses

Success response schema

Errors and troubleshooting

Collection behavior

Operational behavior

Security and privacy

Edge cases and known documentation gaps

Related operations and workflows

Contract history and evidence