user-preferences

Patch User Preferences Bundle

Partially update one or more of the user's preference blocks (application profile, job match preferences, AI persona) in a single atomic D1 batch. At least one block must be present.

patch/user/preferences

Request

  • Base URL: https://api.aiapplyd.com/api/v1
  • URL: https://api.aiapplyd.com/api/v1/user/preferences
  • Auth: HTTP bearer

Request body

Example request

{
  "applicationProfile": {
    "phone": "+1-555-123-4567",
    "addressLine1": "123 Main St",
    "addressLine2": "Apt 4B",
    "city": "San Francisco",
    "state": "CA",
    "zipCode": "94105",
    "country": "US",
    "linkedinUrl": "https://linkedin.com/in/johndoe",
    "portfolioUrl": "https://johndoe.dev",
    "githubUrl": "https://github.com/johndoe",
    "currentEmployer": "Acme Corp",
    "dateOfBirth": "1995-06-15",
    "workAuthorization": "us_citizen",
    "relocationLocations": [
      "New York, United States",
      "Austin, United States"
    ],
    "salaryCurrency": "usd",
    "availableStartDate": "2026-04-01",
    "noticePeriod": "two_weeks",
    "personalNarrative": "Took a 14-month gap in 2024 for caregiving; returning with a refreshed cloud certification.",
    "travelWillingness": "up_to_25",
    "securityClearance": "none",
    "restrictiveCovenantStatus": "no",
    "criminalRecordStatus": "no",
    "backgroundCheckConsent": "yes",
    "relatedToEmployeeStatus": "no",
    "exportControlUsPerson": "yes",
    "highestEducation": "bachelor",
    "yearsOfExperience": 5,
    "veteranStatus": "prefer_not_to_say",
    "disabilityStatus": "prefer_not_to_say",
    "gender": "prefer_not_to_say",
    "ethnicity": "prefer_not_to_say",
    "sexualOrientation": "prefer_not_to_say",
    "pronouns": "she/her"
  },
  "jobMatchPreferences": {
    "benefits": [
      "health_insurance",
      "remote_work"
    ],
    "companySize": [
      "startup",
      "small"
    ],
    "educationLevel": "bachelor",
    "excludeIndustries": [
      "Government & Public Sector"
    ],
    "experienceLevel": "senior",
    "experienceLevels": [
      "mid",
      "senior"
    ],
    "includeRemote": true,
    "industries": [
      "Technology",
      "Finance"
    ],
    "isActive": true,
    "jobTypes": [
      "full_time",
      "contract"
    ],
    "locations": [
      "San Francisco, United States",
      "Berlin, Germany"
    ],
    "salaryCurrency": "eur",
    "salaryMax": 200000,
    "salaryMin": 100000,
    "skills": [
      "TypeScript",
      "React",
      "Node.js",
      "PostgreSQL"
    ],
    "targetRoles": [
      "Software Engineer",
      "Full Stack Developer"
    ],
    "visaSponsorship": "required",
    "workStyles": [
      "remote",
      "hybrid"
    ]
  },
  "aiPersona": {
    "allowFabrication": true,
    "coverLetterStrategy": "generate_new",
    "generateCoverLetterPerJob": true,
    "mode": "copilot",
    "personalDescription": "Senior engineer with 10 years in fintech",
    "presetId": "balanced",
    "resumeStrategy": "tailor",
    "samplePhrases": [
      "Let me walk you through my approach"
    ],
    "tailorResumePerJob": true,
    "toneInstructions": "Always mention my passion for open-source",
    "translationStrategy": "off"
  }
}

Response

User preferences bundle updated, plus prefsChanged

PatchUserPreferencesResponse required(unresolved $ref)

Changes

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