Skip to main content
POST
/
v0
/
persistent-servers
/
workflows
/
manual
Execute a manual workflow for all running servers of a persistent server
curl --request POST \
  --url https://controller.platform.simplecloud.app/v0/persistent-servers/workflows/manual \
  --header 'Content-Type: application/json' \
  --header 'X-Network-ID: <x-network-id>' \
  --header 'X-Network-Secret: <x-network-secret>' \
  --data '{}'
{
  "failed_servers": [
    {
      "error_message": "workflow execution was rejected by serverhost",
      "server_id": "123e4567-e89b-12d3-a456-426614174000"
    }
  ],
  "message": "Manual workflow execution completed",
  "persistent_server_id": "123e4567-e89b-12d3-a456-426614174000",
  "skipped_server_ids": [
    "<string>"
  ],
  "succeeded_server_ids": [
    "<string>"
  ],
  "total_servers": 1,
  "workflow_id": "internal.cleanup"
}

Headers

X-Network-ID
string
required

Network ID

X-Network-Secret
string
required

Network Secret

Query Parameters

persistent_server_id
string
required

Persistent Server ID

Body

application/json

Manual workflow execution request

The body is of type object.

Response

OK

Response for executing a manual workflow on all eligible servers of a persistent server.

failed_servers
object[]
message
string
Example:

"Manual workflow execution completed"

persistent_server_id
string
Example:

"123e4567-e89b-12d3-a456-426614174000"

skipped_server_ids
string[]
succeeded_server_ids
string[]
total_servers
integer
Example:

1

workflow_id
string
Example:

"internal.cleanup"