render

name

render

description

Render is a cloud-hosting platform that enables developers to build, deploy, and scale web apps, APIs, static sites, and background workers with automated builds, managed infrastructure, global CDN, and built-in SSL—all without managing servers. Read and write Render data through One: keyvalue, postgresinstance, services, service, taskruns, projects and more, 196 actions with real parameter documentation. Use whenever the user asks to look something up in Render, create or update a record there, or build code against the Render API.

Render through One

Render is a cloud-hosting platform that enables developers to build, deploy, and scale web apps, APIs, static sites, and background workers with automated builds, managed infrastructure, global CDN, and built-in SSL—all without managing servers.

One exposes Render through four MCP tools. The table below carries real action ids from One's knowledge base, so for a common operation you can skip search and go straight to reading the action's parameters.

How to run an action

1. Find the action in the table below, or call search_one_platform_actions with platform render if it is not listed.
2. Call get_one_action_knowledge with the action id. Do this every time, including for actions in this table. The table gives you the id, not the parameters.
3. Call execute_one_action with parameters copied from that knowledge.

Never guess a parameter name, a body field, or an enum value. The knowledge has the real schema, and a guessed field is either a 400 or a silent write of the wrong thing.

Before you start

Call list_one_integrations once and confirm Render is connected. If it is missing, the user has not connected it: say so and point them at https://app.withone.ai rather than reaching for raw HTTP.

Each connection carries an access field. If it reports {"policy": "methods", "methods": ["GET"]} the agent is read-only here, so plan a read-only answer instead of attempting a write that will be refused.

Before a write

Creates, updates, deletes and sends land on a real Render account and cannot be recalled. State the action and the specific target in one line before the first write in a task, and let the user stop you. Reads need no confirmation.

Actions

KeyValue

Action	Method	Path	Action id
List Key Value Instances	GET	/key-value	conn_mod_def::GJgQ5VM5rHA::bDM62zqcSMKX1aPYY7_ZkQ
Retrieve a Key Value Instance	GET	/key-value/{{KEYVALUEID}}	conn_mod_def::GJgQ5j5-hmA::lv9RNgLZQd2sbdo7kq4l4A
Create a Key Value Instance	POST	/key-value	conn_mod_def::GJgQ5d6ReOg::YgTfOapNTdCgW8wcwr5z8w
Delete a Key Value Instance	DELETE	/key-value/{{keyValueId}}	conn_mod_def::GJgQ5u3vrAA::9RJ7kXF1Q8KzCEiWZtmnNA
Resume a Key Value Instance	POST	/v1/key-value/{{KEYVALUEID}}/resume	conn_mod_def::GJgQ6FGiyNA::-Pwfvo98QrmHrE7SM3PuBw
Suspend a Key Value Instance	POST	/v1/key-value/{{KEYVALUEID}}/suspend	conn_mod_def::GJgQ58uGJJA::xgmsg-YxTLCmqNLasXSpyA
Update a Key Value Instance	PATCH	/v1/key-value/{{KEYVALUEID}}	conn_mod_def::GJgQ5prfkqA::4-I5BCv5QtaDcduPxq4Jjw

PostgresInstance

Action	Method	Path	Action id
Retrieve a Postgres Instance	GET	/postgres/{{POSTGRESID}}	conn_mod_def::GJgQ__q3BzA::U-XSdok3SkK1-uGCYMKN6A
Delete a Postgres Instance	DELETE	/v1/postgres/{{POSTGRESID}}	conn_mod_def::GJgRANaazoA::AYK4l9Y2Ray7HFvYK4oZJQ
Restart a Postgres Instance	POST	/v1/postgres/{{POSTGRESID}}/restart	conn_mod_def::GJgRA1tvd4A::ztpRURJ0REOg0ucPJJ4kxg
Resume a Postgres Instance	POST	/v1/postgres/{{POSTGRESID}}/resume	conn_mod_def::GJgRAsAJ0fA::d-JNxIAMTcGYCjaQ5pV1gw
Suspend a Postgres Instance	POST	/postgres/{{POSTGRESID}}/suspend	conn_mod_def::GJgRAmW_ZPg::2jaLRJBHQbyH0_NvN2Dtyg

