v27

latestOpenAPI 3.1.0raw.githubusercontent.com2026-04-22216424765.0 KB
gateway.openapi_Gateway

Update Batch Job

patch/v1/accounts/{account_id}/batchJobs/{batch_job_id}

Path parameters

account_idstring required

The Account Id

batch_job_idstring required

The Batch Job Id

Request body

displayNamestring

Human-readable display name of the batch job. e.g. "My Batch Job" Must be fewer than 64 characters long.

createTimestring date-time

The creation time of the batch job.

startTimestring date-time

The time when the batch job started running.

endTimestring date-time

The time when the batch job completed, failed, or was cancelled.

createdBystring

The email address of the user who created this batch job.

nodePoolIdstring required
environmentIdstring

The ID of the environment that this batch job should use. e.g. my-env If specified, image_ref must not be specified.

snapshotIdstring

The ID of the snapshot used by this batch job. If specified, environment_id must be specified and image_ref must not be specified.

numRanksinteger

For GPU node pools: one GPU per rank w/ host packing, for CPU node pools: one host per rank.

envVarsobject

Environment variables to be passed during this job's execution.

rolestring

The ARN of the AWS IAM role that the batch job should assume. If not specified, the connection will fall back to the node pool's node_role.

imageRefstring

The container image used by this job. If specified, environment_id and snapshot_id must not be specified.

annotationsobject

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.

state'STATE_UNSPECIFIED' | 'CREATING' | 'QUEUED' | 'PENDING' | 'RUNNING' | 'COMPLETED' | 'FAILED' | 'CANCELLING' | 'CANCELLED' | 'DELETING'
  • CREATING: The batch job is being created.
  • QUEUED: The batch job is in the queue and waiting to be scheduled. Currently unused.
  • PENDING: The batch job scheduled and is waiting for resource allocation.
  • RUNNING: The batch job is running.
  • COMPLETED: The batch job has finished successfully.
  • FAILED: The batch job has failed.
  • CANCELLING: The batch job is being cancelled.
  • CANCELLED: The batch job was cancelled.
  • DELETING: The batch job is being deleted.
statusstring

Detailed information about the current status of the batch job.

sharedboolean

Whether the batch job is shared with all users in the account. This allows all users to update, delete, clone, and create environments using the batch job.

updateTimestring date-time

The update time for the batch job.

Response

A successful response.

namestring
displayNamestring

Human-readable display name of the batch job. e.g. "My Batch Job" Must be fewer than 64 characters long.

createTimestring date-time

The creation time of the batch job.

startTimestring date-time

The time when the batch job started running.

endTimestring date-time

The time when the batch job completed, failed, or was cancelled.

createdBystring

The email address of the user who created this batch job.

nodePoolIdstring required
environmentIdstring

The ID of the environment that this batch job should use. e.g. my-env If specified, image_ref must not be specified.

snapshotIdstring

The ID of the snapshot used by this batch job. If specified, environment_id must be specified and image_ref must not be specified.

numRanksinteger

For GPU node pools: one GPU per rank w/ host packing, for CPU node pools: one host per rank.

envVarsobject

Environment variables to be passed during this job's execution.

rolestring

The ARN of the AWS IAM role that the batch job should assume. If not specified, the connection will fall back to the node pool's node_role.

imageRefstring

The container image used by this job. If specified, environment_id and snapshot_id must not be specified.

annotationsobject

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.

state'STATE_UNSPECIFIED' | 'CREATING' | 'QUEUED' | 'PENDING' | 'RUNNING' | 'COMPLETED' | 'FAILED' | 'CANCELLING' | 'CANCELLED' | 'DELETING'
  • CREATING: The batch job is being created.
  • QUEUED: The batch job is in the queue and waiting to be scheduled. Currently unused.
  • PENDING: The batch job scheduled and is waiting for resource allocation.
  • RUNNING: The batch job is running.
  • COMPLETED: The batch job has finished successfully.
  • FAILED: The batch job has failed.
  • CANCELLING: The batch job is being cancelled.
  • CANCELLED: The batch job was cancelled.
  • DELETING: The batch job is being deleted.
statusstring

Detailed information about the current status of the batch job.

sharedboolean

Whether the batch job is shared with all users in the account. This allows all users to update, delete, clone, and create environments using the batch job.

updateTimestring date-time

The update time for the batch job.