List Presentations

Retrieve a paginated list of presentations

Base URL

https://appdev.mexus.cc

Authentication

All API requests require an API Key included in the Header. If you don't have one, create it on the API Tokens page:

Authorization: Bearer YOUR_API_KEY

Endpoint

GET /api/v1/presentation
Authorization: Bearer YOUR_API_KEY

Query Parameters

Parameter	Type	Required	Default	Description
projectId	string	No	-	Filter presentations by project ID
page	number	No	1	Page number for pagination
perPage	number	No	10	Number of items per page (max 100)

Response

Response Structure

{
  "items": Array<Presentation>,
  "total": number,
  "page": number,
  "perPage": number
}

Presentation Object

Field	Type	Description
id	number	The presentation task ID
name	string	Filename of the generated presentation
status	string	Current status of the presentation
updatedAt	string	Last update date and time in ISO format
size	number	Size of the file in bytes
pages	number	Number of slides in the presentation
title	string	Presentation title
author	string	Author name
subject	string	Presentation subject
company	string	Company name
url	string	Download URL for the generated presentation

Examples

Basic Request

GET /api/v1/presentation

Request with Filters

GET /api/v1/presentation?projectId=proj_123456&page=2&perPage=20

Successful Response

{
  "items": [
    {
      "id": 123,
      "name": "annual_report_2025.pptx",
      "status": "active",
      "updatedAt": "2025-05-04T11:30:00Z",
      "size": 2458621,
      "pages": 15,
      "title": "Annual Report 2025",
      "author": "Finance Team",
      "subject": "Financial Performance",
      "company": "Acme Corporation",
      "url": "https://storage.example.com/presentations/annual_report_2025.pptx"
    },
    {
      "id": 124,
      "name": "sales_presentation_q2.pptx",
      "status": "active",
      "updatedAt": "2025-05-03T09:15:00Z",
      "size": 1845327,
      "pages": 12,
      "title": "Q2 Sales Presentation",
      "author": "Sales Team",
      "subject": "Quarterly Results",
      "company": "Acme Corporation",
      "url": "https://storage.example.com/presentations/sales_presentation_q2.pptx"
    }
  ],
  "total": 50,
  "page": 1,
  "perPage": 10
}