API reference

This is the shared reference for the intSignal REST API. Product resources (such as SOC cases) follow every convention here.

Requests

• Base URL: https://api.intsignal.com/v1
• HTTPS only; JSON request and response bodies
• Send Authorization: Bearer <token> on every request
• Send Content-Type: application/json on POST/PATCH

Pagination

List endpoints return a page of data plus a next_cursor. Pass it back as cursor to get the next page; a null next_cursor means the last page.

curl "https://api.intsignal.com/v1/devices?limit=100" \
  -H "Authorization: Bearer $INTSIGNAL_TOKEN"

{ "data": [ /* … */ ], "next_cursor": "eyJvIjoxMDB9" }

Filtering & sorting

Most list endpoints accept resource-specific filters plus:

Errors

Errors use standard HTTP status codes and a consistent body:

{
  "error": {
    "code": "invalid_scope",
    "message": "Token is missing required scope: soc:write",
    "request_id": "req_2c9a1f"
  }
}

Always log the request_id; it lets support trace a specific call.

Shared resources