Job feeds

Create a job feed

Changed on

Connects an XML job feed URL (for example an ATS or Indeed-style feed). The URL is fetched once to check it serves XML before it is saved. The first run starts straight away and detects the field mapping; until it finishes the feed is pending_mapping and mapping is null. Poll GET /job-feeds/{id}.

post/job-feeds

Request

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

Request body

urlstring uri required

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

namestring

Display name. Defaults to a name derived from the URL host.

expireMissingboolean

Expire a job once it is missing from two successful runs in a row.

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 created 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