Pods

Create pod

post

Create pod

Authorizations

Authorizationx-api-key

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

OpenapiPodCreateRequest

imagePublicTypestringOptional

ImagePublicTypeEnum: PUBLIC, PRIVATE

resourceTypestringOptional

ResourceTypeEnum: GPU,CPU

regionstringOptional

Region

regionListstring[]Optional

Region List

podNamestringOptional

pod nick name

imagestring · min: 1 · max: 255Required

image name

imageRegistrystringOptional

image registry url

Default: https://index.docker.io/v1/

imageRegistryUsernamestringOptional

image registry username

imageRegistryTokenstringOptional

image registry token or password

gpuTypestring · min: 1Required

gpu type

gpuCountinteger · int32Optional

gpu count

shmInGbinteger · int32 · min: 1Optional

shm unit:GB

minSingleCardRamInGbinteger · int32 · max: 1536Optional

min single card ram unit: GB

minSingleCardVramInGbinteger · int32 · max: 1536Optional

min single card vram unit: GB

minSingleCardVcpuinteger · int32Optional

min single card vcpu unit: count

containerVolumeInGbinteger · int32Optional

container volume unit:GB

persistentVolumeInGbinteger · int32Optional

persistent volume unit:GB

persistentMountPathstringOptional

persistent mount path

initializationCommandstringOptional

initialization command

Responses

200

OK

*/*

400

Bad Request

*/*

500

Internal Server Error

*/*

post

/openapi/v1/pods/create

HTTPcURLJavaScriptPython

POST /openapi/v1/pods/create HTTP/1.1
Host: api.yottalabs.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 754

{
  "imagePublicType": "text",
  "resourceType": "text",
  "region": "text",
  "regionList": [
    "text"
  ],
  "podName": "text",
  "image": "text",
  "imageRegistry": "https://index.docker.io/v1/",
  "imageRegistryUsername": "text",
  "imageRegistryToken": "text",
  "gpuType": "text",
  "gpuCount": 1,
  "shmInGb": 1,
  "minSingleCardRamInGb": 1,
  "minSingleCardVramInGb": 1,
  "minSingleCardVcpu": 1,
  "containerVolumeInGb": 1,
  "persistentVolumeInGb": 1,
  "persistentMountPath": "text",
  "initializationCommand": "text",
  "environmentVars": [
    {
      "key": "text",
      "value": "text"
    }
  ],
  "expose": [
    {
      "port": 1,
      "protocol": "text"
    }
  ],
  "persistentVolumes": [
    {
      "id": 1,
      "name": "text",
      "volumeType": "text",
      "mountMode": "text",
      "volumeSize": 1,
      "volumePrice": 1,
      "mountPath": "text",
      "cloudStorageType": "text",
      "systemVolumeType": "text",
      "systemVolumeTypeEnum": "LOCAL"
    }
  ]
}

{
  "message": "text",
  "code": 1,
  "data": 1
}

Get pod detail

get

Fetch detailed information of a specific pod by its ID

Authorizations

Authorizationx-api-key

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

podIdinteger · int64Required

Responses

200

OK

*/*

400

Bad Request

*/*

500

Internal Server Error

*/*

get

/openapi/v1/pods/{podId}

HTTPcURLJavaScriptPython

GET /openapi/v1/pods/{podId} HTTP/1.1
Host: api.yottalabs.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "message": "text",
  "code": 1,
  "data": {
    "id": 1,
    "orgId": 1,
    "applicantId": 1,
    "podName": "text",
    "imageId": 1,
    "officialImage": "OFFICIAL",
    "imagePublicType": "PUBLIC",
    "image": "text",
    "imageRegistry": "text",
    "imageRegistryUsername": "text",
    "resourceType": "GPU",
    "gpuType": "text",
    "gpuDisplayName": "text",
    "gpuCount": 1,
    "shmInGb": 1,
    "singleCardVramInGb": 1,
    "singleCardRamInGb": 1,
    "singleCardVcpu": 1,
    "location": "text",
    "region": "text",
    "cloudType": "SECURE",
    "containerVolumeInGb": 1,
    "persistentVolumeInGb": 1,
    "persistentMountPath": "text",
    "networkUploadMbps": 1,
    "networkDownloadMbps": 1,
    "diskReadSpeedMbps": 1,
    "diskWriteSpeedMbps": 1,
    "singleCardPrice": 1,
    "persistentVolumePrice": 1,
    "containerVolumePrice": 1,
    "initializationCommand": "text",
    "environmentVars": [
      {
        "key": "text",
        "value": "text"
      }
    ],
    "expose": [
      {
        "port": 1,
        "proxyPort": 1,
        "protocol": "text",
        "host": "text",
        "healthy": true,
        "ingressUrl": "text",
        "serviceName": "text"
      }
    ],
    "sshCmd": "text",
    "status": "INITIALIZE",
    "createdAt": "2026-02-03T13:14:22.555Z",
    "updatedAt": "2026-02-03T13:14:22.555Z",
    "persistentVolumes": [
      {
        "id": 1,
        "name": "text",
        "volumeType": "text",
        "volumeSize": 1,
        "volumePrice": 1,
        "mountPath": "text",
        "cloudStorageType": "text",
        "systemVolumeType": "text"
      }
    ],
    "internalIp": "text"
  }
}

