# Pods

## Create Pod

> Create a new pod

```json
{"openapi":"3.1.0","info":{"title":"saas-platform","version":"1.0.0"},"tags":[{"name":"API v2","description":"Yotta API v2 - RESTful endpoints"},{"name":"Pods v2","description":"Pods API v2"}],"servers":[{"url":"https://api.yottalabs.ai","description":"Generated server url"}],"security":[{}],"paths":{"/v2/pods":{"post":{"tags":["API v2","Pods v2"],"summary":"Create Pod","description":"Create a new pod","operationId":"createPod","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PodV2CreateRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResultObject"}}}},"400":{"description":"Bad Request","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResultObject"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResultObject"}}}},"10000":{"description":"Pod created successfully","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResultPodV2Response"}}}},"10001":{"description":"Invalid request parameters","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Result"}}}}}}}},"components":{"schemas":{"PodV2CreateRequest":{"type":"object","description":"Pod Create Request v2","properties":{"regions":{"type":"array","description":"Acceptable region codes","items":{"type":"string"},"uniqueItems":true},"name":{"type":"string","description":"Pod name","maxLength":255,"minLength":1},"image":{"type":"string","description":"Docker image name","maxLength":255,"minLength":1},"containerRegistryAuthId":{"type":"integer","format":"int64","description":"Container registry auth ID"},"imageRegistry":{"type":"string","description":"Image registry URL","maxLength":255,"minLength":0},"imagePublicType":{"type":"string","description":"Image type: PUBLIC or PRIVATE"},"resourceType":{"type":"string","description":"Resource type: GPU or CPU"},"gpuType":{"type":"string","description":"GPU type","minLength":1},"gpuCount":{"type":"integer","format":"int32","description":"GPU count (must be power of 2)"},"shmInGb":{"type":"integer","format":"int32","description":"Shared memory size in GB"},"minSingleCardRamInGb":{"type":"integer","format":"int32","description":"Minimum single card RAM in GB"},"minSingleCardVramInGb":{"type":"integer","format":"int32","description":"Minimum single card VRAM in GB"},"minSingleCardVcpu":{"type":"integer","format":"int32","description":"Minimum single card vCPU count"},"containerVolumeInGb":{"type":"integer","format":"int32","description":"Container volume size in GB"},"persistentVolumeInGb":{"type":"integer","format":"int32","description":"Persistent volume size in GB"},"initializationCommand":{"type":"string","description":"Initialization command"},"environmentVars":{"type":"array","description":"Environment variables","items":{"$ref":"#/components/schemas/KeyValuePairDTO"}},"expose":{"type":"array","description":"Ports to expose","items":{"$ref":"#/components/schemas/OpenapiPodExposePortRequest"}},"persistentVolumes":{"type":"array","description":"Persistent volumes","items":{"$ref":"#/components/schemas/PersistentVolumesRequest"}}},"required":["gpuCount","gpuType","image","name"]},"KeyValuePairDTO":{"type":"object","description":"KeyValuePairDTO","properties":{"key":{"type":"string","description":"key","minLength":1},"value":{"type":"string","description":"value","minLength":1}},"required":["key","value"]},"OpenapiPodExposePortRequest":{"type":"object","description":"OpenapiPodExposePortRequest","properties":{"port":{"type":"integer","format":"int32","description":"port","maximum":65535,"minimum":0},"protocol":{"type":"string","description":"protocol"}},"required":["port"]},"PersistentVolumesRequest":{"type":"object","description":"PersistentVolumesRequest","properties":{"id":{"type":"integer","format":"int64","description":"pv id"},"name":{"type":"string","description":"pv name"},"volumeType":{"type":"string","description":"NFS or CloudStorage"},"mountMode":{"type":"string","description":"mountMode"},"volumeSize":{"type":"integer","format":"int32","description":"volumeSize"},"volumePrice":{"type":"number","description":"volume price"},"mountPath":{"type":"string","description":"mount path","minLength":1},"cloudStorageType":{"type":"string","description":"cloud storage type, currently only S3, may support R2 in future"},"systemVolumeType":{"type":"string","description":"System volume type: Local or Ceph. Required when volumeType is System"},"systemVolumeTypeEnum":{"type":"string","enum":["LOCAL","CEPH"]}},"required":["mountPath","volumeType"]},"ResultObject":{"type":"object","properties":{"message":{"type":"string","description":"message"},"code":{"type":"integer","format":"int32","description":"code"},"data":{"description":"data"}}},"ResultPodV2Response":{"type":"object","properties":{"message":{"type":"string","description":"message"},"code":{"type":"integer","format":"int32","description":"code"},"data":{"$ref":"#/components/schemas/PodV2Response","description":"data"}}},"PodV2Response":{"type":"object","description":"Pod Response v2","properties":{"id":{"type":"integer","format":"int64","description":"Pod ID"},"orgId":{"type":"integer","format":"int64","description":"Organization ID"},"applicantId":{"type":"integer","format":"int64","description":"User ID who created the pod"},"name":{"type":"string","description":"Pod name"},"imageId":{"type":"integer","format":"int64","description":"Image ID"},"officialImage":{"type":"string","description":"Image source","enum":["OFFICIAL","CUSTOM"]},"imagePublicType":{"type":"string","description":"Image type","enum":["PUBLIC","PRIVATE"]},"image":{"type":"string","description":"Docker image name"},"imageRegistry":{"type":"string","description":"Image registry URL"},"imageRegistryUsername":{"type":"string","description":"Image registry username"},"resourceType":{"type":"string","description":"Resource type","enum":["GPU","CPU"]},"gpuType":{"type":"string","description":"GPU type (e.g., RTX_4090_24G)"},"gpuDisplayName":{"type":"string","description":"GPU display name"},"gpuCount":{"type":"integer","format":"int32","description":"Number of GPUs"},"shmInGb":{"type":"integer","format":"int32","description":"Shared memory in GB"},"singleCardVramInGb":{"type":"integer","format":"int32","description":"Single card VRAM in GB"},"singleCardRamInGb":{"type":"integer","format":"int32","description":"Single card RAM in GB"},"singleCardVcpu":{"type":"integer","format":"int32","description":"Single card vCPU count"},"location":{"type":"string","description":"Location"},"region":{"type":"string","description":"Region code"},"cloudType":{"type":"string","description":"Cloud type","enum":["SECURE","COMMUNITY"]},"containerVolumeInGb":{"type":"integer","format":"int32","description":"Container volume in GB"},"persistentVolumeInGb":{"type":"integer","format":"int32","description":"Persistent volume in GB"},"persistentMountPath":{"type":"string","description":"Persistent volume mount path"},"networkUploadMbps":{"type":"number","description":"Network upload speed (Mbps)"},"networkDownloadMbps":{"type":"number","description":"Network download speed (Mbps)"},"diskReadSpeedMbps":{"type":"number","description":"Disk read speed (Mbps)"},"diskWriteSpeedMbps":{"type":"number","description":"Disk write speed (Mbps)"},"singleCardPrice":{"type":"number","description":"GPU single card price"},"persistentVolumePrice":{"type":"number","description":"Persistent volume price"},"containerVolumePrice":{"type":"number","description":"Container volume price"},"initializationCommand":{"type":"string","description":"Initialization command"},"environmentVars":{"type":"array","description":"Environment variables","items":{"$ref":"#/components/schemas/KeyValuePairDTO"}},"expose":{"type":"array","description":"Exposed ports","items":{"$ref":"#/components/schemas/OpenapiPodExposePortResponse"}},"sshCmd":{"type":"string","description":"SSH command template"},"status":{"type":"string","description":"Pod status","enum":["INITIALIZING","RUNNING","PAUSING","PAUSED","TERMINATING","TERMINATED","FAILED","PENDING","PREPARING"]},"createdAt":{"type":"integer","format":"int64","description":"Creation timestamp (epoch milliseconds)"},"updatedAt":{"type":"integer","format":"int64","description":"Last update timestamp (epoch milliseconds)"},"persistentVolumes":{"type":"array","description":"Persistent volumes","items":{"$ref":"#/components/schemas/PersistentVolumesResponse"}},"internalIp":{"type":"string","description":"Internal IP address"},"desiredState":{"type":"string","description":"Desired state","enum":["RUNNING","PAUSED"]}}},"OpenapiPodExposePortResponse":{"type":"object","description":"OpenapiPodExposePortResponse","properties":{"port":{"type":"integer","format":"int32","description":"port","maximum":65535,"minimum":0},"proxyPort":{"type":"integer","format":"int32","description":"proxy port"},"protocol":{"type":"string","description":"protocol"},"host":{"type":"string","description":"host"},"healthy":{"type":"boolean","description":"healthy"},"ingressUrl":{"type":"string","description":"ingress url"},"serviceName":{"type":"string","description":"service name"}},"required":["port"]},"PersistentVolumesResponse":{"type":"object","description":"PersistentVolumesResponse","properties":{"id":{"type":"integer","format":"int64","description":"pv id"},"name":{"type":"string","description":"pv name"},"volumeType":{"type":"string","description":"Ceph or CloudStorage"},"volumeSize":{"type":"integer","format":"int32","description":"volumeSize"},"volumePrice":{"type":"number","description":"volume price"},"mountPath":{"type":"string","description":"mount path","minLength":1},"cloudStorageType":{"type":"string","description":"cloud storage type, currently only S3, may support R2 in future"},"systemVolumeType":{"type":"string","description":"System volume type: Local or Ceph (only for System volumeType)"}},"required":["mountPath","volumeType"]},"Result":{"type":"object","properties":{"message":{"type":"string","description":"message"},"code":{"type":"integer","format":"int32","description":"code"},"data":{"description":"data"}}}}}}
```

