Jobiflow LogoAPI Docs
ApiJob Listings

Archive a job listing

Moves a `CLOSED` or `ACTIVE` listing to `ARCHIVED` status. Archived listings are hidden from the public but retained for reporting. Requires scope: `jobs:write`

PATCH
/public/v1/job-listings/{id}/archive

Moves a CLOSED or ACTIVE listing to ARCHIVED status. Archived listings are hidden from the public but retained for reporting.

Requires scope: jobs:write

Authorization

ApiKeyAuth
X-API-Key<token>

API key issued by Jobiflow. Pass it in the X-API-Key request header.

Create keys via the company dashboard (Settings → API Keys) or via POST /settings/api-keys.

In: header

Path Parameters

id*string

UUID of the job listing to archive.

Formatuuid

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X PATCH "https://example.com/public/v1/job-listings/497f6eca-6276-4993-bfeb-53cbbbba6f08/archive"
{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "companyId": "8bb73d03-06b4-47c7-80c7-59301f770eda",
  "status": "DRAFT",
  "sectorId": "3274bbb4-3f99-4800-8405-d01f8a71a05d",
  "position": {
    "value": "string",
    "original": "string",
    "sourceLanguage": "en",
    "translated": true,
    "translationType": "AI"
  },
  "positionType": "FULL_TIME",
  "workPlaceType": "REMOTE",
  "address": {
    "street": "Marienplatz 1",
    "city": "Munich",
    "state": "Bavaria",
    "country": "DE",
    "postalCode": "80331",
    "latitude": 48.1374,
    "longitude": 11.5755
  },
  "isStartDate": true,
  "startDate": "2019-08-24",
  "jobDescription": {
    "value": "string",
    "original": "string",
    "sourceLanguage": "en",
    "translated": true,
    "translationType": "AI"
  },
  "requirementsSummary": {
    "value": "string",
    "original": "string",
    "sourceLanguage": "en",
    "translated": true,
    "translationType": "AI"
  },
  "personalQualitiesSummary": {
    "value": "string",
    "original": "string",
    "sourceLanguage": "en",
    "translated": true,
    "translationType": "AI"
  },
  "skills": [
    {
      "value": {
        "value": "string",
        "original": "string",
        "sourceLanguage": "en",
        "translated": true,
        "translationType": "AI"
      },
      "type": "SKILL",
      "expertType": "BEGINNER",
      "languageProficiency": "A1",
      "drivingClass": "AM"
    }
  ],
  "currency": "string",
  "salaryBase": 0,
  "isSalaryMax": true,
  "salaryMax": 0,
  "salaryType": "GROSS",
  "paymentInterval": "HOURLY",
  "salaryDescription": {
    "value": "string",
    "original": "string",
    "sourceLanguage": "en",
    "translated": true,
    "translationType": "AI"
  },
  "benefits": [
    {
      "value": "string",
      "original": "string",
      "sourceLanguage": "en",
      "translated": true,
      "translationType": "AI"
    }
  ],
  "educationLevel": "NONE",
  "fieldOfStudy": {
    "value": "string",
    "original": "string",
    "sourceLanguage": "en",
    "translated": true,
    "translationType": "AI"
  },
  "yearsOfExperience": 0,
  "availableForEveryCountry": true,
  "numberOfPositionsOpened": 0,
  "jobListingEndDate": "2019-08-24",
  "referenceNumber": "string",
  "hiringProcessSteps": [
    {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "jobListingId": "a7d01775-e611-4288-b8c1-442852b8ff39",
      "stepOrder": 1,
      "stepName": {
        "value": "string",
        "original": "string",
        "sourceLanguage": "en",
        "translated": true,
        "translationType": "AI"
      },
      "description": {
        "value": "string",
        "original": "string",
        "sourceLanguage": "en",
        "translated": true,
        "translationType": "AI"
      }
    }
  ],
  "jobListingTags": [
    {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "jobListingId": "a7d01775-e611-4288-b8c1-442852b8ff39",
      "tagId": "f69eb9f1-ae9f-4086-b25c-c39758a43fb3"
    }
  ],
  "jobListingRequirements": [
    {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "jobListingId": "a7d01775-e611-4288-b8c1-442852b8ff39",
      "requirementText": "string"
    }
  ],
  "createdAt": "2019-08-24T14:15:22Z",
  "updatedAt": "2019-08-24T14:15:22Z",
  "publishedAt": "2019-08-24T14:15:22Z",
  "expiresAt": "2019-08-24T14:15:22Z",
  "closedAt": "2019-08-24T14:15:22Z"
}
{
  "status": 401,
  "error": "UNAUTHORIZED",
  "message": "Invalid or missing API key",
  "timestamp": "2026-05-17T12:00:00Z",
  "path": "/public/v1/job-listings"
}
{
  "status": 403,
  "error": "FORBIDDEN",
  "message": "Scope 'jobs:write' is required",
  "timestamp": "2026-05-17T12:00:00Z",
  "path": "/public/v1/job-listings"
}
{
  "status": 404,
  "error": "NOT_FOUND",
  "message": "Job listing not found",
  "timestamp": "2026-05-17T12:00:00Z",
  "path": "/public/v1/job-listings/00000000-0000-0000-0000-000000000000"
}
{
  "status": 409,
  "error": "CONFLICT",
  "message": "Cannot delete an ACTIVE job listing",
  "timestamp": "2026-05-17T12:00:00Z",
  "path": "/public/v1/job-listings/abc"
}

Update job listing status PATCH

Directly sets the status of a job listing. Only valid status transitions are allowed — attempting an invalid transition returns `409 Conflict`. Valid transitions: `DRAFT` → `ACTIVE`, `ACTIVE` → `CLOSED`, `CLOSED` → `ACTIVE`. Requires scope: `jobs:write`

Get analytics for a job listing GET

Returns view counts, application funnel data, and daily trend metrics for an individual job listing. Requires scope: `analytics:read`