Job feeds

Update a job feed

Changed on

Changes any of the URL, name, schedule, enabled state, job limit, apply-URL attribution, and mapping in one request. A changed URL is checked first. A mapping edit applies from the next run, which starts now.

patch/job-feeds/{id}

Request

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

Path parameters

idstring required

The job feed ID.

Request body

urlstring uri

The XML feed URL. Checked before it is saved: Cavuno fetches it once and refuses a blocked, unreachable or non-XML URL.

namestring
expireMissingboolean
enabledboolean

A disabled feed is not pulled until it is enabled again.

jobLimitinteger nullable

Most jobs this feed may have published at once. null means no per-feed cap (plan and Board limits still apply).

Response

The updated job feed.

idstring required
object'job_feed' required
namestring required
urlstring 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.

enabledboolean required
intervalHoursnumber required
expireMissingboolean required
jobLimitnumber nullable required
lastRunAtstring nullable required
nextRunAtstring nullable required

When the next pull is due. null while the feed is disabled.

lastErrorstring nullable required
consecutiveFailuresnumber required
createdAtstring required

Changes