API Reference
- docs
- pods
- endpoints
- network volumes
- templates
- container registry auth
- billing
pods
Create a new Pod
Creates a new Pod and optionally deploys it.
POST
/
pods
curl --request POST \
--url https://rest.runpod.io/v1/pods \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"allowedCudaVersions": [
"12.8"
],
"cloudType": "SECURE",
"computeType": "GPU",
"containerDiskInGb": 50,
"containerRegistryAuthId": "clzdaifot0001l90809257ynb",
"countryCodes": [
"<string>"
],
"cpuFlavorIds": [
"cpu3c"
],
"cpuFlavorPriority": "availability",
"dataCenterIds": [
"EU-RO-1",
"CA-MTL-1"
],
"dataCenterPriority": "availability",
"dockerEntrypoint": [],
"dockerStartCmd": [],
"env": {
"ENV_VAR": "value"
},
"globalNetworking": true,
"gpuCount": 1,
"gpuTypeIds": [
"NVIDIA GeForce RTX 4090"
],
"gpuTypePriority": "availability",
"imageName": "runpod/pytorch:2.1.0-py3.10-cuda11.8.0-devel-ubuntu22.04",
"interruptible": false,
"locked": false,
"minDiskBandwidthMBps": 123,
"minDownloadMbps": 123,
"minRAMPerGPU": 8,
"minUploadMbps": 123,
"minVCPUPerGPU": 2,
"name": "my pod",
"networkVolumeId": "<string>",
"ports": [
"8888/http",
"22/tcp"
],
"supportPublicIp": true,
"templateId": null,
"vcpuCount": 2,
"volumeInGb": 20,
"volumeMountPath": "/workspace"
}'
{
"adjustedCostPerHr": 0.69,
"aiApiId": null,
"consumerUserId": "user_2PyTJrLzeuwfZilRZ7JhCQDuSqo",
"containerDiskInGb": 50,
"containerRegistryAuthId": "clzdaifot0001l90809257ynb",
"costPerHr": "0.74",
"cpuFlavorId": "cpu3c",
"desiredStatus": "RUNNING",
"dockerEntrypoint": [
"<string>"
],
"dockerStartCmd": [
"<string>"
],
"endpointId": null,
"env": {
"ENV_VAR": "value"
},
"gpu": {
"id": "<string>",
"count": 1,
"displayName": "<string>",
"securePrice": 123,
"communityPrice": 123,
"oneMonthPrice": 123,
"threeMonthPrice": 123,
"sixMonthPrice": 123,
"oneWeekPrice": 123,
"communitySpotPrice": 123,
"secureSpotPrice": 123
},
"id": "xedezhzb9la3ye",
"image": "runpod/pytorch:2.1.0-py3.10-cuda11.8.0-devel-ubuntu22.04",
"interruptible": false,
"lastStartedAt": "2024-07-12T19:14:40.144Z",
"lastStatusChange": "Rented by User: Fri Jul 12 2024 15:14:40 GMT-0400 (Eastern Daylight Time)",
"locked": false,
"machine": {
"minPodGpuCount": 123,
"gpuTypeId": "<string>",
"gpuType": {
"id": "<string>",
"count": 1,
"displayName": "<string>",
"securePrice": 123,
"communityPrice": 123,
"oneMonthPrice": 123,
"threeMonthPrice": 123,
"sixMonthPrice": 123,
"oneWeekPrice": 123,
"communitySpotPrice": 123,
"secureSpotPrice": 123
},
"cpuCount": 123,
"cpuTypeId": "<string>",
"cpuType": {
"id": "<string>",
"displayName": "<string>",
"cores": 123,
"threadsPerCore": 123,
"groupId": "<string>"
},
"location": "<string>",
"dataCenterId": "<string>",
"diskThroughputMBps": 123,
"maxDownloadSpeedMbps": 123,
"maxUploadSpeedMbps": 123,
"supportPublicIp": true,
"secureCloud": true,
"maintenanceStart": "<string>",
"maintenanceEnd": "<string>",
"maintenanceNote": "<string>",
"note": "<string>",
"costPerHr": 123,
"currentPricePerGpu": 123,
"gpuAvailable": 123,
"gpuDisplayName": "<string>"
},
"machineId": "s194cr8pls2z",
"memoryInGb": 62,
"name": "<string>",
"networkVolume": {
"id": "agv6w2qcg7",
"name": "my network volume",
"size": 50,
"dataCenterId": "EU-RO-1"
},
"portMappings": {
"22": 10341
},
"ports": [
"8888/http",
"22/tcp"
],
"publicIp": "100.65.0.119",
"savingsPlans": [
{
"costPerHr": 0.21,
"endTime": "2024-07-12T19:14:40.144Z",
"gpuTypeId": "NVIDIA GeForce RTX 4090",
"id": "clkrb4qci0000mb09c7sualzo",
"podId": "xedezhzb9la3ye",
"startTime": "2024-05-12T19:14:40.144Z"
}
],
"slsVersion": 0,
"templateId": null,
"vcpuCount": 24,
"volumeEncrypted": false,
"volumeInGb": 20,
"volumeMountPath": "/workspace"
}
Authorizations
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Body
application/json
Input for Pod creation.
The body is of type object
.
Response
201
application/json
Pod successfully created.
The response is of type object
.
Was this page helpful?
curl --request POST \
--url https://rest.runpod.io/v1/pods \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"allowedCudaVersions": [
"12.8"
],
"cloudType": "SECURE",
"computeType": "GPU",
"containerDiskInGb": 50,
"containerRegistryAuthId": "clzdaifot0001l90809257ynb",
"countryCodes": [
"<string>"
],
"cpuFlavorIds": [
"cpu3c"
],
"cpuFlavorPriority": "availability",
"dataCenterIds": [
"EU-RO-1",
"CA-MTL-1"
],
"dataCenterPriority": "availability",
"dockerEntrypoint": [],
"dockerStartCmd": [],
"env": {
"ENV_VAR": "value"
},
"globalNetworking": true,
"gpuCount": 1,
"gpuTypeIds": [
"NVIDIA GeForce RTX 4090"
],
"gpuTypePriority": "availability",
"imageName": "runpod/pytorch:2.1.0-py3.10-cuda11.8.0-devel-ubuntu22.04",
"interruptible": false,
"locked": false,
"minDiskBandwidthMBps": 123,
"minDownloadMbps": 123,
"minRAMPerGPU": 8,
"minUploadMbps": 123,
"minVCPUPerGPU": 2,
"name": "my pod",
"networkVolumeId": "<string>",
"ports": [
"8888/http",
"22/tcp"
],
"supportPublicIp": true,
"templateId": null,
"vcpuCount": 2,
"volumeInGb": 20,
"volumeMountPath": "/workspace"
}'
{
"adjustedCostPerHr": 0.69,
"aiApiId": null,
"consumerUserId": "user_2PyTJrLzeuwfZilRZ7JhCQDuSqo",
"containerDiskInGb": 50,
"containerRegistryAuthId": "clzdaifot0001l90809257ynb",
"costPerHr": "0.74",
"cpuFlavorId": "cpu3c",
"desiredStatus": "RUNNING",
"dockerEntrypoint": [
"<string>"
],
"dockerStartCmd": [
"<string>"
],
"endpointId": null,
"env": {
"ENV_VAR": "value"
},
"gpu": {
"id": "<string>",
"count": 1,
"displayName": "<string>",
"securePrice": 123,
"communityPrice": 123,
"oneMonthPrice": 123,
"threeMonthPrice": 123,
"sixMonthPrice": 123,
"oneWeekPrice": 123,
"communitySpotPrice": 123,
"secureSpotPrice": 123
},
"id": "xedezhzb9la3ye",
"image": "runpod/pytorch:2.1.0-py3.10-cuda11.8.0-devel-ubuntu22.04",
"interruptible": false,
"lastStartedAt": "2024-07-12T19:14:40.144Z",
"lastStatusChange": "Rented by User: Fri Jul 12 2024 15:14:40 GMT-0400 (Eastern Daylight Time)",
"locked": false,
"machine": {
"minPodGpuCount": 123,
"gpuTypeId": "<string>",
"gpuType": {
"id": "<string>",
"count": 1,
"displayName": "<string>",
"securePrice": 123,
"communityPrice": 123,
"oneMonthPrice": 123,
"threeMonthPrice": 123,
"sixMonthPrice": 123,
"oneWeekPrice": 123,
"communitySpotPrice": 123,
"secureSpotPrice": 123
},
"cpuCount": 123,
"cpuTypeId": "<string>",
"cpuType": {
"id": "<string>",
"displayName": "<string>",
"cores": 123,
"threadsPerCore": 123,
"groupId": "<string>"
},
"location": "<string>",
"dataCenterId": "<string>",
"diskThroughputMBps": 123,
"maxDownloadSpeedMbps": 123,
"maxUploadSpeedMbps": 123,
"supportPublicIp": true,
"secureCloud": true,
"maintenanceStart": "<string>",
"maintenanceEnd": "<string>",
"maintenanceNote": "<string>",
"note": "<string>",
"costPerHr": 123,
"currentPricePerGpu": 123,
"gpuAvailable": 123,
"gpuDisplayName": "<string>"
},
"machineId": "s194cr8pls2z",
"memoryInGb": 62,
"name": "<string>",
"networkVolume": {
"id": "agv6w2qcg7",
"name": "my network volume",
"size": 50,
"dataCenterId": "EU-RO-1"
},
"portMappings": {
"22": 10341
},
"ports": [
"8888/http",
"22/tcp"
],
"publicIp": "100.65.0.119",
"savingsPlans": [
{
"costPerHr": 0.21,
"endTime": "2024-07-12T19:14:40.144Z",
"gpuTypeId": "NVIDIA GeForce RTX 4090",
"id": "clkrb4qci0000mb09c7sualzo",
"podId": "xedezhzb9la3ye",
"startTime": "2024-05-12T19:14:40.144Z"
}
],
"slsVersion": 0,
"templateId": null,
"vcpuCount": 24,
"volumeEncrypted": false,
"volumeInGb": 20,
"volumeMountPath": "/workspace"
}