---
updatedAt: 2025-10-02T22:25:39.000Z
agentTools:
  projectIndex: https://developer.bill.com/v2/llms.txt
---

# Delete a job

Delete a job object.

In the response, `isActive` is set as `2` (Inactive).

### What is a job?
A customer pays your organization for products or services. A job object is useful for tracking a service (a project or scope of work) for which a customer pays your organization. You can sync your items with your choice of account software or import using a CSV file.

In Intuit QuickBooks, a job is a sub-category under customer. In Xero and Oracle NetSuite, the job object is not supported.

### Display job in the BILL web app
You can display job numbers with the BILL web app.
1. In the BILL web app, click **SETTINGS** at the top-right.
2. Click **Preferences** under **Accounting**.
3. Click the edit icon at the top-right.
4. Set **Use Customers/Jobs in Payables** as **Yes** and then click **SAVE**.

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "title": "Organization | Accounts tracking",
    "version": "2.0",
    "description": "BILL is a cloud-based cash flow management system for an organization's Accounts Payable (AP) and Accounts Receivable (AR) automation.\n * **AP**: Automate workflows to pay vendors bills at scale for the goods and services they provide. Pay vendors with a wide range of payment methods. Generate vendor credits, bill credits, and payment disbursement reports.\n * **AR**: Automate workflows to get paid by customers at scale for the goods and services you provide. Generate and send invoices on a schedule, generate customer and invoice credits, and seamlessly charge authorized customers.\n * **Organization**: Manage your bank accounts (for sending and receiving payments), users (with user roles), and sync with your choice of accounting software.\n\nIntegrate with the BILL API to send and receive payments for your business. See [Support Center](https://help.bill.com/hc/en-us) for resources about using the BILL web app.",
    "contact": {
      "email": "developerprogram@hq.bill.com"
    }
  },
  "servers": [
    {
      "url": "https://api-stage.bill.com/api/v2",
      "description": "Sandbox base URL"
    }
  ],
  "x-readme": {
    "samples-languages": [
      "curl",
      "java",
      "javascript",
      "python",
      "ruby"
    ],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "paths": {
    "/Crud/Delete/Job.json": {
      "post": {
        "summary": "Delete a job",
        "operationId": "org-accounts-deletejob",
        "description": "Delete a job object.\n\nIn the response, `isActive` is set as `2` (Inactive).\n\n### What is a job?\nA customer pays your organization for products or services. A job object is useful for tracking a service (a project or scope of work) for which a customer pays your organization. You can sync your items with your choice of account software or import using a CSV file.\n\nIn Intuit QuickBooks, a job is a sub-category under customer. In Xero and Oracle NetSuite, the job object is not supported.\n\n### Display job in the BILL web app\nYou can display job numbers with the BILL web app.\n1. In the BILL web app, click **SETTINGS** at the top-right.\n2. Click **Preferences** under **Accounting**.\n3. Click the edit icon at the top-right.\n4. Set **Use Customers/Jobs in Payables** as **Yes** and then click **SAVE**.",
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CreateJobResponse"
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/x-www-form-urlencoded": {
              "schema": {
                "type": "object",
                "required": [
                  "devKey",
                  "sessionId",
                  "data"
                ],
                "properties": {
                  "devKey": {
                    "type": "string",
                    "description": "Developer key generated with your BILL developer account"
                  },
                  "sessionId": {
                    "type": "string",
                    "description": "API session ID generated with [`/v2/Login.json`](ref:auth-login)"
                  },
                  "data": {
                    "$ref": "#/components/schemas/DeleteJobRequest"
                  }
                }
              }
            }
          }
        },
        "tags": [
          "Jobs"
        ]
      },
      "parameters": []
    }
  },
  "components": {
    "schemas": {
      "ErrorResponse": {
        "type": "object",
        "properties": {
          "error_code": {
            "type": "string",
            "description": "Error code (only when `response_status` is `1`)"
          },
          "error_message": {
            "type": "string",
            "description": "Error message (only when `response_status` is `1`)"
          }
        }
      },
      "CreateJobResponse": {
        "type": "object",
        "properties": {
          "response_status": {
            "type": "integer",
            "description": "Response status.\n* `0`: Success response\n* `1`: Error response. Only `error_code` and `error_message` is returned in `response_data`."
          },
          "response_message": {
            "type": "string",
            "description": "Response status.\n* `Success`: Success response\n* `Error`: Error response. Only `error_code` and `error_message` is returned in `response_data`."
          },
          "response_data": {
            "type": "object",
            "allOf": [
              {
                "$ref": "#/components/schemas/ErrorResponse"
              }
            ],
            "properties": {
              "entity": {
                "type": "string",
                "description": "Object type. Set as `Job`."
              },
              "id": {
                "type": "string",
                "description": "BILL-generated job ID. The value begins with `job`."
              },
              "shortName": {
                "type": "string",
                "description": "Name for identifying the job in BILL and in your choice of accounting software."
              },
              "isActive": {
                "type": "string",
                "description": "Object visibility status. Inactive objects are hidden by default in the BILL web app.\n* `1`: Active\n* `2`: Inactive"
              },
              "name": {
                "type": "string",
                "description": "Unique job name"
              },
              "parentJobId": {
                "type": "string",
                "description": "Parent job ID. Set this value if the current job ID is a child object."
              },
              "description": {
                "type": "string",
                "description": "Job description"
              },
              "createdTime": {
                "type": "string",
                "description": "Created date and time"
              },
              "updatedTime": {
                "type": "string",
                "description": "Updated date and time"
              },
              "mergedIntoId": {
                "type": "string",
                "description": "Parent job ID that the current ID is merged into"
              }
            }
          }
        }
      },
      "DeleteJobRequest": {
        "type": "object",
        "required": [
          "id"
        ],
        "properties": {
          "id": {
            "type": "string",
            "description": "BILL-generated ID of the job. The value begins with `job`."
          }
        }
      }
    }
  }
}
```