---
title: "Re-detect a job feed mapping"
method: POST
path: "/job-feeds/{id}/redetect-mapping"
tags: ["Job feeds"]
---

# Re-detect a job feed mapping

`POST /job-feeds/{id}/redetect-mapping`

## Request

- Base URL: `https://api.cavuno.com/v1`
- URL: `https://api.cavuno.com/v1/job-feeds/{id}/redetect-mapping`
- Auth: HTTP bearer

Discards the current mapping and detects a fresh one on the next run, which starts now. The feed is returned with `mapping: null` until that run finishes.

## Path parameters

- `id` string, required: The job feed ID.

## Response `200`

The job feed.

- JobFeedDetail
  - `id` string, required
  - `object` 'job_feed', required
  - `name` string, required
  - `url` string, required
  - `status` 'pending_mapping' | 'active' | 'failing' | 'needs_review', required: `pending_mapping`: the first run (or a re-detection) has not produced a mapping yet. `failing`: recent runs failed (see `lastError`). `needs_review`: runs are held until the mapping is fixed or re-detected.
  - `enabled` boolean, required
  - `intervalHours` number, required
  - `expireMissing` boolean, required
  - `jobLimit` number, nullable, required
  - `applyUrlAttribution` union, required: Outbound apply-URL attribution for this feed's jobs. `inherit` uses the Board setting.
    - object
      - `mode` 'inherit', required
    - object
      - `mode` 'off', required
    - object
      - `mode` 'append', required
      - `params` ApplyUrlParamTemplate[], required
        - `key` string, required
        - `valueTemplate` string, required
  - `lastRunAt` string, nullable, required
  - `nextRunAt` string, nullable, required: When the next pull is due. `null` while the feed is disabled.
  - `lastError` string, nullable, required
  - `consecutiveFailures` number, required
  - `createdAt` string, required
  - `mapping` object, nullable, required: Typed, operator-reviewable mapping. `null` until the first run (or a re-detection) has detected one.
    - `fieldMappings` object[], required
      - `sourceColumn` string, required
      - `targetField` string, required
      - `confidence` number, required
      - `notes` string
    - `valueTransforms` object[], required
      - `sourceColumn` string, required
      - `targetField` string, required
      - `map` object, required
      - `fallback` string
    - `defaults` object, required
      - `employmentType` string
      - `remoteOption` string
      - `currency` string
      - `descriptionFormat` string
    - `fieldsNeedingReview` string[], required: Job fields whose detected mapping should be checked.
    - `sourceColumns` object[], required: Columns seen in the feed, with a few sample values.
      - `name` string, required
      - `samples` string[], required

## Other responses

- `404`: Job feed not found.

## Changes

- **2026-10-20** `cee1c2d567e5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/cavuno/apis/cavuno-v1-rest-api/changes/job-feeds/:id/redetect-mapping/post.md)

---

[API](https://skmtc.dev/cavuno/apis/cavuno-v1-rest-api.md) · [All operations](https://skmtc.dev/cavuno/apis/cavuno-v1-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cavuno/apis/cavuno-v1-rest-api/revisions/d5974dabff14?raw)