Create a task
Tasks are contract templates. They define the condition and settlement window for your outcomes.
Tasks are created and managed in the dashboard at app.thewitn.com/dashboard/tasks.
What is a task?
A task is a named template. It defines two things:
- The billable condition: the boolean rule that must be satisfied for the outcome to confirm.
- The settlement window: how long witn waits after the latest event before making the current result final.
The snapshot model
When you open an outcome, witn copies the task's contract onto the outcome. After that, the outcome is independent. Changing the task does not affect open outcomes.
This means you can update a task at any time without changing the behavior of existing outcomes.
Each outcome uses the contract that was in effect when it was opened. If you need a different contract for new outcomes, update the task before opening them.
Contract fields
| Field | Type | Description |
|---|---|---|
settlement_period | integer (seconds) | How long witn waits after the latest event before the outcome resolves. Default: 259,200 (72 hours). Min 1, max 15,552,000 (180 days). |
condition | object | The billable condition. See Billable conditions. |
When the settlement window expires, if the condition was met the outcome confirms; if not, it is missed.
Prices live on rate cards
Tasks do not have a price. The price is set on the rate card entry for that task. This means you can charge different customers different prices for the same task.
To set a price, create or update a rate card and add an entry for the task.
Creating a task
Go to Tasks in the dashboard and click New task. Enter a name and configure the contract fields. The condition builder lets you construct AND, OR, and NOT trees visually.