Skip to main content

API Basics

Welcome to the Incipulse API. This guide covers the fundamental conventions and standards used across our API reference.

Base URL

All API requests should be made to the following base URL:

https://stg.itechops.com/api

[!NOTE] Some endpoints may have specific prefixes like /admin. Always refer to the endpoint documentation for the full path.

HTTP Verbs

We use standard HTTP verbs to indicate the type of action being performed:

VerbDescription
GETRetrieve a resource or a list of resources.
POSTCreate a new resource or perform a complex action (like search).
PUTUpdate an existing resource (full replacement).
PATCHUpdate specific fields of a resource (partial update).
DELETERemove a resource.

Data Formats

Request Body

All POST, PUT, and PATCH requests expect data in JSON format. You must include the following header:

Content-Type: application/json

Success Responses

Most success responses are wrapped in a standard ApiResponse<T> structure:

{
"Success": true,
"Result": { ... },
"Message": "Success"
}

Error Responses

In case of errors (400, 401, 500, etc.), the API returns a clear message:

{
"Success": false,
"Result": null,
"Message": "Error details here"
}

Date Format

All dates are returned in ISO 8601 format: YYYY-MM-DDTHH:mm:ssZ.