Services

Action	Method	Path	Action id
List Services	GET	/services	conn_mod_def::GJgREDpdX8g::kCCL41fLRWqQVQGOV3ukAg
Create a Service	POST	/services	conn_mod_def::GJgREJV-8uA::0aQthDufSJqPZrBHEFTFdA
Delete a Service	DELETE	/v1/services/{{SERVICEID}}	conn_mod_def::GJgREeDi9mg::Xi4QK2THRV-qmo-M_8TQ4Q
Scale a Service’s Instance Count	POST	/v1/services/{{SERVICEID}}/scale	conn_mod_def::GJgRGQ-FVMg::jml70i-uS2m1mvrQ7e69Mg
Update a Service	PATCH	/services/{{SERVICEID}}	conn_mod_def::GJgREYKO6_g::ppqBCpV2RMS-9JeTNuMK6g

Service

Action	Method	Path	Action id
Retrieve a Service	GET	/services/{{serviceId}}	conn_mod_def::GJgREO9REvg::NxMJG_fIQ2KIj9q3Hic1Ug
Restart a Service	POST	/v1/services/{{SERVICEID}}/restart	conn_mod_def::GJgRGGUBlSA::15RVR3NVQI-zLXlf0YcqtQ
Resume a Service	POST	/v1/services/{{SERVICEID}}/resume	conn_mod_def::GJgRGAZydbA::rPnoWcr6T-WfyPtuAS69PQ
Suspend a Service	POST	/v1/services/{{SERVICEID}}/suspend	conn_mod_def::GJgRF5bnORA::A7bpAvf8TQaVjneE2tBWPg

TaskRuns

Action	Method	Path	Action id
List Task Runs	GET	/task-runs	conn_mod_def::GJgRJC7EdSA::rdJR3cEgT4acX05zLdCJKg
Retrieve a Task Run	GET	/task-runs/{{taskRunId}}	conn_mod_def::GJgRJbv35hA::i9qVJhidQAe0HU1VELoX6g
Cancel a Task Run	DELETE	/task-runs/{{TASKRUNID}}	conn_mod_def::GJgRJjT1o2g::MCOyyOp0Q86n47SzXV7rJA
Run a Task	POST	/task-runs	conn_mod_def::GJgRJJaJ4yA::UIHZeRsfT3OcNdUUnp0KVw

Projects

Action	Method	Path	Action id
List Projects	GET	/projects	conn_mod_def::GJgRBuXgzGg::-ceCONQXTaSDjPjQg-HvmQ
Create Project	POST	/projects	conn_mod_def::GJgRB0k98pA::Xf3ZhM97QeexTFLqER5A7A
Delete a Project	DELETE	/v1/projects/{{PROJECTID}}	conn_mod_def::GJgRCGgvJYg::yHviEGj0RfqkTaV61z9VsA
Update a Project	PATCH	/projects/{{PROJECTID}}	conn_mod_def::GJgRCBe_Okg::7MPAyJCnQC6hN5jOUJb-Dg

Blueprints

Action	Method	Path	Action id
List Blueprints	GET	/blueprints	conn_mod_def::GJgQ1EeaNdA::e4N4v0fYTUGDxMSfAjGUwg
Retrieve a Blueprint	GET	/v1/blueprints/{{blueprintId}}	conn_mod_def::GJgQ1Rso-lg::wM3Z0uJVTzCj6WvHCsRJrw
Disconnect a Blueprint	DELETE	/blueprints/{{BLUEPRINTID}}	conn_mod_def::GJgQ1fNQLtg::pZFECR8mTfGY2cZF2yVCHA
Update a Blueprint	PATCH	/blueprints/{{BLUEPRINTID}}	conn_mod_def::GJgQ1ZHFJOg::gGm9S6jwTLGAOkj3vkBJwA

ServiceDeploy

