jobs

List jobs

Changed on

List of jobs for an entity

get/api/jobs/{namespace}

Request

  • Base URL: https://huggingface.co
  • URL: https://huggingface.co/api/jobs/{namespace}
  • Auth: HTTP bearer

Path parameters

namespacestring required

Query parameters

string

Filter jobs by label. Format: 'key=value' (e.g., 'environment=production').

OR
string[]
'COMPLETED' | 'CANCELED' | 'ERROR' | 'DELETED' | 'RUNNING' | 'SCHEDULING'
OR
string[]
cursorstring

Pagination cursor obtained from the rel="next" link of a previous response's Link header.

Response

The list of jobs

idstring required
createdAtstring date-time required
spaceIdstring
dockerImagestring
timeoutnumber
environmentobject required
commandstring[]
argumentsstring[]
arch'amd64' | 'arm64'
flavor'cpu-basic' | 'cpu-upgrade' | 'cpu-performance' | 'cpu-xl' | 'sprx8' | 'zero-a10g' | 't4-small' | 't4-medium' | 'l4x1' | 'l4x4' | 'l40sx1' | 'l40sx4' | 'l40sx8' | 'a10g-small' | 'a10g-large' | 'a10g-largex2' | 'a10g-largex4' | 'a100-large' | 'a100x4' | 'a100x8' | 'h200' | 'h200x2' | 'h200x4' | 'h200x8' | 'rtx-pro-6000' | 'rtx-pro-6000x2' | 'rtx-pro-6000x4' | 'rtx-pro-6000x8' | 'inf2x6' required
resourceGroupIdstring
retrynumber
startedAtstring date-time
finishedAtstring date-time
type'job' required
secretsstring[]
labelsobject

Changes

  • 26fa67a904a2Revision changes
    • warning

      added the new SPEND_LIMIT enum value to the /// response property for the response status

  • c447fcdd4d16Revision changes
    • info

      added the optional property / to the response with the status