# Heroku integration

> PaaS platform API for apps, releases, builds, dynos, config vars, add-ons, domains, pipelines, and log access.

- Authentication: apiKey

## Tools (79)

- **Accept or Decline App Transfer**: Respond to a pending app ownership transfer
- **Add Collaborator**: Grant a user access to an app
- **Add Domain**: Add a custom domain to an app
- **Batch Update Formation**: Scale multiple process types in one call
- **Create Add-on**: Provision an add-on on an app (e.g. a Postgres database)
- **Create Add-on Attachment**: Attach an existing add-on to another app (share a database)
- **Create App**: Create a new app
- **Create App Transfer**: Offer app ownership to another account or team
- **Create App Webhook**: Subscribe an HTTPS endpoint to app events
- **Create Build**: Start a build from a source tarball URL (deploy from source)
- **Create Log Drain**: Add a log drain to forward app logs to an external endpoint
- **Create Log Session**: Fetch recent app logs via a short-lived logplex URL
- **Create Pipeline**: Create a new pipeline
- **Create Pipeline Coupling**: Add an app to a pipeline stage
- **Create Release**: Release a slug to an app (deploy)
- **Create Slug**: Register a pre-built slug for release
- **Delete Add-on**: Deprovision an add-on (destroys its data)
- **Delete Add-on Attachment**: Detach an add-on from an app (does not destroy the add-on)
- **Delete App**: Permanently delete an app and all its resources
- **Delete App Webhook**: Remove a webhook subscription
- **Delete Log Drain**: Remove a log drain from an app
- **Delete Pipeline**: Delete a pipeline (apps survive)
- **Delete Pipeline Coupling**: Remove an app from a pipeline
- **Get Account**: Get the authenticated account's profile (email, name, verification state)
- **Get Add-on**: Get a single add-on by id or name
- **Get Add-on Attachment**: Get one add-on attachment
- **Get Add-on Plan**: Get one add-on plan's details and pricing
- **Get App**: Get details of a single app by name or id
- **Get App Pipeline Coupling**: Get the pipeline coupling for an app
- **Get App Transfer**: Get one app ownership transfer
- **Get App Webhook**: Get one webhook subscription
- **Get Build**: Get a single build and its status
- **Get Collaborator**: Get one collaborator on an app
- **Get Config Vars**: Get an app's config vars (environment variables)
- **Get Domain**: Get one domain and its DNS target
- **Get Dyno**: Get a single dyno's state
- **Get Formation**: Get the formation for one process type
- **Get Pipeline**: Get one pipeline by id or name
- **Get Pipeline Promotion**: Get a promotion's status
- **Get Release**: Get a single release by id or version number
- **Get Slug**: Get a slug's metadata and process types
- **Get Team**: Get one team's details
- **List Add-on Plans**: List plans for an add-on service
- **List Add-on Services**: List available add-on services from the marketplace
- **List All Add-ons**: List add-ons across all accessible apps
- **List App Add-on Attachments**: List add-on attachments on an app (incl. shared add-ons)
- **List App Add-ons**: List add-ons installed on an app
- **List Apps**: List all apps the authenticated account can access
- **List App Transfers**: List pending ownership transfers for the account
- **List App Webhooks**: List webhook subscriptions on an app
- **List Builds**: List an app's builds
- **List Collaborators**: List users with access to an app
- **List Domains**: List an app's custom domains
- **List Dynos**: List an app's running dynos
- **List Formation**: List an app's process formation (types, quantities, sizes)
- **List Log Drains**: List an app's log drains
- **List Pipeline Couplings**: List the apps coupled to a pipeline and their stages
- **List Pipelines**: List pipelines the account can access
- **List Promotion Targets**: List per-target results of a pipeline promotion
- **List Regions**: List available deployment regions
- **List Releases**: List an app's releases (deploy history)
- **List Stacks**: List available stacks (base images)
- **List Team Apps**: List apps owned by a team
- **List Teams**: List teams the account belongs to
- **Promote Pipeline**: Promote an app's release to downstream pipeline apps
- **Remove Collaborator**: Revoke a user's access to an app
- **Remove Domain**: Remove a custom domain from an app
- **Restart All Dynos**: Restart every dyno of an app
- **Restart Dyno**: Restart a single dyno
- **Roll Back Release**: Roll an app back to a previous release
- **Run One-Off Dyno**: Run a one-off command in a new dyno (like heroku run)
- **Scale Formation**: Scale one process type's dyno quantity or size
- **Stop Dyno**: Stop a one-off dyno without restart
- **Update Add-on Plan**: Change an add-on to a different plan (upgrade/downgrade)
- **Update App**: Rename an app or toggle maintenance mode
- **Update App Webhook**: Change a webhook's URL, events, or level
- **Update Config Vars**: Set, update, or delete config vars (triggers a restart)
- **Update Pipeline**: Rename a pipeline
- **Update Pipeline Coupling**: Move an app to a different pipeline stage

## Triggers (1)

- **New Release in Heroku**: Triggers when a new release (deploy) is created for a Heroku app, including deploys, config changes, and rollbacks.

## Related prompts

- [Did the last Heroku deploy cause this Sentry error?](https://www.generalinput.com/prompts/did-the-last-heroku-deploy-cause-this-sentry-error.md)
- [Turn Heroku deploys into a readable Slack changelog](https://www.generalinput.com/prompts/turn-heroku-deploys-into-a-readable-slack-changelog.md)
- [Weekly Heroku deploy-frequency report posted to Slack](https://www.generalinput.com/prompts/weekly-heroku-deploy-frequency-report-posted-to-slack.md)
- [Daily Heroku dyno and add-on inventory digest in Slack](https://www.generalinput.com/prompts/daily-heroku-dyno-and-add-on-inventory-digest-in-slack.md)

Connect Heroku in General Input: https://www.generalinput.com/apps/heroku