## Delete Pod

> Delete a pod

```json
{"openapi":"3.1.0","info":{"title":"saas-platform","version":"1.0.0"},"tags":[{"name":"API v2","description":"Yotta API v2 - RESTful endpoints"},{"name":"Pods v2","description":"Pods API v2"}],"servers":[{"url":"https://api.yottalabs.ai","description":"Generated server url"}],"security":[{}],"paths":{"/v2/pods/{id}":{"delete":{"tags":["API v2","Pods v2"],"summary":"Delete Pod","description":"Delete a pod","operationId":"deletePod","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResultObject"}}}},"400":{"description":"Bad Request","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResultObject"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResultObject"}}}},"10000":{"description":"Pod deleted","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResultVoid"}}}},"13000":{"description":"Pod not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Result"}}}}}}}},"components":{"schemas":{"ResultObject":{"type":"object","properties":{"message":{"type":"string","description":"message"},"code":{"type":"integer","format":"int32","description":"code"},"data":{"description":"data"}}},"ResultVoid":{"type":"object","properties":{"message":{"type":"string","description":"message"},"code":{"type":"integer","format":"int32","description":"code"},"data":{"description":"data"}}},"Result":{"type":"object","properties":{"message":{"type":"string","description":"message"},"code":{"type":"integer","format":"int32","description":"code"},"data":{"description":"data"}}}}}}
```