Action	Method	Path	Action id
Retrieve a Service Deploy	GET	/v1/services/{{SERVICEID}}/deploys/{{DEPLOYID}}	conn_mod_def::GJgQ2qEm4Yg::sKpXr10ES-SRqDm4A_nTcQ
Cancel a Service Deploy	POST	/v1/services/{{SERVICEID}}/deploys/{{DEPLOYID}}/cancel	conn_mod_def::GJgQ2xLCwjA::bkDlWcdMQSuWzvUzv5_S3A
Roll Back a Service Deploy	POST	/services/{{SERVICEID}}/rollback	conn_mod_def::GJgQ23H4mVA::UbwRS4W6Tl6qzyfdJvWSzg
Trigger a Service Deploy	POST	/services/{{SERVICEID}}/deploys	conn_mod_def::GJgQ2i1FCIA::h24q5pakRcemoe3TZhYR-w

Disk

Action	Method	Path	Action id
Retrieve a Disk	GET	/disks/{{DISKID}}	conn_mod_def::GJgQ3NFAPeA::o5s1N53IRhS6Vn5wafh_2A
Add a Disk	POST	/disks	conn_mod_def::GJgQ3FXG1hA::dpM9CsOwTQ2sjxOMC7hSdw
Restore a Disk to a Snapshot	POST	/v1/disks/{{DISKID}}/snapshots/restore	conn_mod_def::GJgQ3n1ytgA::h50RHKTvQWW5bXaNFDozyQ
Update a Disk	PATCH	/disks/{{diskId}}	conn_mod_def::GJgQ3Uxz2oA::eAS0e29NTS2ZurFJayfUaw

EnvGroups

Action	Method	Path	Action id
Create an Environment Group	POST	/env-groups	conn_mod_def::GJgQ31-RqJg::aSrNUo6gRQWQMGlQp9Rk3g
Link a Service to an Environment Group	POST	/v1/env-groups/{{ENVGROUPID}}/services/{{SERVICEID}}	conn_mod_def::GJgQ4TB2K7g::HBEpKlU1S8C08nzEFlBoPQ
Remove an Environment Variable from an Environment Group	DELETE	/v1/env-groups/{{ENVGROUPID}}/env-vars/{{ENVVARKEY}}	conn_mod_def::GJgQ4xQG5Tg::NebRUvAzTP2uEbGpC_t69w
Unlink a Service from an Environment Group	DELETE	/v1/env-groups/{{ENVGROUPID}}/services/{{SERVICEID}}	conn_mod_def::GJgQ4aQFlzA::Pe0L-RSBQumVp2rcykCV4Q

Environments

Action	Method	Path	Action id
List Environments	GET	/environments	conn_mod_def::GJgRCQNndaA::oRGcnudqSi6eYw1XaKuVqQ
Create Environment	POST	/environments	conn_mod_def::GJgRCUwmmRA::AiJuLj8UQXiEXOFaq0V34w
Delete an Environment	DELETE	/v1/environments/{{ENVIRONMENTID}}	conn_mod_def::GJgRCm8R6MA::U0U9OoHFTAqwtAeyxzIXow
Update an Environment	PATCH	/v1/environments/{{ENVIRONMENTID}}	conn_mod_def::GJgRCicEv9A::RtSpl22GQBK56Auk_DNV1w

ServiceRoutes

Action	Method	Path	Action id
List a Service’s Redirect/Rewrite Rules	GET	/v1/services/{{SERVICEID}}/routes	conn_mod_def::GJgRHjku9UA::QPfl7h6_QdqVi5CPq4TeFA
Delete a Service's Redirect/Rewrite Rule	DELETE	/services/{{SERVICEID}}/routes/{{ROUTEID}}	conn_mod_def::GJgRIC25_wA::fOcEwsbDTYGK1xKpVmTImg
Update a Service Route's Redirect/Rewrite Rule Priority	PATCH	/services/{{SERVICEID}}/routes	conn_mod_def::GJgRH4_rnqA::BN_USAB1Rqa0BgDvwjzbcw
Update a Service’s Redirect/Rewrite Rules	PUT	/v1/services/{{SERVICEID}}/routes	conn_mod_def::GJgRHyZYmKg::0m5Xh8vYQeedo6QOdJ7l-g

Webhooks

