---
title: "Set job preferences"
method: POST
path: "/v1/set_job_preferences"
tags: ["profile"]
---

# Set job preferences

`POST /v1/set_job_preferences`

## Request

- Base URL: `https://api.trylitos.com`
- URL: `https://api.trylitos.com/v1/set_job_preferences`
- Auth: OAuth 2 (authorization code, authorization URL `https://api.trylitos.com/oauth/authorize`, token URL `https://api.trylitos.com/oauth/token`, scopes: `account:write`)

Save job targeting. Send only the fields to change; null clears one. Applications outside the saved locations are refused unless remote, so keep locations honest.

## Request body

- object
  - `categories` string[], nullable
  - `titles` string[], nullable
  - `role_types` string[], nullable: e.g. internship, new-grad, full-time
  - `locations` string[], nullable
  - `remote_only` boolean
  - `primary_period` string, nullable
  - `backup_period` string, nullable

## Response `200`

The operation's result. Shapes mirror the Litos dashboard routes they proxy.

- object

## Other responses

- `4XX`: A refusal, carrying `error` (a sentence) and usually `code`.

---

[API](https://skmtc.dev/trylitos/apis/litos-api.md) · [All operations](https://skmtc.dev/trylitos/apis/litos-api/llms.txt) · [OpenAPI document](https://skmtc.dev/trylitos/apis/litos-api/revisions/d0ae6f04b1ae?raw)