Skip to main content
POST
/
v1
/
accounts
/
{account_id}
/
environments
Create Environment
curl --request POST \
  --url https://api.fireworks.ai/v1/accounts/{account_id}/environments \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "environment": {
    "displayName": "<string>",
    "baseImageRef": "<string>",
    "shared": true,
    "annotations": {}
  },
  "environmentId": "<string>"
}
'
{
  "name": "<string>",
  "displayName": "<string>",
  "createTime": "2023-11-07T05:31:56Z",
  "createdBy": "<string>",
  "state": "STATE_UNSPECIFIED",
  "status": {
    "code": "OK",
    "message": "<string>"
  },
  "connection": {
    "nodePoolId": "<string>",
    "numRanks": 123,
    "role": "<string>",
    "zone": "<string>",
    "useLocalStorage": true
  },
  "baseImageRef": "<string>",
  "imageRef": "<string>",
  "snapshotImageRef": "<string>",
  "shared": true,
  "annotations": {},
  "updateTime": "2023-11-07T05:31:56Z"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication using your Fireworks API key. Format: Bearer <API_KEY>

Path Parameters

​
account_id
string
required

The Account Id

Body

application/json
​
environment
Next ID: 14 · object
required

The properties of the Environment being created.

​
environmentId
string
required

Response

200 - application/json

A successful response.

​
name
string
​
displayName
string
​
createTime
string<date-time>

The creation time of the environment.

​
createdBy
string

The email address of the user who created this environment.

​
state
enum<string>
default:STATE_UNSPECIFIED

The current state of the environment.

Available options:
STATE_UNSPECIFIED,
CREATING,
DISCONNECTED,
CONNECTING,
CONNECTED,
DISCONNECTING,
RECONNECTING,
DELETING
​
status
Mimics [https://github.com/googleapis/googleapis/blob/master/google/rpc/status.proto] · object

The current error status of the environment.

​
connection
Next ID: 8 · object

Information about the current environment connection.

​
baseImageRef
string

The URI of the base container image used for this environment.

​
imageRef
string

The URI of the container image used for this environment. This is a image is an immutable snapshot of the base_image_ref when the environment was created.

​
snapshotImageRef
string

The URI of the latest container image snapshot for this environment.

​
shared
boolean

Whether the environment is shared with all users in the account. This allows all users to connect, disconnect, update, delete, clone, and create batch jobs using the environment.

​
annotations
object

Arbitrary, user-specified metadata. Keys and values must adhere to Kubernetes constraints: https://kubernetes.io/docs/concepts/overview/working-with-objects/annotations/#syntax-and-character-set Additionally, the "fireworks.ai/" prefix is reserved.

​
updateTime
string<date-time>

The update time for the environment.