Action	Method	Path	Action id
List Webhooks	GET	/webhooks	conn_mod_def::GJgRIQE4ybA::u_SbibmETuWEFtk_4aQ6_w
Create a Webhook	POST	/webhooks	conn_mod_def::GJgRIWrlCLA::w3riaYpXT8-Zun_IEm7Qgw
Delete a Webhook	DELETE	/v1/webhooks/{{WEBHOOKID}}	conn_mod_def::GJgRIqMwCkg::0LEazDFTTmeZcOnU8jzMFg
Update a Webhook	PATCH	/webhooks/{{WEBHOOKID}}	conn_mod_def::GJgRIkv17ng::-Fn9MIbhSROe5gRZ-Xiv2A

MaintenanceRun

Action	Method	Path	Action id
Retrieve a Maintenance Run	GET	/maintenance/{{MAINTENANCERUNPARAM}}	conn_mod_def::GJgQ7TsDiFg::cr3Luw7FTDGBBTXAv4yNhA
Trigger a Maintenance Run	POST	/v1/maintenance/{{MAINTENANCERUNPARAM}}/trigger	conn_mod_def::GJgQ7isY8XA::sixEYszkTTG1yAUS8xZy2g
Update a Maintenance Run	PATCH	/v1/maintenance/{{MAINTENANCE_RUN_PARAM}}	conn_mod_def::GJgQ7ZG1LpA::5U1sSsrQTjKIMtXPJS7u2w

MetricsStream

Action	Method	Path	Action id
Retrieve a Workspace’s Metrics Stream	GET	/v1/metrics-stream/{{OWNERID}}	conn_mod_def::GJgQ7qD7p3A::BUpayo2dTPO2NNK_5QePrg
Create or Update a Workspace’s Metrics Stream	PUT	/v1/metrics-stream/{{OWNERID}}	conn_mod_def::GJgQ70FrDMg::yyDpwGUEQ96EDTEEiINAJw
Delete a Workspace’s Metrics Stream	DELETE	/metrics-stream/{{OWNERID}}	conn_mod_def::GJgQ77IIQiA::YqrgE_Y4SLaJJdbmdETcJg

Postgres

Action	Method	Path	Action id
Create a Postgres Instance	POST	/postgres	conn_mod_def::GJgQ_3HdfUA::RPSGyXFhTEeLlueZ-RrzYg
Failover a Postgres Instance	POST	/postgres/{{POSTGRESID}}/failover	conn_mod_def::GJgRA7qCFwA::JUltc-4RSZy5bP4VdSGKsA
Update a Postgres Instance	PATCH	/postgres/{{POSTGRESID}}	conn_mod_def::GJgRAGqbJbg::E7i_3K9qTaWYga9pJ1bFAg

EnvironmentGroups

Action	Method	Path	Action id
List Environment Groups	GET	/env-groups	conn_mod_def::GJgQ3vVYufg::Xni7oO8zTYCsXXXIMQEfxg
Delete an Environment Group	DELETE	/env-groups/{{ENVGROUPID}}	conn_mod_def::GJgQ4L3P3Ag::VRyWDcssSu-jjO8tot7MRA
Update an Environment Group	PATCH	/env-groups/{{ENVGROUPID}}	conn_mod_def::GJgQ4FQOQEg::JmWjrPBfTHykkut4cgeXLQ

EnvGroupSecretFiles

Action	Method	Path	Action id
Retrieve an Environment Group’s Secret File	GET	/v1/env-groups/{{ENVGROUPID}}/secret-files/{{SECRETFILENAME}}	conn_mod_def::GJgQ44ut6Eg::GqTrqhLLRg2Sy0uKWnk7tQ
Add or Update an Environment Group Secret File	PUT	/v1/env-groups/{{ENVGROUPID}}/secret-files/{{SECRETFILENAME}}	conn_mod_def::GJgQ5AdCzyg::EenOytffTwKnu9_pxnRpJg
Remove an Environment Group Secret File	DELETE	/v1/env-groups/{{ENVGROUPID}}/secret-files/{{SECRETFILENAME}}	conn_mod_def::GJgQ5ItuFzA::LGb28SZWTEibhAQOrOH5Dg

RedisInstance

