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

# List a folder's jobs

> The folder's compute jobs, newest first: status and conclusion, queue, time limit, Slurm state, exit, cost, and each ended job's copied outputs.



## OpenAPI

````yaml /openapi.json get /folders/{id}/jobs
openapi: 3.1.0
info:
  title: Nemonist API
  version: 1.0.0
  description: >-
    OpenRouter-compatible API with durable per-workspace memory. Point any
    OpenRouter client at https://nemonist.com/api/v1 with a Nemonist key
    (sk-nm-...). Chat completions, Responses and Messages requests from a
    workspace carrying a .nemonist/key get its memory; every other request is
    answered as OpenRouter would.
  contact:
    name: Nemonist
    url: https://nemonist.com
servers:
  - url: https://nemonist.com/api/v1
    description: Production
security:
  - apiKey: []
tags:
  - description: API key management endpoints
    name: API Keys
  - description: Analytics and usage endpoints
    name: Analytics
  - description: Anthropic Messages endpoints
    name: Anthropic Messages
  - description: BYOK endpoints
    name: BYOK
  - description: Benchmarks endpoints
    name: Benchmarks
  - description: Chat completion endpoints
    name: Chat
  - description: Credit management endpoints
    name: Credits
  - description: >-
      Public OpenRouter usage datasets. Data returned by these endpoints is
      licensed under CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/):
      reuse and republish it, including commercially, with attribution to
      OpenRouter.
    name: Datasets
  - description: Text embedding endpoints
    name: Embeddings
  - description: Endpoint information
    name: Endpoints
  - name: Folders
    description: >-
      Your memory folders, over your account's API key: read, export, upload,
      and manage keys.
  - description: Generation history endpoints
    name: Generations
  - description: Guardrails endpoints
    name: Guardrails
  - description: Images endpoints
    name: Images
  - name: Memory
    description: Nemonist's per-workspace memory.
  - name: Model runs
    description: Run models (physics and others) on inputs; one contract for every model
  - description: Model information endpoints
    name: Models
  - description: OAuth authentication endpoints
    name: OAuth
  - description: Organization endpoints
    name: Organization
  - description: Private Endpoints endpoints
    name: Private Endpoints
  - description: Provider information endpoints
    name: Providers
  - description: Rerank endpoints
    name: Rerank
  - description: OpenAI-compatible Responses API endpoints
    name: Responses
  - description: Speech-to-text endpoints
    name: STT
    x-displayName: Transcriptions
  - description: >-
      System One endpoints for models such as Jev, compatible with the TypeSafe
      SDKs. See https://openrouter.ai/docs/guides/community/typesafe-sdk.
    name: SystemOne
    x-displayName: System One
  - description: Text-to-speech endpoints
    name: TTS
    x-displayName: Speech
  - description: Video Generation endpoints
    name: Video Generation
  - description: Workspaces endpoints
    name: Workspaces
  - name: beta.responses
    description: >-
      Deprecated alias of responses. Use responses instead; scheduled for
      removal (sunset date TBD).
paths:
  /folders/{id}/jobs:
    get:
      tags:
        - Folders
      summary: List a folder's jobs
      description: >-
        The folder's compute jobs, newest first: status and conclusion, queue,
        time limit, Slurm state, exit, cost, and each ended job's copied
        outputs.
      operationId: listFolderJobs
      parameters:
        - name: id
          in: path
          required: true
          description: The folder's id (fld_...), as GET /folders lists it.
          schema:
            type: string
      responses:
        '200':
          description: The folder's jobs.
          content:
            application/json:
              schema:
                type: object
                description: The folder's jobs.
                properties:
                  jobs:
                    type: array
                    description: Jobs, newest first.
                    items:
                      type: object
                      additionalProperties: {}
                      description: A job and its outputs.
                      properties:
                        id:
                          type: string
                          description: The job's id.
                        status:
                          type: string
                          enum:
                            - queued
                            - pending
                            - in_progress
                            - completed
                          description: >-
                            queued: waiting for a node; pending: held by a
                            dependency; in_progress: started on a node;
                            completed: ended.
                        conclusion:
                          type: string
                          enum:
                            - success
                            - failure
                            - cancelled
                            - timed_out
                            - out_of_memory
                            - startup_failure
                          description: >-
                            Once completed: success (exit 0, or a model run's
                            completed result), failure, cancelled, timed_out
                            (its time limit), out_of_memory, or startup_failure
                            (it never ran: not submitted, or its node failed
                            before the script started). Absent until completed.
                        state:
                          type: string
                          description: >-
                            Slurm's own state as last settled (COMPLETED,
                            FAILED, TIMEOUT, ...).
                        running:
                          type: boolean
                          description: True until it ends.
                        taskConclusions:
                          type: array
                          description: >-
                            A job array once it ended: each task with its own
                            status and conclusion (absent for one job).
                          items:
                            type: object
                            properties:
                              task:
                                type: integer
                                description: Its $SLURM_ARRAY_TASK_ID.
                              status:
                                type: string
                                enum:
                                  - queued
                                  - pending
                                  - in_progress
                                  - completed
                                description: completed (the array has ended).
                              conclusion:
                                type: string
                                enum:
                                  - success
                                  - failure
                                  - cancelled
                                  - timed_out
                                  - out_of_memory
                                  - startup_failure
                                description: This task's own conclusion, as for a job.
                              exit:
                                type: string
                                description: Slurm's exit code as given (3:0, 0:15, ...).
                        rerunOf:
                          type: string
                          description: >-
                            A rerun (jobs action rerun, or Re-run on the Jobs
                            page): the id of attempt 1, the job it reruns.
                            Absent on a first attempt.
                        attempt:
                          type: integer
                          description: >-
                            A rerun's attempt number (2, 3, ...). Absent on a
                            first attempt; earlier attempts keep their own
                            state, cost and outputs.
                        rerunTasks:
                          type: array
                          items:
                            type: integer
                          description: >-
                            A rerun of an array's failed tasks: the task ids it
                            ran (its --array).
                        annotations:
                          type: array
                          description: >-
                            The job's ::error::, ::warning:: and ::notice::
                            lines from its stdout, read once when it ended (at
                            most 10).
                          items:
                            type: object
                            properties:
                              level:
                                type: string
                                enum:
                                  - error
                                  - warning
                                  - notice
                                description: Which workflow command the line used.
                              message:
                                type: string
                                description: >-
                                  The text after the ::level:: marker (at most
                                  200 characters).
                              task:
                                type: integer
                                description: An array task's id.
                        group:
                          type: string
                          description: >-
                            The job's concurrency group from its `#NM group
                            NAME` line (GITHUB_STUDY slice 22): a later submit
                            in the group waits pending behind this job, or
                            cancels it with `cancel-older`.
                required:
                  - jobs
        '401':
          description: Missing or invalid key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NemonistError'
        '404':
          description: No such folder under your account, or it is another member's.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NemonistError'
        '500':
          description: 'Nemonist: an internal error answered this request; retry.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NemonistError'
        '503':
          description: 'Nemonist: the account service is temporarily unavailable; retry.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NemonistError'
components:
  schemas:
    NemonistError:
      type: object
      description: An error answer.
      required:
        - error
      properties:
        error:
          type: object
          description: What went wrong.
          required:
            - message
          properties:
            code:
              type:
                - integer
                - string
              description: HTTP status or a short error code.
            type:
              type: string
              description: Error kind, such as proxy_error.
            message:
              type: string
              description: Human-readable error message.
  securitySchemes:
    apiKey:
      type: http
      scheme: bearer
      description: >-
        A Nemonist key (sk-nm-...) as a bearer token in the Authorization
        header.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.