New mission
New mission records a purpose, root agent, delegation depth, optional external operations, limits and expiry. The initial draft is for internal work and needs no provider connection.
- Console address
/townships/ :townshipId/ work/ missions/ new - Console section
- Township · Work
- Reviewed
- 14 October 2026
On this page
Controls and behaviour
The form has separate purpose, operations, limits and review steps. Edit JSON exposes the same contract. Add operation appears when a supported provider connection is available. Saving records a draft or proposed revision rather than starting work.
Access and limits
External calls are refused inside a mission unless its supported capabilities allow them. Internal-only missions have no automatic provider completion criterion. Model spend is checked before a round and metered afterwards, so a running round can exceed the remaining limit.
Field reference
| Field or state | Value | Meaning |
|---|---|---|
| Purpose | Text, at most 500 characters | Required. States the work the mission authorises. |
| Principal mode | autonomous | Acting on behalf of a user's source permissions is not supported by a provider yet. |
| Root agent | Existing agent ID | Identifies the agent that starts bound work. Authorisation checks that it exists. |
| Delegation depth | Integer, 0 to 5 | Bounds the delegated tree. A child cannot expand the parent's depth. |
| Capabilities | List, 0 to 50 entries | Empty permits classified internal work only. External entries need supported operations and exact resource bounds. |
| Write dispatches | Non-negative integer | Shared ceiling across the mission tree. Zero authorises no provider writes. |
| External cost | Non-negative integer in cents | The governed pilot currently records zero external operation cost. |
| Model budget | Non-negative integer in cents | Checked before rounds and metered afterwards. A round can overrun the remaining allowance. |
| Expiry | ISO-8601 instant | Required, in the future and within 30 days. Include a timezone. |
| Completion | Optional list | Supported provider effects can end the mission after verification. Empty does not auto-complete internal tasks. |
Related API endpoints
Console addresses and API addresses are different. These endpoints use authenticated console access and server-side authorisation.
/api/profiles/{profileId}/missionsBody contains contract and optional parentMissionId. Requires mission.write; saving does not start work.
Related pages
Need more help?
Open Mysaria from the console header to ask about the page you're on, or send work to an agent in your township.