---
title: "PATCH /matches/{id}/"
method: PATCH
path: "/matches/{id}/"
tags: ["matches"]
---

# PATCH /matches/{id}/

`PATCH /matches/{id}/`

Update partially a match details.

## Request body

- object
  - `id` integer
  - `external_id` string, nullable — Id of the match in the API consumer systems
  - `owner` integer — Owner of the match
  - `organization` integer — Organization that owns the job
  - `job` integer — Job the candidat is matched with
  - `candidate` integer — Candidate that has a match with a job
  - `creator` integer — User who added the candidate to the job
  - `is_active` boolean — Whether the match is still active or not
  - `job_pipeline_stage` object — Job pipeline stage of the match
    - `id` integer, required
  - `custom_fields` object — Match values for custom fields defined in Manatal.
  - `hired_at` string, date-time, nullable — Date at which the candidate was hired
  - `submitted_at` string, date-time, nullable — Date at which the candidate was added to the job
  - `interview_at` string, date-time, nullable — Date at which the candidate was last interviewed
  - `offer_at` string, date-time, nullable — Date at which an offer was made to the candidate
  - `dropped_at` string, date-time, nullable — Date at which the candidate was no longer considered for the job
  - `created_at` string, date-time
  - `updated_at` string, date-time

## Response `200`

- object
  - `id` integer
  - `external_id` string, nullable — Id of the match in the API consumer systems
  - `owner` integer — Owner of the match
  - `organization` integer — Organization that owns the job
  - `job` integer — Job the candidat is matched with
  - `candidate` integer — Candidate that has a match with a job
  - `creator` integer — User who added the candidate to the job
  - `job_pipeline_stage` object — Job pipeline stage of the match
    - `id` integer, required
    - `name` string
    - `rank` integer
    - `job_pipeline` object
      - `id` integer
      - `name` string
  - `is_active` boolean — Whether the match is still active or not
  - `custom_fields` object — Match values for custom fields defined in Manatal.
  - `hired_at` string, date-time, nullable — Date at which the candidate was hired
  - `submitted_at` string, date-time, nullable — Date at which the candidate was added to the job
  - `interview_at` string, date-time, nullable — Date at which the candidate was last interviewed
  - `offer_at` string, date-time, nullable — Date at which an offer was made to the candidate
  - `dropped_at` string, date-time, nullable — Date at which the candidate was no longer considered for the job
  - `created_at` string, date-time
  - `updated_at` string, date-time

---

[API](https://skmtc.net/manatal/apis/manatal-career-page-api.md) · [All operations](https://skmtc.net/manatal/apis/manatal-career-page-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/manatal/manatal-career-page-api/versions/59053f2da83c/schema)