AI agents for Heroku

List apps

Lists the Heroku apps the token can see (owned, team and collaborated), as result.

Get an app

Reads one app by name or ID: its region, stack, build stack, team, owner, web address, Git URL, slug and repository size, whether maintenance mode is on, and when it was created.

List dynos

Lists an app's running dynos as result: each with its ID, name (like web.1), process type, size, state (up, starting, crashed, idle, down), command, the release it runs.

List process types

Lists an app's formation, its process types, as result: each with its type (like web), how many dynos it runs (quantity), the dyno size (dyno_size.name), the command, and when it was last updated.

List releases

Lists an app's releases, newest first, as result: each with its ID, version number, status (succeeded, pending, failed), description.

Get a release

Reads one release of an app by its version number or ID: status, description, whether it is current and can be rolled back to, the slug it runs, the add-on plans attached, who made it and when.

List builds

Lists an app's builds, newest first, as result: each with its ID, status (pending, succeeded, failed), the source version.

Get a build

Reads one build by ID: status, source version, buildpacks, stack, the slug and release it produced, and output_stream_url, the address of its build log.

List add-ons

Lists an app's add-ons (databases, caches, logging and others) as result.

Get the signed-in account

Reads the Heroku account the token belongs to: its ID, email, name, default team, whether two-factor authentication is on, and when it last signed in.

Restart a dyno

Restarts one dyno of an app by its name (like web.1 or worker.2) or ID.

Restart a process type

Restarts every dyno of one process type of an app, like all web dynos.

Restart all dynos

Restarts every dyno of an app (all process types), the API form of heroku ps:restart.

Scale a process type

Sets how many dynos one process type runs, like 3 web dynos; 0 stops it.

Roll back to a release

Rolls an app back to an earlier release by creating a new release that runs the old release's code and config.

Turn maintenance mode on or off

Turns an app's maintenance mode on (visitors see a maintenance page and web requests are not served) or off.