POST
/
enterprise
/
v1
/
io-cloud
/
caas
/
deploy
Deploy a Container
curl --request POST \
  --url https://api.io.solutions/enterprise/v1/io-cloud/caas/deploy \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "resource_private_name": "<string>",
  "duration_hours": 123,
  "gpus_per_container": 123,
  "hardware_id": 123,
  "location_ids": [
    123
  ],
  "container_config": {},
  "registry_config": {},
  "replica_count": 123,
  "env_variables": {},
  "secret_env_variables": {},
  "entrypoint": [
    "<string>"
  ],
  "args": [
    "<string>"
  ],
  "traffic_port": 123,
  "image_url": "<string>",
  "registry_username": "<string>",
  "registry_secret": "<string>"
}'
{
  "status": "string",
  "deployment_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}

Authorizations

​
Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Body

application/json
​
resource_private_name
string
required

Must be a unique string identifying the deployment.

​
duration_hours
integer
required

Duration of the deployment in hours.

​
gpus_per_container
integer
required

Must be set to 8.

​
hardware_id
integer
required

Use values from the Inventory Browsing API.

​
location_ids
integer[]
required

Array of region/location IDs. Use values from the Inventory Browsing API.

​
container_config
object
required

Configuration of the container to deploy. See below.

​
registry_config
object
required

Docker image registry credentials and image details. See below.

​
replica_count
integer
required

Number of container replicas to run.

​
entrypoint
string[]
required

Array of strings in exec form that overrides the container’s default entrypoint. Example: ["python3", "-m", "my.app"].

​
traffic_port
integer
required

Port on which the container exposes its HTTP service. Used for internal health checks.

​
env_variables
object

Key-value pairs of environment variables.

​
secret_env_variables
object

Same as env_variables, but securely stored. Only visible in actual deployments.

​
args
string[]

Array of strings to append to the entrypoint. Must contain at least one item.

​
image_url
string

Full Docker image path (e.g., ghcr.io/org/image:tag).

​
registry_username
string

Username for container registry.

​
registry_secret
string

Access token or password for container registry.

Response

200

​
status
string
Example:

"string"

​
deployment_id
string
Example:

"3fa85f64-5717-4562-b3fc-2c963f66afa6"