Job Types Reference for the built-in Savannah Cloud job handlers and payload schemas.
Each job sent to POST /jobs includes a Type field and a JSON payload. The worker dispatches based on the Type value.
{
"ID" : "email-001" ,
"Type" : "send_email" ,
"Payload" : {
"to" : "user@example.com" ,
"subject" : "Your order is confirmed" ,
"body" : "Thank you for your purchase!"
},
"MaxRetries" : 3
}
Field Type Required tostring Yes subjectstring Yes bodystring Yes
{
"ID" : "sms-001" ,
"Type" : "send_sms" ,
"Payload" : {
"to" : "+254700000000" ,
"message" : "Your verification code is 123456"
},
"MaxRetries" : 2
}
Field Type Required tostring Yes messagestring Yes
{
"ID" : "webhook-001" ,
"Type" : "webhook" ,
"Payload" : {
"url" : "https://api.example.com/events" ,
"payload" : { "event" : "deployment.success" }
},
"MaxRetries" : 5
}
Field Type Required urlstring Yes payloadobject Yes
{
"ID" : "pdf-001" ,
"Type" : "generate_pdf" ,
"Payload" : {
"template" : "invoice" ,
"data" : { "invoice_id" : "INV-001" , "amount" : 1500 }
},
"MaxRetries" : 1
}
Field Type Required templatestring Yes dataobject Yes
{
"ID" : "deploy-001" ,
"Type" : "git_deploy" ,
"Payload" : {
"repo" : "owner/repo" ,
"branch" : "main" ,
"env" : "production"
},
"MaxRetries" : 2
}
Field Type Required repostring Yes branchstring Yes envstring No
{
"ID" : "stack-001" ,
"Type" : "stack_deploy" ,
"Payload" : {
"project" : "acme-app" ,
"stack" : "nextjs"
},
"MaxRetries" : 2
}
Field Type Required projectstring Yes stackstring Yes
You can add your own job handlers by defining a new Type and implementing the worker logic in the server. This is the recommended path for:
internal automation jobs
custom integrations
domain-specific workflow actions
tenant-specific processing steps
The worker dispatch layer determines runtime behavior, so the API surface is stable while the work implementation remains extensible.