Task · StartupBuilder

Properties

Property	Type	Description
`due`	`datetime`	When the Task is due.
`priority`	`integer`	Its rank in the inbox, highest first.
`recurrence`	`string`	The schedule a recurring duty repeats on.

Inherited from Action: 11 properties

Property	Type	Required	Description
`status`	`string`	required	One of `pending`, `done`, `failed`, `canceled`, or `refused`.
`reason`	`string`		Why a pending Action waits: `queued`, `running`, `retrying`, `awaitingWorker`, `awaitingInput`, `awaitingSource`, `awaitingAction`, or `awaitingTime`.
`mode`	`string`	required	How the caller invoked it: `try`, `send`, or `do`.
`by`	Worker		The Worker that performed it.
`for`	Party		The Party it was done on behalf of.
`via`	`string`		The Interface or request it arrived through.
`on`	`string`		The Action or Event that caused it, such as the failed attempt a retry follows.
`thing`	`string`		The record, at the Version the Action was decided against.
`input`	`json`		The input it was called with.
`createdAt`	`datetime`		When it was called.
`reserved`	`money`		The most this Action may cost, held against its Limits from the check until it settles, billed misses included.

Object

JSON

{
  "$id": "https://api.sb/routewise.dev/tasks/task_1",
  "$type": "Task",
  "status": "pending",
  "reason": "queued",
  "mode": "try",
  "by": "worker_1",
  "for": "party_1",
  "via": "API",
  "on": "Invoice.overdue",
  "thing": "invoice_1@v3",
  "input": {},
  "createdAt": "2026-10-22T12:00:00Z",
  "reserved": {
    "amount": 25,
    "currency": "USD"
  },
  "due": "2026-10-22T12:00:00Z",
  "priority": 1,
  "recurrence": "Weekly on Friday"
}

Relationships

A Task is assigned to one Worker: the Worker a Task waits on; the Task sits in that Worker’s inbox until it is done. assignedTo, inverse tasks.
A Task has one Project: a Project is made of Tasks. project, inverse plans.

Verbs

createCreates a Task.
POST /{namespace}/tasksdoTask.created
getReturns one Task by id.
GET /{namespace}/tasks/{id}readNo Event
listReturns Tasks, newest first, one page at a time.
GET /{namespace}/tasksreadNo Event
updateChanges the given properties of a Task.
PATCH /{namespace}/tasks/{id}doTask.updated
deleteDeletes a Task; its history is kept.
DELETE /{namespace}/tasks/{id}doTask.deleted
assignAssign gives a Task to a Worker, human or agent, and places it in that Worker’s worklist.
POST /{namespace}/tasks/{task}/assigndoTask.assigned
claimClaim takes an offered Task from a shared queue or a handoff and makes the calling Worker its assignee.
POST /{namespace}/tasks/{task}/claimdoTask.claimed
completeComplete marks a Task done and resumes the Action that waited on it.
POST /{namespace}/tasks/{task}/completedoTask.completed
delegateDelegate passes a Task to another Role along a declared handoff and keeps its history.
POST /{namespace}/tasks/{task}/delegatedoTask.delegated
escalateEscalate moves a Task to the Role its current Role escalates to, with the reason attached.
POST /{namespace}/tasks/{task}/escalatedoTask.escalated
nextNext returns the oldest open Task the calling Worker’s Roles may claim, without claiming it.
POST /{namespace}/tasks/nextdoTask.offered
returnReturn hands an offered Task back to its sender, unchanged, with the reason the receiver cannot take it.
POST /{namespace}/tasks/{task}/returndoTask.returned

Permissions

Which Access level may call each Verb. One-way Verbs wait their delay window.

Operation	`owner`	`admin`	`member`	`viewer`
`Task.create`	Yes	Yes	Yes	No
`Task.get`	Yes	Yes	Yes	Yes
`Task.list`	Yes	Yes	Yes	Yes
`Task.update`	Yes	Yes	Yes	No
`Task.delete`	Yes	Yes	Yes	No
`Task.assign`	Yes	Yes	Yes	No
`Task.claim`	Yes	Yes	Yes	No
`Task.complete`	Yes	Yes	Yes	No
`Task.delegate`	Yes	Yes	Yes	No
`Task.escalate`	Yes	Yes	Yes	No
`Task.next`	Yes	Yes	Yes	No
`Task.return`	Yes	Yes	Yes	No

Call it

Text

Assign the latest task with a worker.

Example

A parent asks a tutoring marketplace to reschedule. The reply is a Task assigned to the Customer Lead, due in 15 minutes, at the top of its inbox.

PropertiesCopy Anchor Link

ObjectCopy Anchor Link

RelationshipsCopy Anchor Link

VerbsCopy Anchor Link

PermissionsCopy Anchor Link

Call itCopy Anchor Link

ExampleCopy Anchor Link