Update a marketing/ad campaign

Requires EDITOR. At least one field required.

Authorizations

• SessionCookie

Parameters

Path Parameters

projectId

required

string

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

campaignId

required

string

Campaign id.

Request Body^required

Media typeapplication/json

Partial update; at least one field required.

object

>= 1 properties

name

string

>= 1 characters

type

string

platform

string | null

budget

number | null

utmSource

string | null

utmMedium

string | null

utmCampaign

string | null

utmTerm

string | null

utmContent

string | null

startDate

string | null

endDate

string | null

status

string

config

object | null

Example^generated

json

{
  "name": "example",
  "type": "example",
  "platform": "example",
  "budget": 1,
  "utmSource": "example",
  "utmMedium": "example",
  "utmCampaign": "example",
  "utmTerm": "example",
  "utmContent": "example",
  "startDate": "example",
  "endDate": "example",
  "status": "example",
  "config": "example"
}

Responses

200

Updated.

Media typeapplication/json

object

ok

boolean

campaign

object

key

additional properties

any

400

Invalid config.

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"
}

404

Resource not found (or belongs to another project — indistinguishable).

Media typeapplication/json

object

error

required

Human-readable error message.

string

message

string

Example^generated

json

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