# Missions Mission definitions, their feature list, and the execution lifecycle — start, pause, cancel — along with recent executions. Playground Send these requests to your own running server. Values stay in this browser. Not connected Base URL Directory _optional_ Bearer token _optional_ How this works Start a server with `nikcli serve --hostname 127.0.0.1 --port 4096`. Requests go straight from this page to that address — the browser allows it because loopback counts as a secure origin, and the server allows it because `nikcli-ai.dev` is in its CORS allowlist. To try things without touching your real sessions or config, start the server with `NIKCLI_TEST_HOME` pointed at a throwaway directory — see [the guided tour](/docs/guides/api-tour). ## Operations 13 endpoints, generated from the server's own [OpenAPI document](/docs/api). Every path also accepts the `directory` and `workspace` query parameters that select which instance handles the request.

get	/mission	mission.list
put	/mission	mission.upsert
get	/mission/templates	mission.templates
post	/mission/generate	mission.generate
get	/mission/execs/recent	mission.recentExecs
get	/mission/{id}	mission.get
post	/mission/{id}	mission.update
delete	/mission/{id}	mission.delete
post	/mission/{id}/start	mission.start
post	/mission/{id}/pause	mission.pause
post	/mission/{id}/cancel	mission.cancel
post	/mission/{id}/feature/{featureID}	mission.feature.mutate
get	/mission/{id}/execs	mission.execs

get /mission [#](#op-get-mission) `mission.list` Parameters | Name | In | Type | Required | | --- | --- | --- | --- | | directory | query | string | optional | | workspace | query | string | optional | Responses 200 MissionListOutput application/json { missions: [MissionDefinition](#schema-MissionDefinition)\[\] runtimes: [MissionRuntime](#schema-MissionRuntime)\[\] } Example response captured ``` { "missions": [], "runtimes": [] } ``` SDK example mission.list ts 1 2 3 4 5 6 ``` import { createNikcliClient } from "@nikcli-ai/sdk/httpapi" const client = createNikcliClient() await client.mission.list({ ... }) ``` Try it directory _query_ workspace _query_ --- Source: https://nikcli-ai.dev/docs/api/mission