cURL
curl --request POST \
--url https://api.baseten.co/v1/chains/{chain_id}/environments \
--header "Authorization: Api-Key $BASETEN_API_KEY" \
--data '{
  "name": "staging",
  "promotion_settings": {
    "ramp_up_duration_seconds": 600,
    "ramp_up_while_promoting": true,
    "redeploy_on_promotion": true
  },
  "chainlet_settings": [
    {
      "autoscaling_settings": {
        "autoscaling_window": 800,
        "concurrency_target": 4,
        "max_replica": 3,
        "min_replica": 2,
        "scale_down_delay": 63
      },
      "chainlet_name": "HelloWorld",
      "instance_type_id": "2x8"
    },
    {
      "autoscaling_settings": {
        "autoscaling_window": null,
        "concurrency_target": null,
        "max_replica": 3,
        "min_replica": 3,
        "scale_down_delay": null
      },
      "chainlet_name": "RandInt",
      "instance_type_id": "A10Gx8x32"
    }
  ]
}'
{
  "name": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "chain_id": "<string>",
  "promotion_settings": {
    "redeploy_on_promotion": true,
    "ramp_up_while_promoting": true,
    "ramp_up_duration_seconds": 600
  },
  "chainlet_settings": [
    {
      "chainlet_name": "<string>",
      "autoscaling_settings": {
        "min_replica": 123,
        "max_replica": 123,
        "autoscaling_window": 123,
        "scale_down_delay": 123,
        "concurrency_target": 123
      },
      "instance_type": {
        "id": "<string>",
        "name": "<string>",
        "memory_limit_mib": 123,
        "millicpu_limit": 123,
        "gpu_count": 123,
        "gpu_type": "<string>",
        "gpu_memory_limit_mib": 123
      }
    }
  ],
  "current_deployment": {
    "id": "<string>",
    "created_at": "2023-11-07T05:31:56Z",
    "chain_id": "<string>",
    "environment": "<string>",
    "chainlets": [
      {
        "id": "<string>",
        "name": "<string>",
        "autoscaling_settings": {
          "min_replica": 123,
          "max_replica": 123,
          "autoscaling_window": 123,
          "scale_down_delay": 123,
          "concurrency_target": 123
        },
        "instance_type_name": "<string>",
        "active_replica_count": 123,
        "status": "BUILDING"
      }
    ],
    "status": "BUILDING"
  }
}

Authorizations

Authorization
string
header
required

You must specify the scheme 'Api-Key' in the Authorization header. For example, Authorization: Api-Key <Your_Api_Key>

Path Parameters

chain_id
string
required

Body

application/json

A request to create a custom environment for a chain.

name
string
required

Name of the environment

Examples:

"staging"

promotion_settings
object | null

Promotion settings for the environment Promotion settings for promoting chains and oracles

Examples:
{
"ramp_up_duration_seconds": 600,
"ramp_up_while_promoting": true,
"redeploy_on_promotion": true
}
chainlet_settings
ChainletEnvironmentSettingsRequestV1 · object[] | null

Mapping of chainlet name to the desired chainlet environment settings

Examples:
[
{
"autoscaling_settings": {
"autoscaling_window": 800,
"concurrency_target": 4,
"max_replica": 3,
"min_replica": 2,
"scale_down_delay": 63
},
"chainlet_name": "HelloWorld",
"instance_type_id": "2x8"
},
{
"autoscaling_settings": {
"autoscaling_window": null,
"concurrency_target": null,
"max_replica": 3,
"min_replica": 3,
"scale_down_delay": null
},
"chainlet_name": "RandInt",
"instance_type_id": "A10Gx8x32"
}
]

Response

200 - application/json

Environment for oracles.

name
string
required

Name of the environment

created_at
string<date-time>
required

Time the environment was created in ISO 8601 format

chain_id
string
required

Unique identifier of the chain

promotion_settings
object
required

Promotion settings for the environment

chainlet_settings
ChainletEnvironmentSettingsV1 · object[]
required

Environment settings for the chainlets

current_deployment
object | null
required

Current chain deployment of the environment A deployment of a chain.