---
updatedAt: 2026-02-10T18:50:36.000Z
agentTools:
  siteIndex: https://developer.paylocity.com/llms.txt
  projectIndex: https://developer.paylocity.com/integrations/llms.txt
---

# Delete Job Code

**Summary Description**

The DELETE Job Code endpoint enables users to delete a single job code and it’s values from the Paylocity instance of a client. In order to utilize this endpoint, it is required to provide both the Company ID and the Job Code ID in the endpoint

**Best Practice Notice:** If you delete a job code which has been used in payroll, your reports may be impacted. The best practice is to make the job code inactive instead of deleting the entire job code

**Use Cases**

- This API endpoint will allow an API user to delete a Job Code record for a specific company ID and Job Code ID


# OpenAPI definition

```json
{
  "openapi": "3.0.1",
  "info": {
    "title": "Company Level Information",
    "version": "v1"
  },
  "servers": [
    {
      "url": "dc1demogwext.paylocity.com"
    }
  ],
  "paths": {
    "/apiHub/payroll/v1/companies/{companyId}/jobs/{jobCode}": {
      "delete": {
        "tags": [
          "Job Codes"
        ],
        "summary": "Delete Job Code",
        "description": "**Summary Description**\n\nThe DELETE Job Code endpoint enables users to delete a single job code and it’s values from the Paylocity instance of a client. In order to utilize this endpoint, it is required to provide both the Company ID and the Job Code ID in the endpoint\n\n**Best Practice Notice:** If you delete a job code which has been used in payroll, your reports may be impacted. The best practice is to make the job code inactive instead of deleting the entire job code\n\n**Use Cases**\n\n- This API endpoint will allow an API user to delete a Job Code record for a specific company ID and Job Code ID\n",
        "x-explorer-enabled": false,
        "parameters": [
          {
            "name": "companyId",
            "in": "path",
            "description": "The Paylocity Company Identifier. This is the unique value provided by Paylocity to each specific Payroll Entity.\r\n                **Allowable Values:**\r\n                9 char max",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "A12345"
          },
          {
            "name": "jobCode",
            "in": "path",
            "description": "A specific identifier or label assigned to individual tasks, projects, or assignments within a company.\r\n                **Allowable Values:**\r\n                A Job Code may contain up to 20 alpha-numeric characters. Spaces or special characters are not allowed",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "Authorization",
            "in": "header",
            "description": "Authorization token. Ex. Bearer ...",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  }
}
```