Core Resources

Co-Marketing

The shared marketing resource library tenants publish for their partners, marketers, and providers to download and share — images, videos, social posts, print, email templates, landing pages, and campaign kits. Each resource can expose a tokenized public share page.

Categorized library

Social-first resource categories with thumbnails

Built from anywhere

Files, landing pages, or full campaigns

Public share links

Tokenized share pages with OG metadata

Base path

Tenant-facing co-marketing endpoints are mounted under /v1/partners/co-marketing. Partner and marketer portals read the same library through /v1/partners/portal/co-marketing.

List Resources

Returns a paginated list of co-marketing resources. Pass grouped=true to instead receive resources bucketed by category — convenient for rendering the resource grid directly.

Query Parameters

Parameter	Type	Default	Description
`page`	`integer`	1	Page number
`limit`	`integer`	50	Items per page
`category`	`string` social-postsimagesvideosprintemail-templateslanding-pagescampaign-kitsother	—	Filter by category
`status`	`string` activearchived	—	Filter by status
`sourceType`	`string` filelanding-pagecampaign	—	Filter by source
`grouped`	`boolean`	false	Return resources grouped by category instead of a paginated list

Request

HTTP

http

GET https://api.leadron.dev/v1/partners/co-marketing?category=social-posts&page=1&limit=20
X-API-Key: ldr_live_sk_a1b2c3d4e5f6g7h8i9j0

Response200OK

200 Response

json

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

31

32

33

34

35

36

37

{
  "success": true,
  "status": 200,
  "message": "Co-marketing assets",
  "data": [
    {
      "id": "cm_7h2k9d4f1a0b",
      "name": "Social Media Kit Q1 2026",
      "category": "social-posts",
      "sourceType": "file",
      "description": "Instagram, LinkedIn, and X post templates with partner branding.",
      "fileType": "zip",
      "fileSize": "45.2 MB",
      "thumbnailUrl": "https://cdn.leadron.dev/thumbs/cm_7h2k9d4f1a0b.png",
      "shareEnabled": true,
      "shareToken": "Jx7-aQ2m_demo",
      "shareCaption": "Grab our latest social kit",
      "downloads": 98,
      "shares": 71,
      "status": "active",
      "createdAt": "2026-02-08T14:30:00.000Z",
      "updatedAt": "2026-02-08T14:30:00.000Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 9,
    "totalPages": 1,
    "hasNext": false,
    "hasPrev": false
  },
  "meta": {
    "timestamp": "2026-02-08T14:30:00.000Z",
    "version": "v1"
  }
}

Response200OK (grouped=true)

200 Response

json

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

31

32

33

34

35

36

37

38

{
  "success": true,
  "status": 200,
  "message": "Co-marketing resources",
  "data": {
    "social-posts": [
      {
        "id": "cm_7h2k9d4f1a0b",
        "name": "Social Media Kit Q1 2026",
        "category": "social-posts",
        "sourceType": "file",
        "description": "Instagram, LinkedIn, and X post templates with partner branding.",
        "fileType": "zip",
        "fileSize": "45.2 MB",
        "thumbnailUrl": "https://cdn.leadron.dev/thumbs/cm_7h2k9d4f1a0b.png",
        "shareEnabled": true,
        "shareToken": "Jx7-aQ2m_demo",
        "shareCaption": "Grab our latest social kit",
        "downloads": 98,
        "shares": 71,
        "status": "active",
        "createdAt": "2026-02-08T14:30:00.000Z",
        "updatedAt": "2026-02-08T14:30:00.000Z"
      }
    ],
    "images": [],
    "videos": [],
    "print": [],
    "email-templates": [],
    "landing-pages": [],
    "campaign-kits": [],
    "other": []
  },
  "meta": {
    "timestamp": "2026-02-08T14:30:00.000Z",
    "version": "v1"
  }
}

Get Resource

Get Download URL

Resolves a directly usable download URL for the resource's file. If the resource stores a fileUrl it is returned as-is; otherwise the associated fileId is resolved through the file-storage service into a presigned URL.

Create Resource

Creates a resource from an uploaded file, an existing landing page, or a campaign — selected via sourceType. A unique share token is generated automatically when shareEnabled is true.

Update Resource

Archive & Delete

Usage Tracking

Increment the download and use counters surfaced on each resource card.

Public Share Links

No authentication

These two endpoints resolve a resource by its share token only and require no tenant or API-key auth — they back the public /s/<token> share page. They return a public-safe shape that omits internal fields.

Portal Endpoints

Partner and marketer portals read the resource library through their authenticated portal session (portal JWT), not an API key. The marketer portal shares the same handlers as the partner portal.