Create Sourcing Session

`POST /sourcing-session` Creates a new sourcing session and triggers the initial profile search. ## Headers | Key | Value | | --- | --- | | x-fj-api-key | fjk_ | | Content-Type | application/json | ## Body | Field | Type | Required | Description | | --- | --- | --- | --- | | sessionTitle | string | no | Human-readable session name. | | jdDetail.userText | string | no | Free-form JD text. | | jdDetail.sampleProfileURL | string | no | Sample LinkedIn URL to anchor the search. | | queries | object | yes | Search filter map (see below). | ### queries object — filter shape Each filter is `{ type, value }`: _value accepts array of strings_ _For skills filter, at least one skill must be provided in mandatory, core, or secondary._ - `country_region — { type: "(.)", value: ["India"] }` - `open_to_cards — { type: "=", value: ["CAREER_INTEREST"] }` - `current_employers.title — { type: "IN", value: [ ".NET Developer", "C# Developer", "Software Engineer", "Web Developer", "Application Developer", "Backend Developer" ] }` - `years_of_experience_raw — { type: "RANGE", value: [1, 5] }` - `skills — { type: "IN", value: { mandatory: ["C#", ".NET Core"], core: [ "ASP.NET MVC", "Web API", "SQL Server", "Entity Framework", "React", "Angular", "Docker" ], secondary: [] } }` - `current_employers.function_category — { type: "IN", value: ["Engineering"] }` - `current_employers.seniority_level — { type: "IN", value: ["Senior"] }` - `current_employers.name — { type: "IN", value: ["Tech Mahindra"] }` - `current_employers.years_at_company — { type: "IN", value: ["1 to 2 years"] }` - `region — { type: "IN", value: ["Pune, Maharashtra, India"] }` - `all_employers.company_industries — { type: "IN", value: [ "Software Development", "IT System Custom Software Development", "Design Services" ] }` - `education_background.institute_name — { type: "IN", value: ["University of Mumbai"] }` - `education_background.field_of_study — { type: "IN", value: [ "Computer Science", "Information Technology", "related field" ] }` - `education_background.degree_name — { type: "IN", value: ["BACHELORS"] }` - `past_employers.name — { type: "IN", value: ["Infosys"] }` - `past_employers.title — { type: "IN", value: ["Software Developer"] }` - `current_employers.company_type — { type: "IN", value: ["Public Company"] }` - `current_employers.company_hq_location — { type: "IN", value: ["Pune, Maharashtra, India"] }` - `current_employers.description — { type: "IN", value: ["B2B Saas"] }` - `funding_stage — { type: "IN", value: ["series_a"] }` - `headcount_growth — { type: "RANGE", value: [10, 20] }` - `current_employers.company_headcount_latest — { type: "RANGE", value: [10, 100] }` - `annual_revenue — { type: "=", value: ["1_10"] }` - `total_funding — { type: "=", value: ["1_10"] }` - `year_founded — { type: "RANGE", value: [2000, 2010] }` - `recently_funded — { type: "=", value: ["6m"] }` - `certifications.name — { type: "IN", value: ["AWS Certified Cloud Practitioner"] }` - `honors.title — { type: "IN", value: ["Dean's list"] }` - `geo_distance — { type: "=", value: ["50_km"] }` - `current_employers.employment_type — { type: "IN", value: ["Part-time", "Permanent"] }` - `current_employers.company_headcount_range — { type: "IN", value: ["51-200"] }` ## Response (200) The created session object. ``` json { "statusCode": 201, "data": { "session": { "sessionTitle": ".NET Developer", "medium": "MANUAL", "jdDetail": { "userText": "Job Title: .NET Developer, Experience: 1-5 years, Location: Pune", "sampleProfileURL": "" }, "queries": { "country_region": { "type": "(.)", "value": [ "India" ] }, "current_employers.title": { "type": "IN", "value": [ ".NET Developer" ] }, "years_of_experience_raw": { "type": "RANGE", "value": [ 1, 5 ] }, "region": { "type": "IN", "value": [ "Pune, Maharashtra, India" ] }, "skills": { "type": "IN", "value": { "mandatory": [ "C#" ], "core": [ "ASP.NET MVC" ], "secondary": [] } } }, "fallbackFilters": null, "hasUsedFinalFallback": false, "nuances": [], "redFlags": "", "mustHaves": "", "additionalNotes": "", "createdBy": "68c505c2ec8d7cb2821599af", "workspaceId": "6a0c5da36e7a0151430c5b71", "projectId": "6a0c5da36e7a0151430c5b7e", "next_cursor": "", "searchMoreCounter": 0, "filterChangesCounter": 0, "lastCandidatesFetchedAt": null, "profileMatchingStatus": "idle", "totalProfilesForMatching": 0, "totalProfilesMatched": 0, "profileMatchingProvider": "gemini", "sessionCreditCharged": false, "forceRefreshAnalysis": false, "totalAvailableProfiles": 0, "metadata": { "s3Key": null, "fileHash": null, "uploadedAt": null }, "_id": "6a0c77936e7a0151430c91fd", "batches": [], "createdAt": "2026-05-19T14:45:39.240Z", "updatedAt": "2026-05-19T14:45:39.240Z", "__v": 0 }, "sourcing": { "total_display_count": 100, "next_cursor": "H4sIAJR3DGoC_xXMMQrDMAxA0asEzx0iS5biXqWUIMs2GUpNE2coIXdvuv4H_3CfvazfedFtcffB-VB5YovKIMQhawm5aCKIqRCaZBBkJWEZk6TRexBvqZrlSrnG4G6D29rar9eDAQgxwPNqvXV9zdb295_QT-cPbAjrQHoAAAA=", "filterChangesCounter": 0, "searchMoreCounter": 0, "profileMatchingStatus": "processing", "newProfilesCount": 100, "creditInfo": { "charged": true, "amount": 5, "reason": "Sourcing Session Created", "remainingCredits": 37 } } }, "message": "Session created successfully", "status": "SUCCESS" } ``` ## cURL Replace `fjk_YOUR_API_KEY_HERE` with your actual key, then paste and run: ``` bash curl -X POST "https://prod.api.futurejobs.ai/api/v1/wl/sourcing-session" \ -H "x-fj-api-key: fjk_YOUR_API_KEY_HERE" \ -H "Content-Type: application/json" \ -d '{ "sessionTitle": ".NET Developer", "jdDetail": { "userText": "Job Title: .NET Developer, Experience: 1-5 years, Location: Pune" }, "queries": { "country_region": { "type": "(.)", "value": ["India"] }, "years_of_experience_raw": { "type": "RANGE", "value": [1, 5] }, "skills": { "type": "IN", "value": { "mandatory": [ "C#", ".NET Core" ], "core": [ "ASP.NET MVC", "Web API", "SQL Server", "Entity Framework", "React", "Angular", "Docker" ], "secondary": [] } } } }' ``` ## Errors - `400 Bad Request` — validation failed (missing/invalid fields). - `401 Unauthorized` — invalid API key. - `402 Payment Required` — insufficient workspace credits.