Skip to content
Tallyraydocs

Store a version of your workspace's own template as a draft, its checks and tests passing: its last version plus one, or the same draft revised; when your plan allows private templates

POST
/v1/buyer/templates
curl --request POST \
  --url https://example.com/v1/buyer/templates \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "source": "example" }'

Who: a workspace’s buyer, or its key. API keys with the buyer:write scope.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Header Parameters

Section titled “Header Parameters”
Idempotency-Key
string
<= 64 characters

Made once per action and sent again on every retry of it, so the service acts once: the request_id of the create or money-moving call; a new one when left out

Request Bodyrequired

Section titled “Request Bodyrequired”
Media typeapplication/json
object
source
required
string

Example generated

{
  "source": "example"
}

Responses

Section titled “Responses”

201

Section titled “201”

Created

Media typeapplication/json
object
authored_by
required
Any of:
object
account
string
id
string
kind
required
string | null
Allowed values: user api_key service system postback rule tuner schedule
name
string
category
required
string | null
Allowed values: push pop native search social display other
created_at
required
string format: date-time
decided_at
required
string | null format: date-time
decided_by
required
Any of:
object
account
string
id
string
kind
required
string | null
Allowed values: user api_key service system postback rule tuner schedule
name
string
deprecated_at
required
string | null format: date-time
docs
required
string
id
required
string
kind
required
string | null
Allowed values: traffic_source affiliate_network
name
required
string
personal_data_acknowledged
required
boolean
retire_after
required
string | null format: date-time
retired_at
required
string | null format: date-time
review_note
required
string
sha256
required
string
source
string
spec
string
status
required
string | null
Allowed values: draft in_review published rejected deprecated retired
submitted_at
required
string | null format: date-time
submitted_by
required
Any of:
object
account
string
id
string
kind
required
string | null
Allowed values: user api_key service system postback rule tuner schedule
name
string
summary
required
object
auth
required
string | null
Allowed values: none api_key basic bearer oauth2 hmac login
consent
required
string | null
Allowed values: none eea
cost_models
required
Array<string | null>
Allowed values: from_token cpc cpm cpa revshare api none
costs
required
boolean
events
required
Array<object>
object
kind
required
string | null
Allowed values: lead registration sale deposit subscription rebill custom install reengagement
name
required
string
fields
required
Array<object>
object
help
required
string
label
required
string
name
required
string
pattern
required
string
required
required
boolean
sealed
required
boolean
type
required
string | null
Allowed values: string int bool enum map
values
required
Array<string>
final_url_direct
required
boolean
hosts
required
Array<string>
max_age_seconds
required
integer format: int64
needs
required
Array<string | null>
Allowed values: ip user_agent page_url fbp
network
required
Any of:
object
click_id_param
required
string
default_kind
required
string | null
Allowed values: lead registration sale deposit subscription rebill custom install reengagement
keep_named
required
boolean
method
required
string
offer_params
required
Array<object>
object
name
required
string
value
required
string
params
required
Array<object>
object
field
required
string | null
Allowed values: click_id event status payout currency txid timestamp email phone first_name last_name city zip country external_id coupon campaign placement source_campaign creative
location
required
string | null
Allowed values: query form json
macro
required
string
name
required
string
signature
required
string | null
Allowed values: none answick_url
statuses
required
Array<object>
object
name
required
string
status
required
string | null
Allowed values: approved pending declined chargeback
txid_from
required
Array<string>
without_click
required
Array<string | null>
Allowed values: click_id event status payout currency txid timestamp email phone first_name last_name city zip country external_id coupon campaign placement source_campaign creative
objects
required
Any of:
object
levels
required
Array<object>
object
key_tokens
required
Array<string>
level
required
string | null
Allowed values: campaign ad_group ad placement
sealed_fields
required
Array<string>
spend
required
boolean
settle_seconds
required
integer format: int64
overridable
required
Array<string>
personal_data
required
boolean
placements
required
boolean
probe
required
boolean
send_on
required
Array<string | null>
Allowed values: approved pending declined chargeback
test_conversion
required
boolean
test_note
required
string
token_cost
required
Any of:
object
currency
required
string
param
required
string
unit
required
string | null
Allowed values: visit thousand_visits
tokens
required
Array<object>
object
auto
required
boolean
field
required
string | null
Allowed values: placement source_campaign creative site keyword custom external_click_id cost impression_id
label
required
string
macro
required
string
param
required
string
slot
required
integer format: int32
user_identifiers
required
Array<string>
values
required
Any of:
object
levels
required
Array<object>
object
bounds
required
Any of:
object
increment
required
Any of:
object
amount
required
Any of:
object
amount_micros
required
integer format: int64
currency
required
string
factor_ppm
required
integer | null format: int64
max
required
Any of:
object
amount
required
Any of:
object
amount_micros
required
integer format: int64
currency
required
string
factor_ppm
required
integer | null format: int64
min
required
Any of:
object
amount
required
Any of:
object
amount_micros
required
integer format: int64
currency
required
string
factor_ppm
required
integer | null format: int64
by_country
required
boolean
currency
required
string
inherits
required
string | null
Allowed values: campaign ad_group ad placement
key_tokens
required
Array<string>
kind
required
string | null
Allowed values: bid budget
level
required
string | null
Allowed values: campaign ad_group ad placement
reset
required
boolean
sealed_fields
required
Array<string>
spend
required
boolean
units
required
Array<string | null>
Allowed values: cpc cpm cpv cpa factor daily
settle_seconds
required
integer format: int64
updated_at
required
string format: date-time
version
required
integer format: int32
workspace_id
required
integer format: int64

Example 

{
  "authored_by": {
    "kind": "user"
  },
  "category": "push",
  "decided_by": {
    "kind": "user"
  },
  "kind": "traffic_source",
  "status": "draft",
  "submitted_by": {
    "kind": "user"
  },
  "summary": {
    "auth": "none",
    "consent": "none",
    "cost_models": [
      "from_token"
    ],
    "events": [
      {
        "kind": "lead"
      }
    ],
    "fields": [
      {
        "type": "string"
      }
    ],
    "needs": [
      "ip"
    ],
    "network": {
      "default_kind": "lead",
      "params": [
        {
          "field": "click_id",
          "location": "query"
        }
      ],
      "signature": "none",
      "statuses": [
        {
          "status": "approved"
        }
      ],
      "without_click": [
        "click_id"
      ]
    },
    "objects": {
      "levels": [
        {
          "level": "campaign"
        }
      ]
    },
    "send_on": [
      "approved"
    ],
    "token_cost": {
      "unit": "visit"
    },
    "tokens": [
      {
        "field": "placement"
      }
    ],
    "values": {
      "levels": [
        {
          "inherits": "campaign",
          "kind": "bid",
          "level": "campaign",
          "units": [
            "cpc"
          ]
        }
      ]
    }
  }
}

default

Section titled “default”

An error, as go-commons apperr maps it

Media typeapplication/json
object
error
required
object
code
required
string
fields
object
key
additional properties
string
message
required
string

Example generated

{
  "error": {
    "code": "example",
    "fields": {
      "additionalProperty": "example"
    },
    "message": "example"
  }
}