## Resume Pod

> Resume a paused pod

```json
{"openapi":"3.1.0","info":{"title":"saas-platform","version":"1.0.0"},"tags":[{"name":"API v2","description":"Yotta API v2 - RESTful endpoints"},{"name":"Pods v2","description":"Pods API v2"}],"servers":[{"url":"https://api.yottalabs.ai","description":"Generated server url"}],"security":[{}],"paths":{"/v2/pods/{id}/resume":{"post":{"tags":["API v2","Pods v2"],"summary":"Resume Pod","description":"Resume a paused pod","operationId":"resumePod","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResultObject"}}}},"400":{"description":"Bad Request","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResultObject"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResultObject"}}}},"10000":{"description":"Pod resumed","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResultVoid"}}}},"13000":{"description":"Pod not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Result"}}}}}}}},"components":{"schemas":{"ResultObject":{"type":"object","properties":{"message":{"type":"string","description":"message"},"code":{"type":"integer","format":"int32","description":"code"},"data":{"description":"data"}}},"ResultVoid":{"type":"object","properties":{"message":{"type":"string","description":"message"},"code":{"type":"integer","format":"int32","description":"code"},"data":{"description":"data"}}},"Result":{"type":"object","properties":{"message":{"type":"string","description":"message"},"code":{"type":"integer","format":"int32","description":"code"},"data":{"description":"data"}}}}}}
```

