Manage Apps

List apps, invoke actions, and check deployments and invocations

Use manage_apps when an agent needs to run a deployed Kernel app or inspect app deployment state. List apps first when the agent doesn’t know the exact app or action name, then invoke the action and poll the invocation result.

Actions

Action	Description
list_apps	Discover apps.
invoke	Execute an app action.
get_deployment	Retrieve a deployment by ID.
list_deployments	Check deployment status.
get_invocation	Check action results.

Recommended flow

1. Call list_apps to discover available apps and actions.
2. Call invoke with app_name, action_name, and a JSON-string payload.
3. Call get_invocation with the returned invocation ID when you need the result later.
4. Use list_deployments and get_deployment when the agent needs deployment status.

Parameters

Parameter	Description
action	Operation to perform. Required.
app_name	(list_apps, invoke, list_deployments) App name filter or target.
action_name	(invoke) Action to execute within the app.
payload	(invoke) JSON string with action parameters.
version	(list_apps, invoke) App version filter. Defaults to latest for invoke.
deployment_id	(get_deployment) Deployment ID to retrieve.
invocation_id	(get_invocation) Invocation ID to retrieve.
limit	(list_apps, list_deployments) Max results per page. Must be 1-100.
offset	(list_apps, list_deployments) Pagination offset. Must be 0 or greater.

Invoke an app

{
  "action": "invoke",
  "app_name": "web-scraper",
  "action_name": "scrape",
  "payload": "{\"url\": \"https://reddit.com\"}"
}