1 of 1

Create Inquiries

API to create new inquiries in Monolith

Create an inquiry

POST /api/v1/inquiries

Create a new inquiry in Monolith vai HTTPS

Headers

Name

Type

Description

x-api-key*

String

Monolith API Key

Request Body

Name

Type

Description

client*

JSON

A JSON object with client info.

request_name

String

A name for this inquiry.

request_id

String

This is the request_id of the inquiry. This value is usually associated with a Relay request, but can also be associated with external request systems if utilized via API when creating an inquiry.

client_ref_number

String

A case or matter number related to the requestor.

description

String

A description of the inquiry - usually the details of the request being made.

inquiry_type

String

Type of inquiry - should map to the case types in your Monolith database.

referred_by

String

Source of inquiry - defaults to "API Request"

evidence

Array

This is an array of evidence objects.

client.name*

String

Name of the requestor.

client.email*

String

Email of requesting client.

client.org

String

Organization of requestor.

client.phone

String

Office phone number of requestor.

client.mobile

String

Mobile phone number of requestor.

client.address

String

Address of requestor.

client.city

String

City of requestor.

client.region

String

State or province of requestor.

client.postal_code

String

Postal code for requestor.

client.type

String

Type of client

evidence.evidence_number

String

Evidence number for requestor

evidence.item_name*

String

Name of evidence item.

evidence.provider

String

Manufacturer or service provider.

evidence.evidence_type

String

Type of evidence - should map to evidence types in Monolith.

evidence.unique_id

String

Serial number or account identifier for evidence item.

evidence.description

String

Description of evidence.

contacts

Array

Array of contact objects

contacts.name*

String

Name of person.

contacts.type

String

Type of contact/person.

contacts.unique_id

String

Identifier of person.

contacts.description

String

Description or notes related to person.

documents

Array

Array of document objects

documents.name*

String

Filename of document

documents.data*

String

Base64 encoded string of file data.

Create Inquiry Example

# Using uuid as URL path param

import requests

# set your Monolith API key into a variable
api_key = "qucuqwqg5q3rve28ehfh" # this is a fake API key

# Set the api key in the header of the request
headers = {
	"x-api-key": api_key
}

data = {
    "request_name": "My New Request/Inquiry",
    "inquiry_type": "Incident Response",
    "description": "this is an api test",
    "client": { # client is required for this API
        "name": "dev forensics", # required
        "email": "dev5@monolithforensics.com" # required
    },
    "contacts": [
        {
            "name": "Rick Sanchez" # required when contacts is provided
        }
    ],
    "documents": [
        # 25 MB file size limit
        {
           # name is required when documents is provided
            "name": "Important Document.pdf",
            # data is also required
            "data": "JVBERi0xLjQKJfbk/N8KMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovVmVyc2lvbiAvMS40Ci9QYWdlcyAyIDAgUgovU3RydWN0VHJlZVJvb3QgMyAwIFIKL01hcmtJbmZvIDQgMCBSCi9MYW5nIChlbikKL1ZpZXdlclByZWZlcmVuY2VzIDUgMCBSCj4+CmVuZG9iago2IDAgb2JqCjw8Ci9DcmVhdG9yIChDYW52YSkKL1Byb2R1Y2VyIChDYW52YSkKL0NyZWF0aW9uRGF0ZSAoRDoyMDIzMDkyNTIwMTAwNSswMCcwMCcpCi9Nb2REYXRlIChEOjIwMjMwOTI1MjAxMDA1KzAwJzAwJykKL0tleXdvcmRzIChEQUZ2ZWlFajFBOCxCQUU0aklBMXU2VSkKL0F1dGhvciAoTWF0dCBEYW5uZXIpCi9UaXRsZSAoTmVwdHVuZSBQcm9kdWN0IEZseWVyKQo+PgplbmRvYmoKMiAwIG9iago8PAovVHlwZSAvUGFnZXMKL0tpZHMgWzcgMCBSXQovQ291bnQgMQo+PgplbmRvYmoKMyAwIG9iago8PAovVHlwZSAvU3RydWN0VHJlZVJvb3QKL1BhcmVudFRyZWUgOCAwIFIKL1BhcmVudFRyZWVOZXh0S2V5IDEKL0sgWzkgMCBSXQovSURUcmVlIDEwIDAgUgo+"
        }
    ],
    "evidence": [
        {
            "evidence_number": "123456", 
            "evidence_type": "Smartphone",
            "item_name": "iPhone 15",  # required when evidence array is provided
            "provider": "Apple",
            "unique_id": "55485415241", 
            "description": "This is test evidence"
        }
    ]
}

# Use the appropriate API endpoint for your region
api_url = f"https://monolith-app.monolithforensics.com/api/v1/inquiries"

# Execute the POST request
# returns a JSON object with inquiry_id and uuid values
response = requests.post(api_url, headers=headers, json=data)

# print the JSON response to console
print(response.json())

