saved-searches

Update Saved Search

Rename a saved search, toggle its email alerts, or replace its filter criteria.

patch/saved-searches/{id}

Request

  • Base URL: https://api.aiapplyd.com/api/v1
  • URL: https://api.aiapplyd.com/api/v1/saved-searches/{id}
  • Auth: HTTP bearer

Path parameters

idstring required

Saved search identifier (auto-increment integer)

Example:1

Request body

alertsEnabledboolean

Toggle email alerts

namestring

New label for the saved search

Example request

{
  "criteria": {
    "benefits": [
      "health_insurance",
      "remote_work"
    ],
    "companySize": [
      "startup",
      "small"
    ],
    "educationLevel": "bachelor",
    "excludeIndustries": [
      "Government & Public Sector"
    ],
    "experienceLevel": "senior",
    "experienceLevels": [
      "mid",
      "senior"
    ],
    "includeRemote": true,
    "industries": [
      "Technology",
      "Finance"
    ],
    "jobTypes": [
      "full_time",
      "contract"
    ],
    "locations": [
      "San Francisco, United States",
      "Berlin, Germany"
    ],
    "salaryCurrency": "eur",
    "salaryMax": 200000,
    "salaryMin": 100000,
    "skills": [
      "TypeScript",
      "React",
      "Node.js"
    ],
    "targetRoles": [
      "Software Engineer",
      "Full Stack Developer"
    ],
    "visaSponsorship": "required",
    "workStyles": [
      "remote",
      "hybrid"
    ]
  },
  "name": "Remote staff backend"
}

Response

Saved search updated

successtrue required

Example response

{
  "data": {
    "alertsEnabled": true,
    "createdAt": "2026-01-15T12:00:00Z",
    "criteria": {
      "benefits": [
        "health_insurance",
        "remote_work"
      ],
      "companySize": [
        "startup",
        "small"
      ],
      "educationLevel": "bachelor",
      "excludeIndustries": [
        "Government & Public Sector"
      ],
      "experienceLevel": "senior",
      "experienceLevels": [
        "mid",
        "senior"
      ],
      "includeRemote": true,
      "industries": [
        "Technology",
        "Finance"
      ],
      "jobTypes": [
        "full_time",
        "contract"
      ],
      "locations": [
        "San Francisco, United States",
        "Berlin, Germany"
      ],
      "salaryCurrency": "eur",
      "salaryMax": 200000,
      "salaryMin": 100000,
      "skills": [
        "TypeScript",
        "React",
        "Node.js"
      ],
      "targetRoles": [
        "Software Engineer",
        "Full Stack Developer"
      ],
      "visaSponsorship": "required",
      "workStyles": [
        "remote",
        "hybrid"
      ]
    },
    "id": 12,
    "lastAlertedAt": "2026-03-10T08:30:00Z",
    "name": "Remote senior backend",
    "updatedAt": "2026-03-10T08:30:00Z",
    "userId": "user_123"
  },
  "meta": {
    "duration": 150,
    "requestId": "req_abc123",
    "timestamp": "2026-10-13T10:27:20.268Z",
    "version": "v1"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.