List marketing/ad campaigns

SessionCookie (VIEWER) OR an MCP-scoped principal with scope mcp:links_write (used by the create_short_link tool). Optional status/platform filters.

Authorizations

• SessionCookie

Parameters

Path Parameters

projectId

required

string

Tenant project id (row-level isolation on every query).

Query Parameters

status

string

platform

string

Responses

200

Campaigns.

Media typeapplication/json

object

campaigns

Array<object>

object

key

additional properties

any

400

Missing projectId.

Media typeapplication/json

object

error

required

Human-readable error message.

string

message

string

Example^generated

json

{
  "error": "example",
  "message": "example"
}

401

Not authenticated (no valid session/principal).

Media typeapplication/json

object

error

required

Human-readable error message.

string

message

string

Example^generated

json

{
  "error": "example",
  "message": "example"
}

403

Authenticated but lacks the required project role.

Media typeapplication/json

object

error

required

Human-readable error message.

string

message

string

Example^generated

json

{
  "error": "example",
  "message": "example"
}