# Heroku

Manage Heroku: apps, dynos, config vars, releases, addons, pipelines. Exposes **40 actions** covering the API surface an agent needs - read and write.

## What it can do

| Method | What it does |
| --- | --- |
| `heroku_apps_list` | List all apps - GET /apps. |
| `heroku_app_get` | Get one app - GET /apps/{id}. |
| `heroku_app_create` | Create a new app - POST /apps. |
| `heroku_app_update` | Update an app - PATCH /apps/{id}. |
| `heroku_app_delete` | Delete an app - DELETE /apps/{id}. |
| `heroku_dynos_list` | List dynos (running processes) in an app - GET /apps/{app_id}/dynos. |
| `heroku_dyno_get` | Get one dyno - GET /apps/{app_id}/dynos/{dyno_id}. |
| `heroku_dyno_restart` | Restart a dyno or all dynos - POST /apps/{app_id}/dynos/{dyno_id}/actions/restart. |
| `heroku_dyno_scale` | Scale dynos for a process type - PATCH /apps/{app_id}/formations/{type}. |
| `heroku_config_vars_get` | Get all config vars (environment variables) for an app - GET /apps/{app_id}/config-vars. |
| `heroku_config_vars_update` | Update config vars - PATCH /apps/{app_id}/config-vars. |
| `heroku_releases_list` | List releases (deployment history) - GET /apps/{app_id}/releases. |
| `heroku_release_get` | Get one release - GET /apps/{app_id}/releases/{release_id}. |
| `heroku_release_rollback` | Rollback to a previous release - POST /apps/{app_id}/releases. |
| `heroku_addons_list` | List add-ons (services like databases, caching) for an app - GET /apps/{app_id}/addons. |
| `heroku_addon_get` | Get one add-on - GET /apps/{app_id}/addons/{addon_id}. |
| `heroku_addon_create` | Attach an add-on to an app - POST /apps/{app_id}/addons. |
| `heroku_addon_update` | Update an add-on - PATCH /apps/{app_id}/addons/{addon_id}. |
| `heroku_addon_delete` | Delete an add-on - DELETE /apps/{app_id}/addons/{addon_id}. |
| `heroku_builds_list` | List builds (compilation jobs) for an app - GET /apps/{app_id}/builds. |
| `heroku_build_get` | Get one build - GET /apps/{app_id}/builds/{build_id}. |
| `heroku_build_create` | Create a build from source archive - POST /apps/{app_id}/builds. |
| `heroku_domains_list` | List custom domains for an app - GET /apps/{app_id}/domains. |
| `heroku_domain_get` | Get one domain - GET /apps/{app_id}/domains/{domain_id}. |
| `heroku_domain_create` | Add a custom domain to an app - POST /apps/{app_id}/domains. |
| `heroku_domain_delete` | Remove a custom domain - DELETE /apps/{app_id}/domains/{domain_id}. |
| `heroku_formations_list` | List formations (dyno type configuration) - GET /apps/{app_id}/formations. |
| `heroku_formation_get` | Get one formation - GET /apps/{app_id}/formations/{process_type}. |
| `heroku_formation_update` | Update a formation - PATCH /apps/{app_id}/formations/{process_type}. |
| `heroku_collaborators_list` | List collaborators on an app - GET /apps/{app_id}/collaborators. |
| `heroku_collaborator_get` | Get one collaborator - GET /apps/{app_id}/collaborators/{collaborator_id}. |
| `heroku_collaborator_create` | Invite a collaborator to an app - POST /apps/{app_id}/collaborators. |
| `heroku_collaborator_delete` | Remove a collaborator - DELETE /apps/{app_id}/collaborators/{collaborator_id}. |
| `heroku_pipelines_list` | List pipelines (CI/CD workflow containers) - GET /pipelines. |
| `heroku_pipeline_get` | Get one pipeline - GET /pipelines/{pipeline_id}. |
| `heroku_pipeline_create` | Create a pipeline - POST /pipelines. |
| `heroku_pipeline_delete` | Delete a pipeline - DELETE /pipelines/{pipeline_id}. |
| `heroku_log_session_create` | Create a log session to tail app logs - POST /apps/{app_id}/log-sessions. |
| `heroku_account_get` | Get authenticated account info - GET /account. |
| `heroku_account_update` | Update account settings - PATCH /account. |

## How to get credentials

This connector uses an **API key / token**. Create one in the provider
dashboard, then paste it into FlyMyAI:

- **`HEROKU_API_TOKEN`** - Heroku - Account settings - API Key, or `heroku authorizations:create`. (https://dashboard.heroku.com/account)

## Fields to fill in FlyMyAI

| FlyMyAI field | Where it comes from |
| --- | --- |
| `HEROKU_API_TOKEN` | Heroku - Account settings - API Key, or `heroku authorizations:create`. |

## Troubleshooting

- **`401 Unauthorized` / `403 Forbidden`** - the token is wrong, expired, or missing a required scope; regenerate it.
- **`429 Too Many Requests`** - provider rate limit; retry after a short backoff.
- **Unexpected `4xx` on writes** - double-check required fields; the agent confirms before write actions.

## Links

- [Heroku API documentation](https://devcenter.heroku.com/articles/platform-api-reference)