Deployments
Deployments let the user schedule a job to deploy the contents of their workspace repository to their workspace in Meltano Cloud.
This can be done manually or via a GitHub repository webhook:
- Payload URL:
https://app.meltano.com/api/workspaces/<workspace_id>/deployments/github-webhook - Content type:
application/json - Secret: "Deployment Secret" from workspace settings in Meltano Cloud
Requests
Deploy your workspace repository
POST /api/workspaces/{workspaces-id}/deployments
Deploys the workspace {workspace-id}.
Examples
- cURL
- Python (requests)
curl -H "Authorization: Bearer $ACCESS_TOKEN" 'https://app.meltano.com:443/api/workspaces/86d08dd0-d1e7-463b-8995-69b64b6120e1/deployments' -i -X POST \
-H 'Content-Type: application/json'
import requests
url = "https://app.meltano.com:443/api/workspaces/86d08dd0-d1e7-463b-8995-69b64b6120e1/deployments"
headers = {
'Authorization': ACCESS_TOKEN
}
response = requests.request("POST", url, headers=headers)
print(response.text.encode('utf8'))
Response
202 Accepted
Job with HAL links.
{
"id" : "14953eb6-60b3-4eb6-ba93-0b223115b06a",
"created" : "2026-09-14T05:58:12.818326",
"type" : "WORKSPACE_DEPLOY",
"maxAttempts" : 0,
"attempt" : 0,
"status" : "QUEUED",
"_embedded" : {
"profile" : {
"id" : "auth0|6a21dc7aa1db2e036a222942",
"name" : "sit+prod@meltano.com",
"handle" : "@sit+prod",
"email" : "sit+prod@meltano.com",
"workingAccount" : {
"company" : "SIT Account - DO NOT CHANGE",
"id" : "auth0|6a21dc7aa1db2e036a222942"
}
}
},
"_links" : {
"self" : {
"href" : "https://app.meltano.com/api/jobs/14953eb6-60b3-4eb6-ba93-0b223115b06a"
},
"delete job" : {
"href" : "https://app.meltano.com/api/jobs/14953eb6-60b3-4eb6-ba93-0b223115b06a",
"type" : "DELETE"
},
"logs" : {
"href" : "https://app.meltano.com/api/jobs/14953eb6-60b3-4eb6-ba93-0b223115b06a/logs?sequence=0",
"type" : "GET"
},
"withdraw job" : {
"href" : "https://app.meltano.com/api/jobs/14953eb6-60b3-4eb6-ba93-0b223115b06a/stopped",
"type" : "PUT"
}
}
}
GitHub webhook workspace deployment
POST /api/workspaces/{workspaces-id}/deployments/github-webhook
Receives POST requests from GitHub and starts a workspace deploy job.
Examples
- cURL
- Python (requests)
curl -H "Authorization: Bearer $ACCESS_TOKEN" 'https://app.meltano.com:443/api/workspaces/86d08dd0-d1e7-463b-8995-69b64b6120e1/deployments/github-webhook' -i -X POST \
-H 'X-Hub-Signature: sha1=61bdafc927386fe886e1958176abaeb3cf5b6003' \
-H 'Content-Type: application/json' \
-d '{ }'
import requests
url = "https://app.meltano.com:443/api/workspaces/86d08dd0-d1e7-463b-8995-69b64b6120e1/deployments/github-webhook"
data = { }
headers = {
'Authorization': ACCESS_TOKEN
}
response = requests.request("POST", url, headers=headers, data=data)
print(response.text.encode('utf8'))
Response
202 Accepted
Job with HAL links.
{
"id" : "c4df3e9a-b12c-4cda-a54a-9afd8b0fce1b",
"created" : "2026-09-14T05:58:13.722058",
"type" : "WORKSPACE_DEPLOY",
"maxAttempts" : 0,
"attempt" : 0,
"status" : "QUEUED",
"_embedded" : {
"profile" : {
"id" : "auth0|6a21dc7aa1db2e036a222942",
"name" : "sit+prod@meltano.com",
"handle" : "@sit+prod",
"email" : "sit+prod@meltano.com",
"workingAccount" : {
"company" : "SIT Account - DO NOT CHANGE",
"id" : "auth0|6a21dc7aa1db2e036a222942"
}
}
},
"_links" : {
"self" : {
"href" : "https://app.meltano.com/api/jobs/c4df3e9a-b12c-4cda-a54a-9afd8b0fce1b"
},
"delete job" : {
"href" : "https://app.meltano.com/api/jobs/c4df3e9a-b12c-4cda-a54a-9afd8b0fce1b",
"type" : "DELETE"
},
"logs" : {
"href" : "https://app.meltano.com/api/jobs/c4df3e9a-b12c-4cda-a54a-9afd8b0fce1b/logs?sequence=0",
"type" : "GET"
},
"withdraw job" : {
"href" : "https://app.meltano.com/api/jobs/c4df3e9a-b12c-4cda-a54a-9afd8b0fce1b/stopped",
"type" : "PUT"
}
}
}