Request Builder

The Request Builder provides a structured interface for creating and executing LogicMonitor API requests.

Request Components

HTTP Method

Select the appropriate HTTP method from the dropdown:

Method	Purpose	Has Body
GET	Retrieve data	No
POST	Create resources	Yes
PUT	Replace resources	Yes
PATCH	Update fields	Yes
DELETE	Remove resources	No

---

Endpoint Path

Enter the API endpoint path with autocomplete:

/device/devices
/device/devices/{id}
/setting/collectors

Path Parameters

Replace {id} placeholders with actual values:

/device/devices/123
/setting/collectors/45/installers

Or use variables for reusability:

/device/devices/{{deviceId}}

The path field provides autocomplete suggestions from the endpoint catalog as you type.

---

Body Modes

The request builder offers two modes for editing request content:

Form Mode

Form mode provides structured editors for:

Section	Description
Query Parameters	Key-value pairs appended to the URL
Headers	Custom HTTP headers for the request
Body	JSON body as key-value form fields

Parameters are automatically URL-encoded when sending. Toggle parameters on/off without deleting them.

Raw JSON Mode

Raw mode provides a full JSON editor for the request body:

• Monaco editor with syntax highlighting
• Auto-formatting and validation
• Variable substitution ({{variableName}})
• Full control over JSON structure

{
  "name": "New Device",
  "displayName": "web-server-01",
  "preferredCollectorId": 1,
  "hostGroupIds": "1,2,3"
}

Toggle between modes using the Form / Raw JSON tabs above the body editor.

---

Query Parameters

Common query parameters for LogicMonitor API:

Parameter	Description	Example
size	Results per page	size=100
offset	Pagination offset	offset=0
filter	Filter expression	filter=displayName~"web"
fields	Limit response fields	fields=id,displayName
sort	Sort order	sort=+displayName

Filter Syntax

LogicMonitor filters use this syntax:

filter=property:value
filter=property~"partial"
filter=property>"2023-01-01"

Operators:

Operator	Meaning
:	equals
~	contains
!:	not equals
>	greater than
<	less than
>:	greater or equal
<:	less or equal

---

Endpoint Catalog

The left panel shows all available API endpoints organized by category.

Browsing Endpoints

1. Use the search box to filter by path, method, or description

2. Expand categories to browse endpoints

3. Click an endpoint to load it into the request builder

Endpoint Categories

Endpoints are organized by resource type:

• Devices — Device management, properties, and monitoring
• Device Groups — Group operations and hierarchy
• DataSources — LogicModule management
• Alerts — Alert management and acknowledgment
• Settings — Account and portal settings
• Reports — Report generation and scheduling

Selecting an Endpoint

When you click an endpoint in the catalog:

• Method and path are populated automatically
• Example request body is generated (for POST/PUT/PATCH)
• Tab name updates to reflect the endpoint
• Previous response is cleared

---

Sending Requests

Execute Request

Click Send Request or press Ctrl+Enter.

Request Status

During execution:

• Send button shows a spinner
• Status shows “Sending…”
• Progress indicator visible for long requests

---

Response Viewer

Response Tabs

The response viewer provides four tabs:

JSON

Collapsible, syntax-highlighted JSON tree:

• Expand/collapse nested objects and arrays
• Copy individual values
• Navigate large responses easily

Raw

Plain text response body:

• Full unformatted response
• Useful for non-JSON responses
• Search with Ctrl+F

Headers

Response headers with copy functionality:

• View all response headers
• Copy individual header values
• Check rate limit and cache headers

Snippets

Generated code snippets for the current request:

Language	Format
cURL	Command-line HTTP request
Python	requests library code
PowerShell	Invoke-RestMethod cmdlet
Groovy	HttpURLConnection code

Copy snippets to use in scripts, automation, or documentation.

Response Status

Section	Content
Status	HTTP status code and text
Time	Response duration (e.g., “234ms”)
Size	Response size in bytes

Status Codes

Success

Code	Meaning
200	Success – Request completed
201	Created – Resource created

Client Errors

Code	Meaning	Action
400	Bad Request	Fix request syntax
401	Unauthorized	Check session
403	Forbidden	Check permissions
404	Not Found	Check endpoint/IDs
429	Rate Limited	Wait and retry

Server Errors

Code	Meaning	Action
500	Server Error	Contact support
503	Service Unavailable	Retry later

---

Pagination

Handling Large Results

LogicMonitor paginates large result sets:

{
  "total": 1500,
  "searchId": null,
  "items": [...],
  "data": null
}

Pagination Parameters

Parameter	Description	Default
size	Items per page	50
offset	Starting position	0

Fetching All Results

To retrieve all items:

1. Note the total count from the first response
2. Calculate pages: ceil(total / size)
3. Increment offset by size for each page

Example for 1500 items with size=100:

• Page 1: offset=0
• Page 2: offset=100
• Page 15: offset=1400

---

Example Workflows

List Devices

1. GET /device/devices

2. Add size=1000 parameter

3. Click Send Request

4. Review device list in response

Create Device

1. POST /device/devices

2. Add request body:

   {
     "name": "hostname.example.com",
     "displayName": "My Server",
     "preferredCollectorId": 1,
     "hostGroupIds": "1"
   }

3. Click Send Request

4. Note the returned device ID

Update Device

1. PATCH /device/devices/{id}

2. Replace {id} with device ID

3. Add body:

   {
     "customProperties": [
       { "name": "environment", "value": "production" }
     ]
   }

4. Click Send Request

Delete Device

1. DELETE /device/devices/{id}

2. Replace {id} with device ID

3. Click Send Request

4. Confirm 200 response

---

Next Steps

Variables & History Use environment variables and review past API requests.