Authentication

All API requests require an Access Key and Secret Key pair. Create credentials from the Credentials page in the console.

Example request

curl https://api.justdeploy.net/ping \
  -H "X-Access-Key: YOUR_ACCESS_KEY" \
  -H "X-Secret-Key: YOUR_SECRET_KEY"

Response

"pong"

If your app is deployed on JustDeploy, the JUSTDEPLOY_ACCESS_KEY and JUSTDEPLOY_SECRET_KEY environment variables are injected at build time — no manual credential creation needed. Always read these from process.env; never hardcode keys in your source.

GET/organizations

Lists the organizations your API credentials can access — use it to verify your keys and get the organization ID the other endpoints need (credential keys return a single organization with role null).

Response

{
  "organizations": [
    {
      "id": "org_...",
      "name": "My Organization",
      "role": null
    }
  ]
}