Config Options

Manage configurable dropdown options used across the CRM including contact sources, industries, deal loss reasons, and more.

All Config Options endpoints require JWT authentication via the Authorization: Bearer <token> header. Some endpoints require Admin role.

Core Endpoints

GET /config-options List config options

JWT Required

Retrieve all configurable dropdown options grouped by category.

Query Parameters

Name	Type	Required	Description
category	string	Optional	Filter by category

Code Examples

curl -X GET "https://crm.revorbit.com/api/config-options" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"

const response = await fetch(
  "https://crm.revorbit.com/api/config-options",
  {
    method: "GET",
    headers: {
      "Authorization": "Bearer YOUR_JWT_TOKEN",
    }
  }
);
const data = await response.json();

POST /config-options Create config option

Admin Required

Request Body

Name	Type	Required	Description
category	string	Required	Category (e.g. contact_source, industry, deal_type)
label	string	Required
value	string	Required
is_default	boolean	Optional

Code Examples

curl -X POST "https://crm.revorbit.com/api/config-options" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"category":"...","label":"...","value":"...","is_default":true}'

const response = await fetch(
  "https://crm.revorbit.com/api/config-options",
  {
    method: "POST",
    headers: {
      "Authorization": "Bearer YOUR_JWT_TOKEN",
      "Content-Type": "application/json"
    },
    body: JSON.stringify(
      {
          "category": "...",
          "label": "...",
          "value": "...",
          "is_default": true
      }
    )
  }
);
const data = await response.json();

PUT /config-options/{id} Update config option

Admin Required

Path Parameters

Name	Type	Required	Description
id	integer	Required	Resource ID

Request Body

Name	Type	Required
label	string	Optional
value	string	Optional
is_default	boolean	Optional

Code Examples

curl -X PUT "https://crm.revorbit.com/api/config-options/{id}" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"label":"...","value":"...","is_default":true}'

const response = await fetch(
  "https://crm.revorbit.com/api/config-options/{id}",
  {
    method: "PUT",
    headers: {
      "Authorization": "Bearer YOUR_JWT_TOKEN",
      "Content-Type": "application/json"
    },
    body: JSON.stringify(
      {
          "label": "...",
          "value": "...",
          "is_default": true
      }
    )
  }
);
const data = await response.json();

DELETE /config-options/{id} Delete config option

Admin Required

Path Parameters

Name	Type	Required	Description
id	integer	Required	Resource ID

Code Examples

curl -X DELETE "https://crm.revorbit.com/api/config-options/{id}" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"

const response = await fetch(
  "https://crm.revorbit.com/api/config-options/{id}",
  {
    method: "DELETE",
    headers: {
      "Authorization": "Bearer YOUR_JWT_TOKEN",
    }
  }
);
const data = await response.json();

GET /config-options/default/{category} Get default option for category

JWT Required

Returns the config option marked as default for the given category, or null if none is set.

Path Parameters

Name	Type	Required	Description
category	string	Required	Config option category (e.g. payment_terms, currency)

Response

Default option (or null)

{
    "success": true,
    "data": {
        "id": 1,
        "label": "...",
        "value": "...",
        "is_default": true
    }
}

Code Examples

curl -X GET "https://crm.revorbit.com/api/config-options/default/{category}" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"

const response = await fetch(
  "https://crm.revorbit.com/api/config-options/default/{category}",
  {
    method: "GET",
    headers: {
      "Authorization": "Bearer YOUR_JWT_TOKEN",
    }
  }
);
const data = await response.json();

PUT /config-options/reorder/{category} Reorder options

Admin Required

Set the display order for options within a category.

Path Parameters

Name	Type	Required	Description
category	string	Required

Request Body

Name	Type	Required	Description
order	array[integer]	Required	Array of option IDs in desired order

Code Examples

curl -X PUT "https://crm.revorbit.com/api/config-options/reorder/{category}" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"order":[1]}'

const response = await fetch(
  "https://crm.revorbit.com/api/config-options/reorder/{category}",
  {
    method: "PUT",
    headers: {
      "Authorization": "Bearer YOUR_JWT_TOKEN",
      "Content-Type": "application/json"
    },
    body: JSON.stringify(
      {
          "order": [
              1
          ]
      }
    )
  }
);
const data = await response.json();