Sample - OpenAI API
DELETE/agents/environments/templates/{environment_template_id}

Delete an agent environment template

Deletes reusable environment configuration and all confidential template inputs. See reusing a hosted setup.

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.

1 parameter
environment_template_idstringrequired
The ID of the reusable environment template.

8 status codes
200The deleted environment template.
idstringrequired
The ID of the deleted environment template.
objectstringrequired
The object type. Always `agent.environment.template.deleted`.
Allowed:agent.environment.template.deletedDefault:agent.environment.template.deleted
deletedbooleanrequired
Whether the environment template was deleted. Always `true`.
400The request was invalid.
errorobjectrequired
The error returned by the API.
401Authentication or project context was missing.
errorobjectrequired
The error returned by the API.
403The API key lacks the required management permission.
errorobjectrequired
The error returned by the API.
404The requested environment definition was not found.
errorobjectrequired
The error returned by the API.
409The request conflicted with the current environment state.
errorobjectrequired
The error returned by the API.
500An internal error occurred.
errorobjectrequired
The error returned by the API.
503The service is temporarily unavailable.
errorobjectrequired
The error returned by the API.

Error handling

A 400 is returned: The request was invalid. A 401 is returned: Authentication or project context was missing. A 403 is returned: The API key lacks the required management permission. A 404 is returned: The requested environment definition was not found. A 409 is returned: The request conflicted with the current environment state. A 500 is returned: An internal error occurred. A 503 is returned: The service is temporarily unavailable.