Deployments
Deployments let the user schedule a job to deploy the contents of their workspace repository to their workspace in the Matatika cloud.
This can be done manually or via a GitHub Webhook which you can see how to set up in our Quick Start Guide: Workspace Deploy Hook
Requests
Deploy your workspace repository
POST
/api/workspaces/{workspaces-id}/deployments
Deploys the workspace {workspace-id}.
Request
Example Snippets
cURL
curl -H "Authorization: Bearer $ACCESS_TOKEN" 'https://app.matatika.com:443/api/workspaces/b7d6069f-b0b9-4efa-b8e0-4ed7a24e1181/deployments' -i -X POST \
-H 'Accept: application/json, application/javascript, text/javascript, text/json' \
-H 'Content-Type: application/json'
Python (requests)
import requests
url = "https://app.matatika.com:443/api/workspaces/b7d6069f-b0b9-4efa-b8e0-4ed7a24e1181/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" : "2303fa61-91ec-4f09-8dd8-b8771341eb33",
"created" : "2025-03-10T20:11:19.423484",
"type" : "WORKSPACE_DEPLOY",
"maxAttempts" : 0,
"attempt" : 0,
"status" : "QUEUED",
"_embedded" : {
"profile" : {
"id" : "auth0|5eb0327cbfd7490bff55feeb",
"name" : "[email protected]",
"handle" : "@sit+prod",
"email" : "[email protected]"
}
},
"_links" : {
"self" : {
"href" : "https://app.matatika.com/api/jobs/2303fa61-91ec-4f09-8dd8-b8771341eb33"
},
"delete job" : {
"href" : "https://app.matatika.com/api/jobs/2303fa61-91ec-4f09-8dd8-b8771341eb33",
"type" : "DELETE"
},
"logs" : {
"href" : "https://app.matatika.com/api/jobs/2303fa61-91ec-4f09-8dd8-b8771341eb33/logs?sequence=0",
"type" : "GET"
},
"withdraw job" : {
"href" : "https://app.matatika.com/api/jobs/2303fa61-91ec-4f09-8dd8-b8771341eb33/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.
Request
Example Snippets
cURL
curl -H "Authorization: Bearer $ACCESS_TOKEN" 'https://app.matatika.com:443/api/workspaces/b7d6069f-b0b9-4efa-b8e0-4ed7a24e1181/deployments/github-webhook' -i -X POST \
-H 'Accept: application/json, application/javascript, text/javascript, text/json' \
-H 'X-Hub-Signature: sha1=6e9fbcaf20ec89641e2d471baf843905516a9626' \
-H 'Content-Type: application/json' \
-d '{ }'
Python (requests)
import requests
url = "https://app.matatika.com:443/api/workspaces/b7d6069f-b0b9-4efa-b8e0-4ed7a24e1181/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" : "2750a41d-8433-4a83-bc40-33674e6ffca2",
"created" : "2025-03-10T20:11:36.496919",
"type" : "WORKSPACE_DEPLOY",
"maxAttempts" : 0,
"attempt" : 0,
"status" : "QUEUED",
"_embedded" : {
"profile" : {
"id" : "auth0|5eb0327cbfd7490bff55feeb",
"name" : "[email protected]",
"handle" : "@sit+prod",
"email" : "[email protected]"
}
},
"_links" : {
"self" : {
"href" : "https://app.matatika.com/api/jobs/2750a41d-8433-4a83-bc40-33674e6ffca2"
},
"delete job" : {
"href" : "https://app.matatika.com/api/jobs/2750a41d-8433-4a83-bc40-33674e6ffca2",
"type" : "DELETE"
},
"logs" : {
"href" : "https://app.matatika.com/api/jobs/2750a41d-8433-4a83-bc40-33674e6ffca2/logs?sequence=0",
"type" : "GET"
},
"withdraw job" : {
"href" : "https://app.matatika.com/api/jobs/2750a41d-8433-4a83-bc40-33674e6ffca2/stopped",
"type" : "PUT"
}
}
}