Runs

get
Get List of Runs

https://sharedcloud.io/api/v1/runs/
This endpoint allows you to get the list of runs
Request
Response
Headers
Authorization
required
string
Authentication token
200: OK
List of runs successfully retrieved.
[
{
"uuid": "8b199e68-b301-4ba6-9498-f5b2beee2a35",
"current_server_time": "05-10-2018 15:16:10",
"base_gpu_name": "Nvidia Tesla P4 8GB",
"num_jobs": 1,
"function_name": "mnist",
"created_at": "05-10-2018 13:20:13",
"parameters": "((512, 0.2, 10, 2),)",
"bid_price": 0.3,
"function": "9a9420da-a848-4523-a138-d3cf47007131",
"base_gpu": "e4c0d486-d74e-4248-824b-e6dd39464a85"
}
]
401: Unauthorized
Invalid credentials.
{
"detail": "Invalid token."
}

get
Get Run

https://sharedcloud.io/api/v1/runs/:uuid/
This endpoint allows you to get a single run
Request
Response
Path Parameters
uuid
required
string
uuid of the run
Headers
Authorization
required
string
Authentication token
200: OK
Run successfully retrieved
{
"uuid": "9d194068-b241-4aa6-9448-f4b26eee1a35",
"current_server_time": "05-10-2018 15:16:10",
"base_gpu_name": "Nvidia Tesla P4 8GB",
"num_jobs": 1,
"function_name": "mnist",
"created_at": "05-10-2018 13:20:13",
"parameters": "((512, 0.2, 10, 2),)",
"bid_price": 0.3,
"function": "9a9f20da-a848-4523-a138-ddcf35007131",
"base_gpu": "e6c0dd86-d7ee-4248-844b-e6dd394aaa85"
}
401: Unauthorized
Invalid credentials.
{
"detail": "Invalid token."
}
404: Not Found
Run not found
{
"detail": "Not found."
}

post
Create Run

https://sharedcloud.io/api/v1/runs/
This endpoint allows you to create a run
Request
Response
Headers
Authorization
required
string
Authentication token
Body Parameters
base_gpu
optional
string
UUID of the required GPU (Only for GPU images)
function
required
string
UUID of the function
bid_price
required
number
bid price of the run
parameters
required
string
parameters of the run
200: OK
Run successfully created
{
"uuid": "ebcc4d16-04b2-45c4-9520-9e50a4931bd6",
"num_jobs": 1,
"base_gpu": None,
"base_gpu_name": 'n/a',
"bid_price": 1.0,
"function_name": "mnist",
"created_at": "05-10-2018 14:51:12",
"parameters": "((512, 0.2, 10, 2),)",
"function": "594864fa-d4f4-4cc3-844b-74546a76ce52",
"current_server_time": "05-10-2018 14:55:12"
}
401: Unauthorized
Invalid credentials.
{
"detail": "Invalid token."
}

delete
Delete Run

https://sharedcloud.io/api/v1/runs/:uuid/
This endpoint allows you to delete a run
Request
Response
Path Parameters
uuid
required
string
uuid of the run
Headers
Authorization
required
string
Authentication token
200: OK
Run deleted successfully.
{}
401: Unauthorized
Invalid credentials.
{
"detail": "Invalid token."
}
404: Not Found
Run not found
{
"detail": "Not found."
}