App runs

3 calls. Every request needs the Authorization header: see the overview.

`appRuns.get`

GET /apps/processes/by-id/{id}

The run with this id. Throws NotFoundError when there is none.

Who can call it: Admins and members, with an API key or a portal session. Try it in the API playground.

Path parameters

Name	Type	Required	Description
`id`	`uuid`	yes

Response: AppProcess (200)

curl -X GET "https://api.maitento.com/apps/processes/by-id/<id>" \
  -H "Authorization: $MAITENTO_AUTH"

const run = await mt.appRuns.get("6ecd8c99-4036-403d-bf84-cf8400f67836");

mt.app_runs.get("b7e6d5c4-3a2b-4c1d-8e9f-0a1b2c3d4e5f")

`appRuns.updateInputs`

PUT /apps/processes/by-id/{id}/inputs

Changes the values of a running app’s EXISTING inputs (it sees the change); 400 for an unknown input.

Who can call it: Admins and members, with an API key or a portal session. Try it in the API playground.

Path parameters

Name	Type	Required	Description
`id`	`uuid`	yes

Request body: AppStartRequest

Field	Type	Required	Description
`inputs`	`NameValuePair[]`	yes	A value for every input the app declares (the parameters of its `main`), by name. Every declared input is required; a name the app doesn’t declare is ignored.
`credentials`	`InteractionProcessCredentialRequest[] \| null`		Model keys for this run, in the order they are tried. Every interaction the app starts uses them before your tenant’s model keys. Null or empty: only your tenant’s keys are used.
`allowMaitentoFallback`	`boolean \| null`		Whether an interaction this app starts may use Maitento’s own key for a provider once no key of yours for it is left. Null means no.
`credentialStack`	`string \| null`		The credential stack the run uses, by id or name, and every interaction and code pipeline it starts. Its credentials serve every model call, in the stack’s order, and Maitento’s own keys are never used. Leave it out to use the app’s own stack, then the namespace’s default, then your tenant’s. Can’t be combined with `credentials`.
`aiModelOverrides`	`AiModelOverrideRequestInput[] \| null`		Model overrides for named agents, applied to every interaction this app starts. Null or empty: agents use the models their definitions name.
`webDownloadPartitionId`	`uuid \| null`		The temporary knowledge base (partition) that pages fetched by the web tools of every interaction and code pipeline this app starts are kept in, passed on to the apps it starts. Ignored unless it is one of your temporary knowledge bases. Null: each run uses its namespace’s default, then the tenant’s.
`webAccessOverrides`	`WebAccessOverrideInput[] \| null`		Web tool overrides (on or off, for all agents or one by name) applied to every interaction this app starts.

Response: AppProcess (200)

curl -X PUT "https://api.maitento.com/apps/processes/by-id/<id>/inputs" \
  -H "Authorization: $MAITENTO_AUTH" \
  -H "Content-Type: application/json" \
  -d '{"inputs":[]}'

const run = await mt.appRuns.updateInputs("6ecd8c99-4036-403d-bf84-cf8400f67836", { inputs: { approved: true } });

mt.app_runs.update_inputs("b7e6d5c4-3a2b-4c1d-8e9f-0a1b2c3d4e5f", {"approved": "true"})

`appRuns.listActive`

GET /namespaces/{namespaceName}/apps/processes

The app runs of the namespace that have not finished.

Who can call it: Admins and members, with an API key or a portal session. Try it in the API playground.

Path parameters

Name	Type	Required	Description
`namespaceName`	`string`	yes

Response: AppProcessWithDetails[] (200)

curl -X GET "https://api.maitento.com/namespaces/<namespaceName>/apps/processes" \
  -H "Authorization: $MAITENTO_AUTH"

const active = await mt.appRuns.listActive({ namespace: "support" });

mt.app_runs.list_active(namespace="demo")