> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nebius.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Lifecycle and statuses of endpoints and jobs

Every Serverless AI endpoint and job has a status that indicates its current stage in the lifecycle. You can see the status in the [web console](https://console.nebius.com), or in the `status.state` field returned by the CLI and REST API.

## Endpoint statuses

| Status              | Description                                                                                                   |
| ------------------- | ------------------------------------------------------------------------------------------------------------- |
| `STATE_UNSPECIFIED` | Serverless AI has not classified the status yet.                                                              |
| `PROVISIONING`      | The endpoint is creating resources.                                                                           |
| `STARTING`          | The endpoint is being started.                                                                                |
| `IMAGE_PULLING`     | The endpoint is pulling the container image.                                                                  |
| `RUNNING`           | The endpoint is running and serving requests.                                                                 |
| `STOPPING`          | The endpoint is being stopped.                                                                                |
| `STOPPED`           | The endpoint has been stopped. You can start it again later.                                                  |
| `DELETING`          | The endpoint is being deleted.                                                                                |
| `ERROR`             | The endpoint could not run because of either a problem with your workload or an internal Serverless AI error. |

## Job statuses

| Status              | Description                                                                                                            |
| ------------------- | ---------------------------------------------------------------------------------------------------------------------- |
| `STATE_UNSPECIFIED` | Serverless AI has not classified the status yet.                                                                       |
| `PROVISIONING`      | The job is creating resources.                                                                                         |
| `STARTING`          | The job is being started.                                                                                              |
| `IMAGE_PULLING`     | The job is pulling the container image.                                                                                |
| `RUNNING`           | The job is running.                                                                                                    |
| `COMPLETED`         | The job has successfully completed.                                                                                    |
| `CANCELLING`        | The job is being cancelled.                                                                                            |
| `CANCELLED`         | The job has been cancelled.                                                                                            |
| `DELETING`          | The job is being deleted.                                                                                              |
| `FAILED`            | The job did not complete successfully, for example, because of an error in your code or image, or an exceeded timeout. |
| `ERROR`             | An internal Serverless AI error occurred.                                                                              |

## Typical transitions

When an endpoint starts, it moves through the following statuses:

`PROVISIONING` → `STARTING` → `IMAGE_PULLING` → `RUNNING`

When you stop and then start an endpoint again:

`RUNNING` → `STOPPING` → `STOPPED` → `STARTING` → `IMAGE_PULLING` → `RUNNING`

When a job runs to completion:

`PROVISIONING` → `STARTING` → `IMAGE_PULLING` → `RUNNING` → `COMPLETED`

When you cancel a running job:

`RUNNING` → `CANCELLING` → `CANCELLED`

`IMAGE_PULLING` can be quick enough that the status never surfaces.

## Failed and errored workloads

The `FAILED` and `ERROR` statuses indicate different kinds of problems:

* `FAILED` applies to jobs only and means the job did not complete successfully, for example, because of an error in your code, an incorrect entrypoint, a missing dependency in the image, or an exceeded timeout.
* `ERROR` means Serverless AI could not run the workload. For jobs, this indicates an internal Serverless AI error rather than a problem with your workload. Endpoints have no `FAILED` status, so their `ERROR` covers workload problems as well, such as a container that could not start.

To tell these causes apart, check the status details in the [web console](https://console.nebius.com), or the `status.state_details` field in the CLI, before you retry. Its `code` and `message` name the cause:

* `StartFailed`: A container that could not start
* `ContainerFailed`: A workload that exited with a non-zero code
* `TimeoutExceeded`: A job that ran out of time
* `NotEnoughResources`: No capacity for the requested platform and preset

When the status details are empty, the cause is internal to Serverless AI. Retry your job or endpoint, and if the status persists, [contact support](https://console.nebius.com/support/create-ticket). For deeper investigation, see [Debugging failed jobs and endpoints](/serverless/jobs/failure).

## Provisioning timeout

An endpoint or job waits in `PROVISIONING` until compute capacity becomes available. If it does not become available within 30 minutes, the resource reports `ERROR` with the `NotEnoughResources` code. Delete the resource and create it again with a different platform or preset.