job.list

Jobs, optionally filtered by owner, name, ID or active state.

Lists jobs, optionally only those of one customer or vendor (owner), the active ones, those whose name contains some text or one ID.

Examples

Example: with a copy of the synthetic/business-editable example book open as book.gnucash.

JSON-RPC

Request:

{"jsonrpc":"2.0","id":1,"method":"job.list","params":{"owner":"5b22073fa4e34411b07c14a77147ce6b"}}

Response:

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "jobs": [
      {
        "guid": "3048f991c36143769571bcc833015d53",
        "name": "Website rebuild",
        "…": "…"
      }
    ]
  }
}

Command line

red-ale exec --book book.gnucash job.list '{"owner":"5b22073fa4e34411b07c14a77147ce6b"}'

It prints:

{
  "jobs": [
    {
      "guid": "3048f991c36143769571bcc833015d53",
      "name": "Website rebuild",
      "…": "…"
    }
  ]
}

MCP tool call

Tool call:

{"name":"job.list","arguments":{"owner":"5b22073fa4e34411b07c14a77147ce6b"}}

Result:

{
  "structuredContent": {
    "jobs": [
      {
        "guid": "3048f991c36143769571bcc833015d53",
        "name": "Website rebuild",
        "…": "…"
      }
    ]
  }
}

Effect: read.

Params

Filters for job.list. All given filters must match.

owner (Guid or null): Only this customer's or vendor's jobs.
activeOnly (boolean): Only active jobs.
name (string or null): Case-insensitive part of the name.
id (string or null): The exact ID.

Result

Jobs.

jobs (array of JobInfo, required): In GUID order.