Skip to main content
POST /validate/twins/provision/{run_id}/lock
Revokes public pub- host access for a provisioned twin environment. Private proxy-token access remains available until TTL or teardown. The deployment keeps running until its TTL expires or you call teardown. Path parameters
FieldTypeDescription
run_idstringProvisioning run id returned from POST /validate/twins/provision.
Response When public access is revoked by this call:
{"status": "locked", "run_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "is_public": false}
When the provision was already private, the endpoint is a no-op and returns:
{"status": "already_locked", "run_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "is_public": false}
Response fields
FieldTypeDescription
statusstringlocked when this call revoked public access, or already_locked when public access was already disabled.
run_idstringProvisioning run id.
is_publicbooleanAlways false after a successful response.
Errors
StatusDescription
400run_id is not a valid UUID.
404No run with that id exists for the authenticated user.