## Pause Pod

> Pause a running pod

```json
{"openapi":"3.1.0","info":{"title":"saas-platform","version":"1.0.0"},"tags":[{"name":"API v2","description":"Yotta API v2 - RESTful endpoints"},{"name":"Pods v2","description":"Pods API v2"}],"servers":[{"url":"https://api.yottalabs.ai","description":"Generated server url"}],"security":[{}],"paths":{"/v2/pods/{id}/pause":{"post":{"tags":["API v2","Pods v2"],"summary":"Pause Pod","description":"Pause a running pod","operationId":"pausePod","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResultObject"}}}},"400":{"description":"Bad Request","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResultObject"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResultObject"}}}},"10000":{"description":"Pod paused","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResultVoid"}}}},"13000":{"description":"Pod not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Result"}}}}}}}},"components":{"schemas":{"ResultObject":{"type":"object","properties":{"message":{"type":"string","description":"message"},"code":{"type":"integer","format":"int32","description":"code"},"data":{"description":"data"}}},"ResultVoid":{"type":"object","properties":{"message":{"type":"string","description":"message"},"code":{"type":"integer","format":"int32","description":"code"},"data":{"description":"data"}}},"Result":{"type":"object","properties":{"message":{"type":"string","description":"message"},"code":{"type":"integer","format":"int32","description":"code"},"data":{"description":"data"}}}}}}
```

## List Pods

> Get all pods for your organization