Action	Method	Path	Action id
Retrieve a Redis Instance	GET	/redis/{{REDISID}}	conn_mod_def::GJgRDJjihUA::6HPmoWdxTZeOheeIEwxAQQ
Delete a Redis Instance	DELETE	/redis/{{REDISID}}	conn_mod_def::GJgRDWy3FPg::OAofw6JfSQq8PvTymkLGsA
Update a Redis Instance	PATCH	/redis/{{REDISID}}	conn_mod_def::GJgRDQ0qhqA::scwjL0bDQguX3JES16d0vw

RegistryCredentials

Action	Method	Path	Action id
List Registry Credentials	GET	/registrycredentials	conn_mod_def::GJgRDmMmTRg::yI_0bbn6SzmORbYEaSYs2w
Create Registry Credential	POST	/registrycredentials	conn_mod_def::GJgRDsRUdbA::W253NkwbSUm63Piw8IuW7Q
Delete a Registry Credential	DELETE	/registrycredentials/{{REGISTRYCREDENTIALID}}	conn_mod_def::GJgRD93bYfA::UKz6RM6hSlCDbsXRNMZphQ

ServiceEnvVar

Action	Method	Path	Action id
Retrieve a Service Environment Variable	GET	/v1/services/{{SERVICEID}}/env-vars/{{ENVVARKEY}}	conn_mod_def::GJgRE7Uxxdg::bbjzHewHTli6PTDZjmTUog
Add or Update a Service Environment Variable	PUT	/v1/services/{{SERVICEID}}/env-vars/{{ENVVARKEY}}	conn_mod_def::GJgRFBnKx2A::tk1rZlF6QYO4hdJFAfAFgA
Delete a Service Environment Variable	DELETE	/v1/services/{{SERVICEID}}/env-vars/{{ENVVARKEY}}	conn_mod_def::GJgRFHmMIVg::KKGBwIJxTSuIWCD9oloClQ

ServiceSecretFiles

Action	Method	Path	Action id
Add or Update a Service Secret File	PUT	/v1/services/{{SERVICEID}}/secret-files/{{SECRETFILENAME}}	conn_mod_def::GJgRFiyNfSg::oyZ4VytORtielN4ThYxYSA
Delete a Service Secret File	DELETE	/v1/services/{{SERVICEID}}/secret-files/{{SECRETFILENAME}}	conn_mod_def::GJgRFpC7bIg::nSY0_Jm6QGW8zNSyYgXvkQ
Update a Service's Secret Files	PUT	/services/{{SERVICEID}}/secret-files	conn_mod_def::GJgRFVMm11A::bXph8vasT4yfSd9Lo6--kA

Workflow

Action	Method	Path	Action id
Retrieve a Workflow	GET	/workflows/{{WORKFLOWID}}	conn_mod_def::GJgRJ20eBbg::DwgCvmFXQF6oNVm6fLuFaQ
Create a Workflow	POST	/workflows	conn_mod_def::GJgRJxIAVrg::SqSAgQP7RkCGcKXFnLBJYw
Update a Workflow	PATCH	/workflows/{{WORKFLOWID}}	conn_mod_def::GJgRKAX0Tdg::KZwp_LppRfif0Qwyx-y9kg

WorkflowVersions

Action	Method	Path	Action id
List Workflow Versions	GET	/workflowversions	conn_mod_def::GJgRKPjaERg::45v7SLbcQweb5uVF8lWlHw
Retrieve a Workflow Version	GET	/v1/workflowversions/{{WORKFLOWVERSIONID}}	conn_mod_def::GJgRKezv4Eg::jhxupMbDRSiL0t_vA17FUA
Deploy a Workflow Version	POST	/workflowversions	conn_mod_def::GJgRKXIEZIA::g7VvzEJMTbqdYBLFrG4AFQ

This lists 90 of 196 actions. For anything not here, call search_one_platform_actions with platform render. The full catalog is at https://www.withone.ai/knowledge/render.

When a call fails

The error comes from Render, not from One. A 400 or 422 means your parameters do not match the schema, so re-read the knowledge and fix the field. A 401 or 403 means the connection needs re-authorizing, which no retry will fix. A 404 means the id is not on this account. A 429 means slow down. Never retry a write more than once: the first attempt may have landed.

Full catalog: https://www.withone.ai/knowledge/render

Integration knowledge by One (withone.ai), licensed under One-Knowledge-1.0. Attribution must be preserved in derivative works.