RL

Stop model resources

Stops every session attached to the resource and tears down its GPU pods.

post/rl/model-resources/{model_resources_id}/stop

Path parameters

model_resources_idstring required

ID of the model resource

Query parameters

forceboolean

Stop the resource even if active training sessions are attached

Response

Model resource details

idstring required

Unique identifier for the model resource

status'MODEL_RESOURCES_STATUS_PENDING' | 'MODEL_RESOURCES_STATUS_CREATING' | 'MODEL_RESOURCES_STATUS_READY' | 'MODEL_RESOURCES_STATUS_ERROR' | 'MODEL_RESOURCES_STATUS_STOPPED' | 'MODEL_RESOURCES_STATUS_STOPPING' required

Lifecycle status of a model resource

base_modelstring required

Base model the resource is provisioned for

lora_enabledboolean required

Whether the resource hosts LoRA sessions or a full-weight session

created_atstring date-time required

Timestamp when the model resource was created

updated_atstring date-time required

Timestamp when the model resource was last updated

created_bystring required

ID of the user who created the model resource

Example response

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "error": {
    "message": "Timed out waiting for cluster capacity. Try again later.",
    "occurred_at": "2026-01-02T00:00:05Z"
  },
  "base_model": "Qwen/Qwen3-0.6B",
  "compute_config": {
    "num_generator_replicas": 1
  },
  "lora_enabled": true,
  "created_at": "2026-01-02T00:00:00Z",
  "updated_at": "2026-01-02T00:00:05Z",
  "created_by": "user_123"
}

Changes

Changed in 2 of the 14 revisions of this API.13

  • 42c9ead8f2f511See the full diff
    • added the new MODEL_RESOURCES_ERROR_CODE_CAPACITY_WAIT_TIMEOUT enum value to the error/code response property for the response status 200

      response-property-enum-value-added

    • removed the MODEL_RESOURCES_ERROR_CODE_CAPACITY_UNAVAILABLE enum value from the error/code response property for the response status 200

      response-property-enum-value-removed

    • added the required property created_by to the response with the 200 status

      response-required-property-added

    • added the required property optimizer_config to the response with the 200 status

      response-required-property-added

    This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog