---
agentTools:
  projectIndex: https://kenjo.readme.io/llms.txt
---

# Update an existing candidate. You can include custom fields in the body of the request.

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "title": "Kenjo API",
    "description": "Before starting to use the Kenjo API, you have to request the API activation for a sandbox or production environment to the Kenjo Customer Success team. After that, an admin user has to go to *Settings > Integrations > API keys*, to generate the **API Key**. Follow the steps described in the **Autentication section** of this document. <br>The API key is needed to request the bearer token. Each endpoint callout requires a valid bearer token in the Authorization header. Once the token is retrieved, it will be useful during the time limit indicated by the 'expiration date'.",
    "termsOfService": "https://www.kenjo.io/legal/terms-and-conditions",
    "version": "1.0.0"
  },
  "servers": [
    {
      "url": "https://sandbox-api.kenjo.io/api/v1",
      "description": "Sandbox environment"
    },
    {
      "url": "https://api.kenjo.io/api/v1",
      "description": "Production environment"
    }
  ],
  "tags": [
    {
      "name": "Recruiting",
      "description": "Operations to manage recruiting processes in Kenjo."
    }
  ],
  "paths": {
    "/recruiting/candidates/{candidateId}": {
      "put": {
        "summary": "Update an existing candidate. You can include custom fields in the body of the request.",
        "tags": [
          "Recruiting"
        ],
        "parameters": [
          {
            "name": "candidateId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "firstName": {
                    "type": "string",
                    "example": "Johannes"
                  },
                  "lastName": {
                    "type": "string",
                    "example": "Hesse"
                  },
                  "email": {
                    "type": "string",
                    "example": "johannes.hesse@test.com"
                  },
                  "phone": {
                    "type": "string",
                    "example": 443332221
                  },
                  "sourceField": {
                    "type": "string",
                    "example": "Website integration"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "_id": {
                      "type": "string",
                      "description": "The _id of the candidate just created.",
                      "example": "6751ebdf7d91779514cebbcd"
                    },
                    "firstName": {
                      "type": "string",
                      "description": "The name of the candidate created.",
                      "example": "Johannes"
                    },
                    "lastName": {
                      "type": "string",
                      "description": "The last name of the candidate created.",
                      "example": "Hesse"
                    },
                    "phone": {
                      "type": "string",
                      "description": "The phone of the candidate created.",
                      "example": 443332221
                    },
                    "sourceField": {
                      "type": "string",
                      "description": "The source field of the candidate.",
                      "example": "Website integration"
                    },
                    "origin": {
                      "type": "string",
                      "description": "The source of the entry (e.g., API, manual, agency, browserExtension).",
                      "example": "api"
                    },
                    "_createdById": {
                      "type": "string",
                      "description": "The unique identifier of the creator of the record.",
                      "example": "67223a2a77fb00d3fb70cbac"
                    },
                    "_updatedById": {
                      "type": "string",
                      "description": "The unique identifier of the updater of the record.",
                      "example": "67223a2a77fb00d3fb70cbac"
                    },
                    "_createdAt": {
                      "type": "string",
                      "format": "date-time",
                      "description": "The creation date of the record in ISO 8601 format.",
                      "example": "2024-11-29T10:02:41.345Z"
                    },
                    "_updatedAt": {
                      "type": "string",
                      "format": "date-time",
                      "description": "The last update date of the record in ISO 8601 format.",
                      "example": "2024-11-29T10:22:31.141Z"
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "x-readme": {
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "_id": {
    "buffer": {
      "0": 106,
      "1": 207,
      "2": 66,
      "3": 151,
      "4": 39,
      "5": 216,
      "6": 106,
      "7": 224,
      "8": 133,
      "9": 48,
      "10": 201,
      "11": 174
    }
  }
}
```