Get Org pod list

get

Get Org pod list

Authorizations

Authorizationx-api-key

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

regionListstring[]Optional

statusListinteger · int32[]Optional

Responses

200

OK

*/*

400

Bad Request

*/*

500

Internal Server Error

*/*

get

/openapi/v1/pods/list

HTTPcURLJavaScriptPython

GET /openapi/v1/pods/list HTTP/1.1
Host: api.yottalabs.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "message": "text",
  "code": 1,
  "data": [
    {
      "id": 1,
      "orgId": 1,
      "applicantId": 1,
      "podName": "text",
      "imageId": 1,
      "officialImage": "OFFICIAL",
      "imagePublicType": "PUBLIC",
      "image": "text",
      "imageRegistry": "text",
      "imageRegistryUsername": "text",
      "resourceType": "GPU",
      "gpuType": "text",
      "gpuDisplayName": "text",
      "gpuCount": 1,
      "shmInGb": 1,
      "singleCardVramInGb": 1,
      "singleCardRamInGb": 1,
      "singleCardVcpu": 1,
      "location": "text",
      "region": "text",
      "cloudType": "SECURE",
      "containerVolumeInGb": 1,
      "persistentVolumeInGb": 1,
      "persistentMountPath": "text",
      "networkUploadMbps": 1,
      "networkDownloadMbps": 1,
      "diskReadSpeedMbps": 1,
      "diskWriteSpeedMbps": 1,
      "singleCardPrice": 1,
      "persistentVolumePrice": 1,
      "containerVolumePrice": 1,
      "initializationCommand": "text",
      "environmentVars": [
        {
          "key": "text",
          "value": "text"
        }
      ],
      "expose": [
        {
          "port": 1,
          "proxyPort": 1,
          "protocol": "text",
          "host": "text",
          "healthy": true,
          "ingressUrl": "text",
          "serviceName": "text"
        }
      ],
      "sshCmd": "text",
      "status": "INITIALIZE",
      "createdAt": "2026-02-03T13:14:22.555Z",
      "updatedAt": "2026-02-03T13:14:22.555Z",
      "persistentVolumes": [
        {
          "id": 1,
          "name": "text",
          "volumeType": "text",
          "volumeSize": 1,
          "volumePrice": 1,
          "mountPath": "text",
          "cloudStorageType": "text",
          "systemVolumeType": "text"
        }
      ],
      "internalIp": "text"
    }
  ]
}

Pod resume

post

Pod resume

Authorizations

Authorizationx-api-key

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

podIdinteger · int64Required

Responses

200

OK

*/*

400

Bad Request

*/*

500

Internal Server Error

*/*

post

/openapi/v1/pods/resume/{podId}

HTTPcURLJavaScriptPython

POST /openapi/v1/pods/resume/{podId} HTTP/1.1
Host: api.yottalabs.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "message": "text",
  "code": 1,
  "data": null
}

Pod pause

post

Pod pause

Authorizations

Authorizationx-api-key

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

podIdinteger · int64Required

Responses

200

OK

*/*

400

Bad Request

*/*

500

Internal Server Error

*/*

post

/openapi/v1/pods/pause/{podId}

HTTPcURLJavaScriptPython

POST /openapi/v1/pods/pause/{podId} HTTP/1.1
Host: api.yottalabs.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "message": "text",
  "code": 1,
  "data": null
}