% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/job.R
\name{job_ls}
\alias{job_ls}
\title{List recent DNAnexus jobs in the current project}
\usage{
job_ls(n = 20, state = NULL)
}
\arguments{
\item{n}{(integer) Maximum number of recent jobs to return. Must be a
single positive integer. Default: \code{20}.}

\item{state}{(character) Filter by state(s). Must be \code{NULL} or a
character vector of valid states:
\code{"idle"}, \code{"runnable"}, \code{"running"}, \code{"done"},
\code{"failed"}, \code{"terminated"}.
Default: \code{NULL} (return all).}
}
\value{
A data.frame with columns:
\describe{
\item{job_id}{Job ID string, e.g. \code{"job-XXXX"}.}
\item{name}{Job name (typically \code{"Table exporter"}).}
\item{state}{Current job state.}
\item{created}{Job creation time (\code{POSIXct}).}
\item{runtime}{Runtime string (e.g. \code{"0:04:36"}), \code{NA} if
still running.}
}
}
\description{
Returns a summary of the most recent jobs, optionally filtered by state.
Useful for quickly reviewing which jobs have completed, failed, or are
still running.
}
\examples{
\dontrun{
job_ls()
job_ls(n = 5)
job_ls(state = "failed")
job_ls(state = c("done", "failed"))
}
}