Create Inquiries

API to create new inquiries in Monolith

Create an inquiry

POST /api/v1/inquiries

Create a new inquiry in Monolith vai HTTPS

Headers

Name

Type

Description

x-api-key*

String

Monolith API Key

Request Body

Name

Type

Description

client*

JSON

A JSON object with client info.

request_name

String

A name for this inquiry.

request_id

String

This is the request_id of the inquiry. This value is usually associated with a Relay request, but can also be associated with external request systems if utilized via API when creating an inquiry.

client_ref_number

String

A case or matter number related to the requestor.

description

String

A description of the inquiry - usually the details of the request being made.

inquiry_type

String

Type of inquiry - should map to the case types in your Monolith database.

referred_by

String

Source of inquiry - defaults to "API Request"

evidence

Array

This is an array of evidence objects.

client.name*

String

Name of the requestor.

client.email*

String

Email of requesting client.

client.org

String

Organization of requestor.

client.phone

String

Office phone number of requestor.

client.mobile

String

Mobile phone number of requestor.

client.address

String

Address of requestor.

client.city

String

City of requestor.

client.region

String

State or province of requestor.

client.postal_code

String

Postal code for requestor.

client.type

String

Type of client

evidence.evidence_number

String

Evidence number for requestor

evidence.item_name*

String

Name of evidence item.

evidence.provider

String

Manufacturer or service provider.

evidence.evidence_type

String

Type of evidence - should map to evidence types in Monolith.

evidence.unique_id

String

Serial number or account identifier for evidence item.

evidence.description

String

Description of evidence.

contacts

Array

Array of contact objects

contacts.name*

String

Name of person.

contacts.type

String

Type of contact/person.

contacts.unique_id

String

Identifier of person.

contacts.description

String

Description or notes related to person.

documents

Array

Array of document objects

documents.name*

String

Filename of document

documents.data*

String

Base64 encoded string of file data.

Create Inquiry Example

# Using uuid as URL path param

import requests

# set your Monolith API key into a variable
api_key = "qucuqwqg5q3rve28ehfh" # this is a fake API key

# Set the api key in the header of the request
headers = {
	"x-api-key": api_key
}

data = {
    "request_name": "My New Request/Inquiry",
    "inquiry_type": "Incident Response",
    "description": "this is an api test",
    "client": { # client is required for this API
        "name": "dev forensics", # required
        "email": "dev5@monolithforensics.com" # required
    },
    "contacts": [
        {
            "name": "Rick Sanchez" # required when contacts is provided
        }
    ],
    "documents": [
        # 25 MB file size limit
        {
           # name is required when documents is provided
            "name": "Important Document.pdf",
            # data is also required
            "data": "JVBERi0xLjQKJfbk/N8KMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovVmVyc2lvbiAvMS40Ci9QYWdlcyAyIDAgUgovU3RydWN0VHJlZVJvb3QgMyAwIFIKL01hcmtJbmZvIDQgMCBSCi9MYW5nIChlbikKL1ZpZXdlclByZWZlcmVuY2VzIDUgMCBSCj4+CmVuZG9iago2IDAgb2JqCjw8Ci9DcmVhdG9yIChDYW52YSkKL1Byb2R1Y2VyIChDYW52YSkKL0NyZWF0aW9uRGF0ZSAoRDoyMDIzMDkyNTIwMTAwNSswMCcwMCcpCi9Nb2REYXRlIChEOjIwMjMwOTI1MjAxMDA1KzAwJzAwJykKL0tleXdvcmRzIChEQUZ2ZWlFajFBOCxCQUU0aklBMXU2VSkKL0F1dGhvciAoTWF0dCBEYW5uZXIpCi9UaXRsZSAoTmVwdHVuZSBQcm9kdWN0IEZseWVyKQo+PgplbmRvYmoKMiAwIG9iago8PAovVHlwZSAvUGFnZXMKL0tpZHMgWzcgMCBSXQovQ291bnQgMQo+PgplbmRvYmoKMyAwIG9iago8PAovVHlwZSAvU3RydWN0VHJlZVJvb3QKL1BhcmVudFRyZWUgOCAwIFIKL1BhcmVudFRyZWVOZXh0S2V5IDEKL0sgWzkgMCBSXQovSURUcmVlIDEwIDAgUgo+"
        }
    ],
    "evidence": [
        {
            "evidence_number": "123456", 
            "evidence_type": "Smartphone",
            "item_name": "iPhone 15",  # required when evidence array is provided
            "provider": "Apple",
            "unique_id": "55485415241", 
            "description": "This is test evidence"
        }
    ]
}

# Use the appropriate API endpoint for your region
api_url = f"https://monolith-app.monolithforensics.com/api/v1/inquiries"

# Execute the POST request
# returns a JSON object with inquiry_id and uuid values
response = requests.post(api_url, headers=headers, json=data)

# print the JSON response to console
print(response.json())