Skip to main content
Heroku logo

​
Overview

Add Heroku to any ModuleX agent or workflow. Cloud platform for building, deploying, and managing applications via the Heroku Platform API (api.heroku.com).
Categories: Developer Tools & Infrastructure · Cloud Infrastructure · Paas · Auth: OAuth2 · Actions: 1

​
Authentication

​
OAuth2 Authentication

Connect using Heroku OAuth (recommended)

​
Required Credentials

FieldDescriptionRequiredFormat
Client IDHeroku OAuth App Client IDYesxxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
Client SecretHeroku OAuth App Client SecretYesxxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

​
OAuth Configuration

  • Authorization URL: https://id.heroku.com/oauth/authorize
  • Token URL: https://id.heroku.com/oauth/token
  • Scopes: global

​
Available Actions

​
Response

{
  "$defs": {
    "AppSummary": {
      "additionalProperties": false,
      "description": "A Heroku app summary.",
      "properties": {
        "id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Id"
        },
        "name": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Name"
        },
        "web_url": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Web Url"
        },
        "region": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Region"
        },
        "stack": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Stack"
        },
        "created_at": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Created At"
        },
        "updated_at": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Updated At"
        }
      },
      "title": "AppSummary",
      "type": "object"
    }
  },
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "apps": {
      "items": {
        "$ref": "#/$defs/AppSummary"
      },
      "title": "Apps",
      "type": "array"
    }
  },
  "required": [
    "success"
  ],
  "title": "ListAppsOutput",
  "type": "object"
}

​
Limits & Quotas

  • Heroku Platform API rate limit: 4,500 requests per hour per OAuth token.
  • Rate limit headers: RateLimit-Remaining and RateLimit-Reset are returned on every response.
  • Error model: non-2xx responses raise (Pattern A). The caller receives an httpx.HTTPStatusError surfaced by the modulex runtime.

DigitalOcean

Algolia

Amazon Web Services