When you retrieve a service's details with the Render API, many of the returned object's fields are the same regardless of the service's type (static site, web service, etc.). However, certain fields are returned only for certain service types. See the table below for details.
Legend
Symbol | Meaning |
---|---|
🟢 | Field is present |
❌ | Field is not present |
🟨 | Field is conditionally present (details vary by field) |
Field Name /Type | Static Site | Web Service | Private Service | Background Worker | Cron Job |
---|---|---|---|---|---|
idstring | 🟢 | 🟢 | 🟢 | 🟢 | 🟢 |
typestring | 🟢 | 🟢 | 🟢 | 🟢 | 🟢 |
repostring | 🟢 | 🟢 | 🟢 | 🟢 | 🟢 |
namestring | 🟢 | 🟢 | 🟢 | 🟢 | 🟢 |
autoDeployboolean | 🟢 | 🟢 | 🟢 | 🟢 | 🟢 |
branchstring | 🟢 | 🟢 | 🟢 | 🟢 | 🟢 |
createdAtdate-time | 🟢 | 🟢 | 🟢 | 🟢 | 🟢 |
notifyOnFailstring | 🟢 | 🟢 | 🟢 | 🟢 | 🟢 |
ownerIdstring | 🟢 | 🟢 | 🟢 | 🟢 | 🟢 |
slugstring | 🟢 | 🟢 | 🟢 | 🟢 | 🟢 |
suspendedstring | 🟢 | 🟢 | 🟢 | 🟢 | 🟢 |
suspendersarray of strings | 🟢 | 🟢 | 🟢 | 🟢 | 🟢 |
updatedAtdate-time | 🟢 | 🟢 | 🟢 | 🟢 | 🟢 |
buildCommandstring | 🟢 | 🟨 non-Docker only | 🟨 non-Docker only | 🟨 non-Docker only | 🟨 non-Docker only |
dockerCommandstring | ❌ | 🟨 Docker only | 🟨 Docker only | 🟨 Docker only | 🟨 Docker only |
dockerContextstring | ❌ | 🟨 Docker only | 🟨 Docker only | 🟨 Docker only | 🟨 Docker only |
dockerfilePathstring | ❌ | 🟨 Docker only | 🟨 Docker only | 🟨 Docker only | 🟨 Docker only |
envstring | ❌ | 🟢 | 🟢 | 🟢 | 🟢 |
planstring | ❌ | 🟢 | 🟢 | 🟢 | 🟢 |
regionstring | ❌ | 🟢 | 🟢 | 🟢 | 🟢 |
healthCheckPathstring | ❌ | 🟢 | ❌ | ❌ | ❌ |
publishPathstring | 🟢 | ❌ | ❌ | ❌ | ❌ |
numInstancesinteger | ❌ | 🟨 Invalid if autoscaling is enabled | 🟨 Invalid if autoscaling is enabled | 🟨 Invalid if autoscaling is enabled | ❌ |
pullRequestPreviewsEnabledboolean | 🟢 | 🟢 | 🟢 | 🟢 | ❌ |
openPortsarray of objects | ❌ | 🟢 | 🟢 | ❌ | ❌ |
parentServerobject | 🟨 Only if parent server exists | 🟨 Only if parent server exists | 🟨 Only if parent server exists | 🟨 Only if parent server exists | ❌ |
urlstring | 🟢 | 🟢 | 🟢 | ❌ | ❌ |
diskobject | ❌ | 🟢 | 🟢 | 🟢 | ❌ |
schedulestring | ❌ | ❌ | ❌ | ❌ | 🟢 |
lastSuccessfulRunAtdate-time | ❌ | ❌ | ❌ | ❌ | 🟢 |