Skip to main content
    Ivy Biosciences Docs/Call the platform/API/Reference/Reference/Jobs/GET /v1/jobs/{jobId}/artifacts

    GET /v1/jobs/{jobId}/artifacts

    Download a job's output files — Lists the output files of a finished job you can read, each with a presigned download URL that expires after 5 minutes.

    Auth: required. Send an ivy_ API key (Authorization: Bearer ivy_…), a signed-in session token (Authorization: Bearer …) or the session cookie (browser sessions). See Authentication.

    Lists the output files of a finished job you can read, each with a presigned download URL that expires after 5 minutes. Fetch download_url with a plain GET and no auth header; call this route again for fresh URLs once they expire.

    Only files the job itself recorded are listed, and only those that exist in storage. A job you cannot read, a job outside your key's project scope and a job that does not exist all return the same 404. Guests cannot use this route.

    Request

    Path parameters

    jobIdstring (uuid)

    Job UUID.

    Query parameters

    typesstring

    Comma-separated file types to list, from pdb, sdf, csv, txt, zip and json. Defaults to all of them.

    Responses

    200 OK

    The job's output files with download URLs (an empty artifacts array when none are stored)

    Response shape:

    job_idstring (uuid)
    job_statusstring
    job_typestring
    expires_ininteger

    Seconds until the earliest download_url expires (at most 300)

    artifactsobject[]

    400 Bad Request

    types names an unknown file type

    Response shape: object

    401 Unauthorized

    Authentication required

    Response shape: object

    404 Not Found

    Resource not found

    Response shape: object

    409 Conflict

    The job has not completed yet; poll GET /api/v1/jobs/{job_id} first

    Response shape: object

    429 Too Many Requests

    Rate limit exceeded

    Response shape: object

    500 Internal Server Error

    Listing failed; the error is logged server-side

    Response shape: object

    503 Service Unavailable

    File storage is not available

    Response shape: object

    curl -X GET 'https://ivybiosciences.com/api/v1/jobs/{jobId}/artifacts' \
      -H "Authorization: Bearer $IVY_API_KEY"

    Was this page helpful?

    Loading...