Jobs actions

4 actions. Each action calls the same API route with the same scopes on every surface.

cancel_my_job

Cancel the User’s job.

Route	DELETE /api/v1/jobs/{id}
Tool name	calternal_api_cancel_my_job
Surfaces	cli, mcp, webmcp
Scopes	account
Effect	destructive, needs --confirm
Encoding	request none, response json

path

Field	Type	Required	Description
id	string, uuid	yes

calternal action run cancel_my_job --input '{"path":{"id":"<id>"}}' --confirm --json

get_my_job

Get the User’s job.

Route	GET /api/v1/jobs/{id}
Tool name	calternal_api_get_my_job
Surfaces	cli, mcp, webmcp
Scopes	account
Effect	read only
Encoding	request none, response json

path

Field	Type	Required	Description
id	string, uuid	yes

calternal action run get_my_job --input '{"path":{"id":"<id>"}}' --json

list_my_jobs

List the User’s jobs.

Route	GET /api/v1/jobs
Tool name	calternal_api_list_my_jobs
Surfaces	cli, mcp, webmcp
Scopes	account
Effect	read only
Encoding	request none, response json

calternal action run list_my_jobs --input '{}' --json

my_job_events

Stream the User’s job events Continuation: Reduce poll_ms after an overflow. Read current data after reconnect; use Last-Event-ID only where the route replays events..

Route	GET /api/v1/jobs/events
Tool name	calternal_api_my_job_events
Surfaces	cli, mcp, webmcp
Scopes	account
Effect	read only
Encoding	request none, response sse

headers

Field	Type	Required	Description
Last-Event-ID	string	no

calternal action run my_job_events --input '{}' --json