Skip to main content
POST
/
api
/
public
/
v1
/
reports
Create report
curl --request POST \
  --url https://app.msportal.ai/api/public/v1/reports \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "title": "<string>",
  "companyId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "reportTypeId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "dateStart": "<string>",
  "dateEnd": "<string>",
  "description": "<string>",
  "reportTemplateId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "reportStructure": {
    "blocks": [
      {
        "id": "<string>",
        "type": "<string>",
        "params": {},
        "layout": {
          "x": 1,
          "y": 1,
          "w": 2,
          "h": 2
        }
      }
    ],
    "metadata": {
      "title": "<string>",
      "subtitle": "<string>",
      "showHeader": true,
      "showFooter": true,
      "showPageNumbers": true
    },
    "pagePreset": "<string>",
    "displaySettings": {
      "pageSize": "<string>",
      "orientation": "<string>",
      "margins": {}
    }
  },
  "status": "draft"
}
'
{
  "data": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "title": "<string>",
    "description": "<string>",
    "status": "draft",
    "isShared": true,
    "version": 123,
    "coverImageUrl": "<string>",
    "dateStart": "<string>",
    "dateEnd": "<string>",
    "companyId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "companyName": "<string>",
    "reportTypeId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "reportTypeName": "<string>",
    "reportTemplateId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "authorUserId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "createdAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z"
  }
}

Authorizations

​
Authorization
string
header
required

Use your API key as a Bearer token. API keys can be generated in Settings → Integrations → API Access.

Body

application/json
​
title
string
required

Report title (required)

Required string length: 1 - 500
​
companyId
string<uuid>
required

Company ID (required)

​
reportTypeId
string<uuid>
required

Report type ID (required)

​
dateStart
string
required

Report date range start (YYYY-MM-DD)

​
dateEnd
string
required

Report date range end (YYYY-MM-DD)

​
description
string

Report description

Maximum string length: 2000
​
reportTemplateId
string<uuid>

Template to base report on

​
reportStructure
object

Report content structure

​
status
enum<string>

Report status (default: draft)

Available options:
draft,
published

Response

Report created successfully

​
data
object
required