Create or update a subcategory preference

PUT

/api/v1/user-subcategory-preference

const url = 'https://example.com/api/v1/user-subcategory-preference';
const options = {
  method: 'PUT',
  headers: {'Content-Type': 'application/json'},
  body: '{"subcategory":"example","visible":true}'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request PUT \
  --url https://example.com/api/v1/user-subcategory-preference \
  --header 'Content-Type: application/json' \
  --data '{ "subcategory": "example", "visible": true }'

Request Body^required

application/json

object

subcategory

required

Subcategory ID (15 chars)

string

visible

required

boolean

Example^generated

{
  "subcategory": "example",
  "visible": true
}

Responses

200

Saved subcategory preference

application/json

object

required

Preference ID (15 chars)

string

user

required

User ID (15 chars)

string

subcategory

required

Subcategory ID (15 chars)

string

visible

required

boolean

priority

integer

nullable

created

string format: date-time

updated

string format: date-time

Example^generated

{
  "id": "example",
  "user": "example",
  "subcategory": "example",
  "visible": true,
  "priority": 1,
  "created": "2026-04-15T12:00:00Z",
  "updated": "2026-04-15T12:00:00Z"
}

400

Bad Request

401

Unauthorized

500

Internal Server Error

Create or update a subcategory preference

Request Bodyrequired

Examplegenerated

Responses

200

Examplegenerated

400

401

500

Request Body^required

Example^generated

Example^generated