```json
{"openapi":"3.1.0","info":{"title":"saas-platform","version":"1.0.0"},"tags":[{"name":"API v2","description":"Yotta API v2 - RESTful endpoints"},{"name":"Pods v2","description":"Pods API v2"}],"servers":[{"url":"https://api.yottalabs.ai","description":"Generated server url"}],"security":[{}],"paths":{"/v2/pods":{"get":{"tags":["API v2","Pods v2"],"summary":"List Pods","description":"Get all pods for your organization","operationId":"listPods","parameters":[{"name":"regionList","in":"query","required":false,"schema":{"type":"array","items":{"type":"string"}}},{"name":"statusList","in":"query","description":"Filter by status names, e.g. RUNNING, PAUSED, TERMINATED","required":false,"schema":{"type":"array","items":{"type":"string"}}}],"responses":{"200":{"description":"Success, returns list of pods","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResultListPodV2Response"}}}},"400":{"description":"Bad Request","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResultObject"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResultObject"}}}},"10000":{"description":"Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResultListPodV2Response"}}}}}}}},"components":{"schemas":{"ResultListPodV2Response":{"type":"object","properties":{"message":{"type":"string","description":"message"},"code":{"type":"integer","format":"int32","description":"code"},"data":{"type":"array","description":"data","items":{"$ref":"#/components/schemas/PodV2Response"}}}},"PodV2Response":{"type":"object","description":"Pod Response v2","properties":{"id":{"type":"integer","format":"int64","description":"Pod ID"},"orgId":{"type":"integer","format":"int64","description":"Organization ID"},"applicantId":{"type":"integer","format":"int64","description":"User ID who created the pod"},"name":{"type":"string","description":"Pod name"},"imageId":{"type":"integer","format":"int64","description":"Image ID"},"officialImage":{"type":"string","description":"Image source","enum":["OFFICIAL","CUSTOM"]},"imagePublicType":{"type":"string","description":"Image type","enum":["PUBLIC","PRIVATE"]},"image":{"type":"string","description":"Docker image name"},"imageRegistry":{"type":"string","description":"Image registry URL"},"imageRegistryUsername":{"type":"string","description":"Image registry username"},"resourceType":{"type":"string","description":"Resource type","enum":["GPU","CPU"]},"gpuType":{"type":"string","description":"GPU type (e.g., RTX_4090_24G)"},"gpuDisplayName":{"type":"string","description":"GPU display name"},"gpuCount":{"type":"integer","format":"int32","description":"Number of GPUs"},"shmInGb":{"type":"integer","format":"int32","description":"Shared memory in GB"},"singleCardVramInGb":{"type":"integer","format":"int32","description":"Single card VRAM in GB"},"singleCardRamInGb":{"type":"integer","format":"int32","description":"Single card RAM in GB"},"singleCardVcpu":{"type":"integer","format":"int32","description":"Single card vCPU count"},"location":{"type":"string","description":"Location"},"region":{"type":"string","description":"Region code"},"cloudType":{"type":"string","description":"Cloud type","enum":["SECURE","COMMUNITY"]},"containerVolumeInGb":{"type":"integer","format":"int32","description":"Container volume in GB"},"persistentVolumeInGb":{"type":"integer","format":"int32","description":"Persistent volume in GB"},"persistentMountPath":{"type":"string","description":"Persistent volume mount path"},"networkUploadMbps":{"type":"number","description":"Network upload speed (Mbps)"},"networkDownloadMbps":{"type":"number","description":"Network download speed (Mbps)"},"diskReadSpeedMbps":{"type":"number","description":"Disk read speed (Mbps)"},"diskWriteSpeedMbps":{"type":"number","description":"Disk write speed (Mbps)"},"singleCardPrice":{"type":"number","description":"GPU single card price"},"persistentVolumePrice":{"type":"number","description":"Persistent volume price"},"containerVolumePrice":{"type":"number","description":"Container volume price"},"initializationCommand":{"type":"string","description":"Initialization command"},"environmentVars":{"type":"array","description":"Environment variables","items":{"$ref":"#/components/schemas/KeyValuePairDTO"}},"expose":{"type":"array","description":"Exposed ports","items":{"$ref":"#/components/schemas/OpenapiPodExposePortResponse"}},"sshCmd":{"type":"string","description":"SSH command template"},"status":{"type":"string","description":"Pod status","enum":["INITIALIZING","RUNNING","PAUSING","PAUSED","TERMINATING","TERMINATED","FAILED","PENDING","PREPARING"]},"createdAt":{"type":"integer","format":"int64","description":"Creation timestamp (epoch milliseconds)"},"updatedAt":{"type":"integer","format":"int64","description":"Last update timestamp (epoch milliseconds)"},"persistentVolumes":{"type":"array","description":"Persistent volumes","items":{"$ref":"#/components/schemas/PersistentVolumesResponse"}},"internalIp":{"type":"string","description":"Internal IP address"},"desiredState":{"type":"string","description":"Desired state","enum":["RUNNING","PAUSED"]}}},"KeyValuePairDTO":{"type":"object","description":"KeyValuePairDTO","properties":{"key":{"type":"string","description":"key","minLength":1},"value":{"type":"string","description":"value","minLength":1}},"required":["key","value"]},"OpenapiPodExposePortResponse":{"type":"object","description":"OpenapiPodExposePortResponse","properties":{"port":{"type":"integer","format":"int32","description":"port","maximum":65535,"minimum":0},"proxyPort":{"type":"integer","format":"int32","description":"proxy port"},"protocol":{"type":"string","description":"protocol"},"host":{"type":"string","description":"host"},"healthy":{"type":"boolean","description":"healthy"},"ingressUrl":{"type":"string","description":"ingress url"},"serviceName":{"type":"string","description":"service name"}},"required":["port"]},"PersistentVolumesResponse":{"type":"object","description":"PersistentVolumesResponse","properties":{"id":{"type":"integer","format":"int64","description":"pv id"},"name":{"type":"string","description":"pv name"},"volumeType":{"type":"string","description":"Ceph or CloudStorage"},"volumeSize":{"type":"integer","format":"int32","description":"volumeSize"},"volumePrice":{"type":"number","description":"volume price"},"mountPath":{"type":"string","description":"mount path","minLength":1},"cloudStorageType":{"type":"string","description":"cloud storage type, currently only S3, may support R2 in future"},"systemVolumeType":{"type":"string","description":"System volume type: Local or Ceph (only for System volumeType)"}},"required":["mountPath","volumeType"]},"ResultObject":{"type":"object","properties":{"message":{"type":"string","description":"message"},"code":{"type":"integer","format":"int32","description":"code"},"data":{"description":"data"}}}}}}
```

