Soft-remove one Agent and stop all unfinished work
Soft-remove one Agent and stop all unfinished work
DELETE/api/v1/workspaces/{workspace_id}/agents/{agent_id}
Path Parameters
string <uuid>
Example0198ac5e-f9b7-7000-8000-000000000001
string <uuid>
Example0198ac5e-f9b7-7000-8000-000000000001
string·min 43·max 43
Session-bound CSRF token. It must exactly match the
__Host-assign_csrf cookie sent with the request.
string
Entity tag containing the resource version last observed by the client.
Responses
string <uuid>
Opaque Assign-owned UUIDv7 identifier. Clients must not derive meaning from it.
Example0198ac5e-f9b7-7000-8000-000000000001
string <uuid>
Opaque Assign-owned UUIDv7 identifier. Clients must not derive meaning from it.
Example0198ac5e-f9b7-7000-8000-000000000001
object
string <uuid>[]·max 1000
Empty for Workspace scope and non-empty for selected-Projects scope.
enabled_trigger_typesRequired string[]·min 1·max 3
Valuesmanualeventschedule
additional_instructionsRequired string·max 2000
schedule_timezoneRequired string·min 1·max 100
schedule_local_timeRequired string
schedule_weekdaysRequired integer[]·min 1·max 7
schedule_interval_minutesRequired Fixed recurrence interval. Zero uses the local-time weekday schedule.
next_scheduled_atRequired string <date-time>
Next occurrence as an unambiguous UTC instant; clients render it with schedule_timezone and the local offset.
Example2026-08-15T12:00:00Z
string <date-time>
RFC 3339 timestamp in UTC.
Example2026-08-15T12:00:00Z
quarantine_reasonRequired string·max 200
string <date-time>
RFC 3339 timestamp in UTC.
Example2026-08-15T12:00:00Z
rollback_definition_versionRequired string·max 100
string <date-time>
RFC 3339 timestamp in UTC.
Example2026-08-15T12:00:00Z
string <date-time>
RFC 3339 timestamp in UTC.
Example2026-08-15T12:00:00Z
string
UTC RFC3339 instance sort position on catalog list items; absent from detail and mutation responses.
Cache-Control
string·const no-store
Prevents storage of error responses by clients and intermediaries.
X-Request-ID
string·min 1·max 200
Correlation identifier for the request.
X-Content-Type-Options
string·const nosniff
Prevents user agents from MIME-sniffing the response.
object
Cache-Control
string·const no-store
Prevents storage of error responses by clients and intermediaries.
X-Request-ID
string·min 1·max 200
Correlation identifier for the request.
X-Content-Type-Options
string·const nosniff
Prevents user agents from MIME-sniffing the response.
object
Cache-Control
string·const no-store
Prevents storage of error responses by clients and intermediaries.
X-Request-ID
string·min 1·max 200
Correlation identifier for the request.
X-Content-Type-Options
string·const nosniff
Prevents user agents from MIME-sniffing the response.
object
Cache-Control
string·const no-store
Prevents storage of error responses by clients and intermediaries.
X-Request-ID
string·min 1·max 200
Correlation identifier for the request.
X-Content-Type-Options
string·const nosniff
Prevents user agents from MIME-sniffing the response.
object
