Himalayas Remote Jobs

Browse the latest remote job listings with optional filtering by country or worldwide availability

{
  "type": "object",
  "properties": {
    "page": {
      "description": "Page number for pagination (starts at 1)",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "country": {
      "description": "Filter jobs by country (e.g., 'Canada', 'United States', 'UK')",
      "type": "string"
    },
    "worldwide": {
      "description": "Show ONLY 100% remote jobs available worldwide (overrides country filter)",
      "type": "boolean"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Search for remote jobs using keywords with optional filtering by country or worldwide availability

{
  "type": "object",
  "properties": {
    "keyword": {
      "description": "Search keyword/term (optional)",
      "type": "string"
    },
    "page": {
      "description": "Page number for pagination (starts at 1)",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "country": {
      "description": "Filter jobs by country (e.g., 'Canada', 'United States', 'UK')",
      "type": "string"
    },
    "exclude_worldwide": {
      "description": "When true and country is set, return ONLY jobs specifically available in that country, excluding worldwide/remote jobs. Requires country to be set.",
      "type": "boolean"
    },
    "worldwide": {
      "description": "Show ONLY 100% remote jobs available worldwide (overrides country filter)",
      "type": "boolean"
    },
    "experience": {
      "description": "Filter by a single experience/seniority level (entry-level, mid-level, senior, manager, director, or executive)",
      "type": "string",
      "enum": [
        "entry-level",
        "mid-level",
        "senior",
        "manager",
        "director",
        "executive"
      ]
    },
    "type": {
      "description": "Filter by a single employment type (full-time, part-time, contractor, temporary, intern, volunteer, or other)",
      "type": "string",
      "enum": [
        "full-time",
        "part-time",
        "contractor",
        "temporary",
        "intern",
        "volunteer",
        "other"
      ]
    },
    "salary_min": {
      "description": "Minimum salary in the specified currency (default USD)",
      "type": "number",
      "minimum": 0
    },
    "salary_max": {
      "description": "Maximum salary in the specified currency (default USD)",
      "type": "number",
      "minimum": 0
    },
    "currency": {
      "description": "Salary currency (default: USD)",
      "type": "string",
      "enum": [
        "USD",
        "AUD",
        "EUR",
        "JPY",
        "GBP",
        "CAD",
        "CHF",
        "CNY",
        "HKD",
        "NZD",
        "SGD",
        "SEK",
        "KRW",
        "NOK",
        "INR",
        "MXN",
        "TWD",
        "ZAR",
        "BRL",
        "IDR",
        "PHP",
        "THB",
        "CLP",
        "CZK",
        "DKK",
        "HUF",
        "ILS",
        "TRY",
        "PLN"
      ]
    },
    "salary_required": {
      "description": "If false, include jobs without salary data in salary-filtered results (default: true — only jobs with salary)",
      "type": "boolean"
    },
    "markets": {
      "description": "Comma-separated market/category slugs to filter by (e.g., 'saas,fintech,healthcare')",
      "type": "string"
    },
    "benefits": {
      "description": "Comma-separated benefit slugs to filter by (e.g., '401k,health-insurance,equity')",
      "type": "string"
    },
    "companies": {
      "description": "Comma-separated company slugs to filter by (e.g., 'stripe,gitlab')",
      "type": "string"
    },
    "sort": {
      "description": "Sort order for results (default: 'relevant')",
      "type": "string",
      "enum": [
        "relevant",
        "recent",
        "salaryAsc",
        "salaryDesc"
      ]
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Get full details for a specific job including description, requirements, salary, and application link. Use the company_slug and job_slug from job listings.

{
  "type": "object",
  "properties": {
    "company_slug": {
      "type": "string",
      "description": "Company slug (from the job listing URL or company page)"
    },
    "job_slug": {
      "type": "string",
      "description": "Job slug (from the job listing URL)"
    }
  },
  "required": [
    "company_slug",
    "job_slug"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Find jobs similar to a specific job, based on skills, location, and category. Use after viewing a job to suggest alternatives.

{
  "type": "object",
  "properties": {
    "company_slug": {
      "type": "string",
      "description": "Company slug of the original job"
    },
    "job_slug": {
      "type": "string",
      "description": "Job slug of the original job"
    }
  },
  "required": [
    "company_slug",
    "job_slug"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Browse remote-friendly companies with optional filtering by country or worldwide availability

{
  "type": "object",
  "properties": {
    "page": {
      "description": "Page number for pagination (starts at 1)",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "country": {
      "description": "Filter companies by country (e.g., 'Canada', 'United States', 'UK')",
      "type": "string"
    },
    "worldwide": {
      "description": "Show only companies with 100% remote jobs available worldwide (overrides country filter)",
      "type": "boolean"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Search for remote-friendly companies using keywords with optional country filtering

{
  "type": "object",
  "properties": {
    "keyword": {
      "description": "Search keyword/term (optional)",
      "type": "string"
    },
    "page": {
      "description": "Page number for pagination (starts at 1)",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "country": {
      "description": "Filter companies by country (e.g., 'Canada', 'United States', 'UK')",
      "type": "string"
    },
    "worldwide": {
      "description": "Show only companies with 100% remote jobs available worldwide (overrides country filter)",
      "type": "boolean"
    },
    "benefits": {
      "description": "Comma-separated benefit slugs to filter by (e.g., '401k,health-insurance,equity')",
      "type": "string"
    },
    "tech_stack": {
      "description": "Comma-separated technology slugs to filter by (e.g., 'react,typescript,python')",
      "type": "string"
    },
    "sort": {
      "description": "Sort order for results (default: 'relevant')",
      "type": "string",
      "enum": [
        "relevant",
        "recent",
        "jobs",
        "nameAToZ",
        "nameZToA"
      ]
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Get full details for a company including about, tech stack, benefits, open positions, and social links

{
  "type": "object",
  "properties": {
    "company_slug": {
      "type": "string",
      "description": "Company slug (e.g., 'stripe', 'gitlab')"
    }
  },
  "required": [
    "company_slug"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Get remote work statistics: top skills, job categories, industries, or countries by job/company count. Great for understanding the remote work landscape.

{
  "type": "object",
  "properties": {
    "record": {
      "description": "What to get stats for: 'jobs' or 'companies' (default: jobs)",
      "type": "string",
      "enum": [
        "jobs",
        "companies"
      ]
    },
    "type": {
      "description": "Type of breakdown: 'skills', 'categories', 'countries', or 'industries' (default: skills). 'industries' only works with record='companies'.",
      "type": "string",
      "enum": [
        "skills",
        "categories",
        "countries",
        "industries"
      ]
    },
    "country": {
      "description": "Filter stats by country (e.g., 'United States', 'Germany')",
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Get salary benchmarks for remote jobs by job title, with optional seniority and country filters. Returns min, max, and median salary in USD.

{
  "type": "object",
  "properties": {
    "job_title": {
      "type": "string",
      "description": "Job title to look up salary for (e.g., 'software-engineer', 'product-manager', 'data-scientist'). Use hyphens instead of spaces."
    },
    "seniority": {
      "description": "Seniority level (e.g., 'senior', 'junior', 'lead', 'mid')",
      "type": "string"
    },
    "country": {
      "description": "Country slug to filter by (e.g., 'united-states', 'united-kingdom', 'germany')",
      "type": "string"
    }
  },
  "required": [
    "job_title"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Resolve a country name to the correct format accepted by Himalayas filters. Useful for fuzzy matching user input.

{
  "type": "object",
  "properties": {
    "country_string": {
      "type": "string",
      "description": "The country name to get the correct name for"
    }
  },
  "required": [
    "country_string"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Get your Himalayas profile information. Requires authentication.

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Save a job to your application tracker. Requires authentication.

{
  "type": "object",
  "properties": {
    "title": {
      "type": "string",
      "description": "Job title"
    },
    "company_name": {
      "type": "string",
      "description": "Company name"
    },
    "status": {
      "description": "Application status (default: saved)",
      "type": "string",
      "enum": [
        "seen",
        "saved",
        "applied",
        "interviewing",
        "negotiation",
        "hired",
        "archived"
      ]
    },
    "base_salary": {
      "description": "Base salary",
      "type": "number"
    },
    "max_salary": {
      "description": "Maximum salary",
      "type": "number"
    },
    "currency": {
      "description": "Salary currency (e.g., 'USD')",
      "type": "string"
    },
    "excitement": {
      "description": "Excitement level from 0-5",
      "type": "number",
      "minimum": 0,
      "maximum": 5
    },
    "notes": {
      "description": "Personal notes about this job",
      "type": "string"
    },
    "app_link": {
      "description": "Application link URL",
      "type": "string"
    },
    "himalayas_link": {
      "description": "Himalayas job listing URL",
      "type": "string"
    }
  },
  "required": [
    "title",
    "company_name"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Get all jobs in your application tracker. Requires authentication.

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Update a saved job's status or details. Requires authentication.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "number",
      "description": "Kanban item ID"
    },
    "status": {
      "description": "New application status",
      "type": "string",
      "enum": [
        "seen",
        "saved",
        "applied",
        "interviewing",
        "negotiation",
        "hired",
        "archived"
      ]
    },
    "excitement": {
      "description": "Excitement level from 0-5",
      "type": "number",
      "minimum": 0,
      "maximum": 5
    },
    "notes": {
      "description": "Updated notes",
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Remove a job from your application tracker. Requires authentication.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "number",
      "description": "Kanban item ID to remove"
    }
  },
  "required": [
    "id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Update your Himalayas profile. Requires authentication.

{
  "type": "object",
  "properties": {
    "bio": {
      "description": "Short bio",
      "type": "string"
    },
    "intro": {
      "description": "Introduction/headline",
      "type": "string"
    },
    "location": {
      "description": "Country name (e.g. 'United States', 'Australia'). Cities and 'City, Country' strings are not accepted.",
      "type": "string"
    },
    "career_search_status": {
      "description": "Career search status (e.g., 'actively_searching', 'open_to_roles', 'closed_to_roles')",
      "type": "string",
      "enum": [
        "actively_searching",
        "open_to_roles",
        "closed_to_roles"
      ]
    },
    "career_primary_role": {
      "description": "Primary role (e.g., 'software-engineer')",
      "type": "string"
    },
    "career_base_salary": {
      "description": "Desired minimum salary",
      "type": "number"
    },
    "career_max_salary": {
      "description": "Desired maximum salary",
      "type": "number"
    },
    "career_description": {
      "description": "Description of what you're looking for",
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Add a work experience to your Himalayas profile. Requires authentication.

{
  "type": "object",
  "properties": {
    "title": {
      "type": "string",
      "description": "Job title"
    },
    "company_name": {
      "type": "string",
      "description": "Company name"
    },
    "employment_type": {
      "type": "string",
      "enum": [
        "Full Time",
        "Part Time",
        "Self Employed",
        "Freelance",
        "Contractor",
        "Temporary",
        "Intern",
        "Apprenticeship",
        "Volunteer",
        "Other"
      ],
      "description": "Employment type"
    },
    "description": {
      "type": "string",
      "description": "Description of your role and responsibilities"
    },
    "location": {
      "description": "Country name for this role (e.g. 'United States', 'Germany'). Cities are not accepted.",
      "type": "string"
    },
    "start_date": {
      "description": "Start date (YYYY-MM-DD format)",
      "type": "string"
    },
    "end_date": {
      "description": "End date (YYYY-MM-DD format, omit for current role)",
      "type": "string"
    },
    "current_job": {
      "description": "Whether this is your current job",
      "type": "boolean"
    },
    "experience_skill_list": {
      "description": "Comma-separated skills used in this role",
      "type": "string"
    }
  },
  "required": [
    "title",
    "company_name",
    "employment_type",
    "description"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Add an education entry to your Himalayas profile. Requires authentication.

{
  "type": "object",
  "properties": {
    "school": {
      "type": "string",
      "description": "School or institution name"
    },
    "degree": {
      "description": "Degree (e.g., 'Bachelor of Science')",
      "type": "string"
    },
    "field": {
      "description": "Field of study (e.g., 'Computer Science')",
      "type": "string"
    },
    "start_year": {
      "description": "Start year",
      "type": "number"
    },
    "end_year": {
      "description": "End year (omit if currently enrolled)",
      "type": "number"
    },
    "description": {
      "description": "Description or achievements",
      "type": "string"
    },
    "current": {
      "description": "Whether you are currently enrolled",
      "type": "boolean"
    },
    "grade": {
      "description": "Grade or GPA",
      "type": "string"
    },
    "activities": {
      "description": "Activities and societies",
      "type": "string"
    }
  },
  "required": [
    "school"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Update your tech stack on your Himalayas profile. Requires authentication.

{
  "type": "object",
  "properties": {
    "stacks": {
      "minItems": 1,
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Array of technology names (e.g., ['React', 'TypeScript', 'Node.js'])"
    }
  },
  "required": [
    "stacks"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Search for remote talent/candidates on Himalayas. Browse professionals by keyword, country, or role.

{
  "type": "object",
  "properties": {
    "keyword": {
      "description": "Search keyword (e.g., 'react developer')",
      "type": "string"
    },
    "country": {
      "description": "Filter by country (e.g., 'United States', 'Germany')",
      "type": "string"
    },
    "page": {
      "description": "Page number for pagination (starts at 1)",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "sort": {
      "description": "Sort order (default: relevant)",
      "type": "string",
      "enum": [
        "relevant",
        "recent"
      ]
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Get full details for a candidate including bio, all experiences, education, tech stack, social links, and more. Use the talent_slug from search_talent results.

{
  "type": "object",
  "properties": {
    "talent_slug": {
      "type": "string",
      "description": "Talent slug from search_talent (e.g. 'john-doe'). Also accepts '@john-doe' or a himalayas.app/@slug profile URL."
    }
  },
  "required": [
    "talent_slug"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Get your company's profile on Himalayas. Requires employer authentication.

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Update your company's profile on Himalayas. Requires employer authentication.

{
  "type": "object",
  "properties": {
    "about": {
      "description": "Company description (HTML or plain text)",
      "type": "string"
    },
    "summary": {
      "description": "Short company summary",
      "type": "string"
    },
    "ceo": {
      "description": "CEO name",
      "type": "string"
    },
    "num_employees_range": {
      "description": "Number of employees range",
      "type": "string",
      "enum": [
        "1-10",
        "11-50",
        "51-200",
        "201-500",
        "501-1000",
        "1001-5000",
        "5000+"
      ]
    },
    "year_founded": {
      "description": "Year the company was founded",
      "type": "number"
    },
    "location_list": {
      "description": "Comma-separated list of locations (e.g., 'San Francisco, New York')",
      "type": "string"
    },
    "twitter": {
      "description": "Twitter URL",
      "type": "string"
    },
    "facebook": {
      "description": "Facebook URL",
      "type": "string"
    },
    "linkedin": {
      "description": "LinkedIn URL",
      "type": "string"
    },
    "instagram": {
      "description": "Instagram URL",
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Get your company's perks/benefits on Himalayas. Requires employer authentication.

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Add a perk/benefit to your company on Himalayas. Requires employer authentication.

{
  "type": "object",
  "properties": {
    "title": {
      "type": "string",
      "minLength": 3,
      "maxLength": 50,
      "description": "Perk title (3-50 characters)"
    },
    "category": {
      "type": "string",
      "enum": [
        "Healthcare benefits",
        "Retirement benefits",
        "Paid parental leave",
        "Equity benefits",
        "Location independent salary",
        "Profit sharing",
        "4-day workweeks",
        "Generous vacation",
        "Paid vacation",
        "Sabbaticals",
        "Unlimited time off",
        "Company meals",
        "Wellness benefits",
        "Home office budget",
        "Co-working space budget",
        "Commuter benefits",
        "Pet-friendly office",
        "Learning and development budget",
        "Company events",
        "Volunteer opportunities",
        "Open source",
        "Company credit card",
        "Life insurance",
        "Employee assistance program (EAP)",
        "Flexible working hours",
        "Disability insurance",
        "Fertility benefits",
        "Company retreats",
        "Get paid in crypto",
        "Miscellaneous"
      ],
      "description": "Perk category"
    },
    "description": {
      "type": "string",
      "minLength": 15,
      "maxLength": 450,
      "description": "Perk description (15-450 characters)"
    }
  },
  "required": [
    "title",
    "category",
    "description"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Remove a perk/benefit from your company on Himalayas. Requires employer authentication.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "number",
      "description": "Perk ID to remove (use get_company_perks to find IDs)"
    }
  },
  "required": [
    "id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Update your company's tech stack on Himalayas. Pass technology names (e.g., 'React', 'Python') and they'll be matched to the Himalayas stack database. Requires employer authentication.

{
  "type": "object",
  "properties": {
    "stacks": {
      "minItems": 1,
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Array of technology names (e.g., ['React', 'TypeScript', 'Python', 'AWS'])"
    }
  },
  "required": [
    "stacks"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

List your company's job postings on Himalayas. Shows status, views, clicks, and expiry. Requires employer authentication.

{
  "type": "object",
  "properties": {
    "page": {
      "description": "Page number for pagination (starts at 1)",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Get full details of one of your company's job postings on Himalayas. Requires employer authentication.

{
  "type": "object",
  "properties": {
    "job_slug": {
      "type": "string",
      "description": "Job slug (from list_company_jobs)"
    }
  },
  "required": [
    "job_slug"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Post a new job on Himalayas. Jobs are free to post and require admin approval before going live. Requires employer authentication.

{
  "type": "object",
  "properties": {
    "title": {
      "type": "string",
      "minLength": 5,
      "maxLength": 80,
      "description": "Job title (5-80 characters)"
    },
    "description": {
      "type": "string",
      "minLength": 350,
      "description": "Job description (350+ characters, can include HTML)"
    },
    "employment_type": {
      "type": "string",
      "enum": [
        "Full Time",
        "Part Time",
        "Contractor",
        "Temporary",
        "Intern",
        "Volunteer",
        "Other"
      ],
      "description": "Employment type"
    },
    "seniority": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "Entry-level",
          "Mid-level",
          "Senior",
          "Manager",
          "Director",
          "Executive"
        ]
      },
      "description": "Seniority levels"
    },
    "app_link_or_email": {
      "type": "string",
      "description": "Application URL or email address — backend auto-detects via @ check"
    },
    "valid_through": {
      "description": "Expiration date (ISO format, defaults to 30 days from now)",
      "type": "string"
    },
    "base_salary": {
      "description": "Minimum salary",
      "type": "number"
    },
    "max_salary": {
      "description": "Maximum salary",
      "type": "number"
    },
    "salary_country": {
      "description": "Salary currency code (default: USD)",
      "type": "string"
    },
    "category_list": {
      "description": "Comma-separated job categories",
      "type": "string"
    },
    "skill_list": {
      "description": "Comma-separated skills",
      "type": "string"
    },
    "draft": {
      "description": "Save as draft instead of submitting for approval",
      "type": "boolean"
    },
    "screening_questions": {
      "description": "Screening questions for applicants",
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "question": {
            "type": "string",
            "description": "Question text"
          },
          "question_type": {
            "type": "string",
            "enum": [
              "boolean",
              "text",
              "mpc"
            ],
            "description": "Question type"
          },
          "required": {
            "description": "Whether answer is required",
            "type": "boolean"
          },
          "expected_answer": {
            "description": "Expected answer (for boolean: 'true'/'false')",
            "type": "string"
          },
          "options": {
            "description": "Answer options (for mpc type)",
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "correct_option": {
            "description": "Index of correct option (for mpc type)",
            "type": "number"
          }
        },
        "required": [
          "question",
          "question_type"
        ]
      }
    },
    "extras": {
      "description": "Paid extras: 'sticky' ($299 pin to top for 30 days), 'newsletter' ($99 feature in weekly email for 30 days)",
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "sticky",
          "newsletter"
        ]
      }
    }
  },
  "required": [
    "title",
    "description",
    "employment_type",
    "seniority",
    "app_link_or_email"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Update an existing job posting on Himalayas. Only provide fields you want to change. For screening_questions, provide the full set — questions not included will be removed. Requires employer authentication.

{
  "type": "object",
  "properties": {
    "job_slug": {
      "type": "string",
      "description": "Job slug to update"
    },
    "title": {
      "description": "Job title (5-80 characters)",
      "type": "string",
      "minLength": 5,
      "maxLength": 80
    },
    "description": {
      "description": "Job description (350+ characters, can include HTML)",
      "type": "string",
      "minLength": 350
    },
    "employment_type": {
      "description": "Employment type",
      "type": "string",
      "enum": [
        "Full Time",
        "Part Time",
        "Contractor",
        "Temporary",
        "Intern",
        "Volunteer",
        "Other"
      ]
    },
    "seniority": {
      "description": "Seniority levels",
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "Entry-level",
          "Mid-level",
          "Senior",
          "Manager",
          "Director",
          "Executive"
        ]
      }
    },
    "app_link_or_email": {
      "description": "Application URL or email address",
      "type": "string"
    },
    "valid_through": {
      "description": "Expiration date (ISO format)",
      "type": "string"
    },
    "base_salary": {
      "description": "Minimum salary",
      "type": "number"
    },
    "max_salary": {
      "description": "Maximum salary",
      "type": "number"
    },
    "salary_country": {
      "description": "Salary currency code",
      "type": "string"
    },
    "category_list": {
      "description": "Comma-separated job categories",
      "type": "string"
    },
    "skill_list": {
      "description": "Comma-separated skills",
      "type": "string"
    },
    "draft": {
      "description": "Save as draft instead of submitting for approval",
      "type": "boolean"
    },
    "screening_questions": {
      "description": "Screening questions — provide full set, questions not included will be removed",
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "description": "Existing question ID (omit for new questions)",
            "type": "number"
          },
          "question": {
            "type": "string",
            "description": "Question text"
          },
          "question_type": {
            "type": "string",
            "enum": [
              "boolean",
              "text",
              "mpc"
            ],
            "description": "Question type"
          },
          "required": {
            "description": "Whether answer is required",
            "type": "boolean"
          },
          "expected_answer": {
            "description": "Expected answer",
            "type": "string"
          },
          "options": {
            "description": "Answer options (for mpc type)",
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "correct_option": {
            "description": "Index of correct option",
            "type": "number"
          }
        },
        "required": [
          "question",
          "question_type"
        ]
      }
    }
  },
  "required": [
    "job_slug"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Delete a job posting from your company on Himalayas. This action cannot be undone. Requires employer authentication.

{
  "type": "object",
  "properties": {
    "job_slug": {
      "type": "string",
      "description": "Job slug to delete"
    }
  },
  "required": [
    "job_slug"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Post a job on Himalayas without an account. Provide your email and company details. Payment is required — a Stripe checkout URL will be returned. No authentication needed.

{
  "type": "object",
  "properties": {
    "customer_email": {
      "type": "string",
      "description": "Your email address for payment and notifications"
    },
    "company_name": {
      "type": "string",
      "description": "Company name"
    },
    "company_url": {
      "type": "string",
      "description": "Company website URL"
    },
    "title": {
      "type": "string",
      "minLength": 5,
      "maxLength": 80,
      "description": "Job title (5-80 characters)"
    },
    "description": {
      "type": "string",
      "minLength": 350,
      "description": "Job description (350+ characters, can include HTML)"
    },
    "employment_type": {
      "type": "string",
      "enum": [
        "Full Time",
        "Part Time",
        "Contractor",
        "Temporary",
        "Intern",
        "Volunteer",
        "Other"
      ],
      "description": "Employment type"
    },
    "seniority": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "Entry-level",
          "Mid-level",
          "Senior",
          "Manager",
          "Director",
          "Executive"
        ]
      },
      "description": "Seniority levels"
    },
    "app_link_or_email": {
      "type": "string",
      "description": "Application URL or email address"
    },
    "valid_through": {
      "description": "Expiration date (ISO format, defaults to 30 days from now)",
      "type": "string"
    },
    "base_salary": {
      "description": "Minimum salary",
      "type": "number"
    },
    "max_salary": {
      "description": "Maximum salary",
      "type": "number"
    },
    "salary_country": {
      "description": "Salary currency code (default: USD)",
      "type": "string"
    },
    "category_list": {
      "description": "Comma-separated job categories",
      "type": "string"
    },
    "skill_list": {
      "description": "Comma-separated skills",
      "type": "string"
    }
  },
  "required": [
    "customer_email",
    "company_name",
    "company_url",
    "title",
    "description",
    "employment_type",
    "seniority",
    "app_link_or_email"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Purchase paid extras for an existing job posting: sticky ($299), newsletter ($99). Returns a Stripe checkout URL. Requires employer authentication.

{
  "type": "object",
  "properties": {
    "job_slug": {
      "type": "string",
      "description": "Job slug to add extras to"
    },
    "extras": {
      "minItems": 1,
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "sticky",
          "newsletter"
        ]
      },
      "description": "Extras to purchase: 'sticky' ($299 pin to top), 'newsletter' ($99 weekly email feature)"
    }
  },
  "required": [
    "job_slug",
    "extras"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Check the payment status of a job posting. Use the session_id returned from post_job_public or create_company_job with extras. No authentication required.

{
  "type": "object",
  "properties": {
    "session_id": {
      "type": "string",
      "minLength": 1,
      "description": "Stripe checkout session ID"
    }
  },
  "required": [
    "session_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

List all your messaging conversations with last message preview. Shows conversation status (awaiting reply, new reply, read). Requires employer authentication.

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Get full message history for a conversation. Accepts room_name or talent_slug. Requires employer authentication.

{
  "type": "object",
  "properties": {
    "room_name": {
      "description": "Room name from list_conversations",
      "type": "string"
    },
    "talent_slug": {
      "description": "Talent slug (from search_talent results) — resolves to room name automatically",
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Start a conversation with a candidate by talent slug. Optionally send an initial message. If the conversation already exists, returns it. Use search_talent to find candidates first, then use their slug here. Requires employer authentication.

{
  "type": "object",
  "properties": {
    "talent_slug": {
      "type": "string",
      "description": "Talent slug of the candidate to message (from search_talent results)"
    },
    "message": {
      "description": "Optional initial message to send with the conversation",
      "type": "string"
    }
  },
  "required": [
    "talent_slug"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Send a message in an existing conversation. Accepts room_name (from list_conversations) or talent_slug (from search_talent). Use start_conversation first if no conversation exists yet. Requires employer authentication.

{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "Message text to send"
    },
    "room_name": {
      "description": "Room name from list_conversations",
      "type": "string"
    },
    "talent_slug": {
      "description": "Talent slug (from search_talent results) — resolves to room name automatically",
      "type": "string"
    }
  },
  "required": [
    "message"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Mark a message as read by its ID. Requires employer authentication.

{
  "type": "object",
  "properties": {
    "message_id": {
      "type": "number",
      "description": "Message ID to mark as read"
    },
    "room_name": {
      "description": "Room name from list_conversations",
      "type": "string"
    },
    "talent_slug": {
      "description": "Talent slug (from search_talent results) — resolves to room name automatically",
      "type": "string"
    }
  },
  "required": [
    "message_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Delete a conversation. Accepts room_name or talent_slug. Requires employer authentication.

{
  "type": "object",
  "properties": {
    "room_name": {
      "description": "Room name from list_conversations",
      "type": "string"
    },
    "talent_slug": {
      "description": "Talent slug (from search_talent results) — resolves to room name automatically",
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}