## Get Pod

> Get details of a specific pod

```json
{"openapi":"3.1.0","info":{"title":"saas-platform","version":"1.0.0"},"tags":[{"name":"API v2","description":"Yotta API v2 - RESTful endpoints"},{"name":"Pods v2","description":"Pods API v2"}],"servers":[{"url":"https://api.yottalabs.ai","description":"Generated server url"}],"security":[{}],"paths":{"/v2/pods/{id}":{"get":{"tags":["API v2","Pods v2"],"summary":"Get Pod","description":"Get details of a specific pod","operationId":"getPod","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResultObject"}}}},"400":{"description":"Bad Request","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResultObject"}}}},"500":{"description":"Internal Server Error","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResultObject"}}}},"10000":{"description":"Pod found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResultPodV2Response"}}}},"13000":{"description":"Pod not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Result"}}}}}}}},"components":{"schemas":{"ResultObject":{"type":"object","properties":{"message":{"type":"string","description":"message"},"code":{"type":"integer","format":"int32","description":"code"},"data":{"description":"data"}}},"ResultPodV2Response":{"type":"object","properties":{"message":{"type":"string","description":"message"},"code":{"type":"integer","format":"int32","description":"code"},"data":{"$ref":"#/components/schemas/PodV2Response","description":"data"}}},"PodV2Response":{"type":"object","description":"Pod Response v2","properties":{"id":{"type":"integer","format":"int64","description":"Pod ID"},"orgId":{"type":"integer","format":"int64","description":"Organization ID"},"applicantId":{"type":"integer","format":"int64","description":"User ID who created the pod"},"name":{"type":"string","description":"Pod name"},"imageId":{"type":"integer","format":"int64","description":"Image ID"},"officialImage":{"type":"string","description":"Image source","enum":["OFFICIAL","CUSTOM"]},"imagePublicType":{"type":"string","description":"Image type","enum":["PUBLIC","PRIVATE"]},"image":{"type":"string","description":"Docker image name"},"imageRegistry":{"type":"string","description":"Image registry URL"},"imageRegistryUsername":{"type":"string","description":"Image registry username"},"resourceType":{"type":"string","description":"Resource type","enum":["GPU","CPU"]},"gpuType":{"type":"string","description":"GPU type (e.g., RTX_4090_24G)"},"gpuDisplayName":{"type":"string","description":"GPU display name"},"gpuCount":{"type":"integer","format":"int32","description":"Number of GPUs"},"shmInGb":{"type":"integer","format":"int32","description":"Shared memory in GB"},"singleCardVramInGb":{"type":"integer","format":"int32","description":"Single card VRAM in GB"},"singleCardRamInGb":{"type":"integer","format":"int32","description":"Single card RAM in GB"},"singleCardVcpu":{"type":"integer","format":"int32","description":"Single card vCPU count"},"location":{"type":"string","description":"Location"},"region":{"type":"string","description":"Region code"},"cloudType":{"type":"string","description":"Cloud type","enum":["SECURE","COMMUNITY"]},"containerVolumeInGb":{"type":"integer","format":"int32","description":"Container volume in GB"},"persistentVolumeInGb":{"type":"integer","format":"int32","description":"Persistent volume in GB"},"persistentMountPath":{"type":"string","description":"Persistent volume mount path"},"networkUploadMbps":{"type":"number","description":"Network upload speed (Mbps)"},"networkDownloadMbps":{"type":"number","description":"Network download speed (Mbps)"},"diskReadSpeedMbps":{"type":"number","description":"Disk read speed (Mbps)"},"diskWriteSpeedMbps":{"type":"number","description":"Disk write speed (Mbps)"},"singleCardPrice":{"type":"number","description":"GPU single card price"},"persistentVolumePrice":{"type":"number","description":"Persistent volume price"},"containerVolumePrice":{"type":"number","description":"Container volume price"},"initializationCommand":{"type":"string","description":"Initialization command"},"environmentVars":{"type":"array","description":"Environment variables","items":{"$ref":"#/components/schemas/KeyValuePairDTO"}},"expose":{"type":"array","description":"Exposed ports","items":{"$ref":"#/components/schemas/OpenapiPodExposePortResponse"}},"sshCmd":{"type":"string","description":"SSH command template"},"status":{"type":"string","description":"Pod status","enum":["INITIALIZING","RUNNING","PAUSING","PAUSED","TERMINATING","TERMINATED","FAILED","PENDING","PREPARING"]},"createdAt":{"type":"integer","format":"int64","description":"Creation timestamp (epoch milliseconds)"},"updatedAt":{"type":"integer","format":"int64","description":"Last update timestamp (epoch milliseconds)"},"persistentVolumes":{"type":"array","description":"Persistent volumes","items":{"$ref":"#/components/schemas/PersistentVolumesResponse"}},"internalIp":{"type":"string","description":"Internal IP address"},"desiredState":{"type":"string","description":"Desired state","enum":["RUNNING","PAUSED"]}}},"KeyValuePairDTO":{"type":"object","description":"KeyValuePairDTO","properties":{"key":{"type":"string","description":"key","minLength":1},"value":{"type":"string","description":"value","minLength":1}},"required":["key","value"]},"OpenapiPodExposePortResponse":{"type":"object","description":"OpenapiPodExposePortResponse","properties":{"port":{"type":"integer","format":"int32","description":"port","maximum":65535,"minimum":0},"proxyPort":{"type":"integer","format":"int32","description":"proxy port"},"protocol":{"type":"string","description":"protocol"},"host":{"type":"string","description":"host"},"healthy":{"type":"boolean","description":"healthy"},"ingressUrl":{"type":"string","description":"ingress url"},"serviceName":{"type":"string","description":"service name"}},"required":["port"]},"PersistentVolumesResponse":{"type":"object","description":"PersistentVolumesResponse","properties":{"id":{"type":"integer","format":"int64","description":"pv id"},"name":{"type":"string","description":"pv name"},"volumeType":{"type":"string","description":"Ceph or CloudStorage"},"volumeSize":{"type":"integer","format":"int32","description":"volumeSize"},"volumePrice":{"type":"number","description":"volume price"},"mountPath":{"type":"string","description":"mount path","minLength":1},"cloudStorageType":{"type":"string","description":"cloud storage type, currently only S3, may support R2 in future"},"systemVolumeType":{"type":"string","description":"System volume type: Local or Ceph (only for System volumeType)"}},"required":["mountPath","volumeType"]},"Result":{"type":"object","properties":{"message":{"type":"string","description":"message"},"code":{"type":"integer","format":"int32","description":"code"},"data":{"description":"data"}}}}}}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.yottalabs.ai/api-and-sdk/api-reference-v2/pods.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.