# Update activation

Update an activation (formerly syndication).

Endpoint: PUT /audiences/{audienceId}/segments/{segmentId}/syndications/{syndicationId}
Version: 1.0.0
Security: TdApikeyAuth

## Path parameters:

  - `audienceId` (integer, required)
    Master Segment ID of the syndication

  - `segmentId` (integer, required)
    Segment ID of the syndication

  - `syndicationId` (integer, required)
    ID of Syndication to return

## Request fields (application/json):

  - `name` (string, required)

  - `description` (string)

  - `allColumns` (boolean)
    syndication all column flag  ('true' means  that you use all attribute data)

  - `columns` (array)
    Syndication column detail. Basic syntax is .  accepts various definitions. See ColumnExpression/StringExpression for details. example value is using ColumnExpression without  property.
    Example: [{"column":"alias_name","source":{"column":"real_column_name"}}]

  - `columns.id` (string)

  - `columns.column` (string, required)

  - `columns.source` (any, required)

  - `repeatUnit` (string)
    Setting an activation repetition cycle such as "day" or "week".
    Enum: "none", "minute", "hour", "day", "week", "month", "once"

  - `repeatFrequency` (integer)
    Setting an activation repeat frequency.
Currently, it is set only when the repeat unit is "minute". If the repeat unit is "minute", the interval is set in minutes.

  - `repeatSubFrequency` (array)
    Parameter for more detailed frequency settings. Values are array of integers.
Currently, this parameter is only valid for repeat unit "week".
For multiple days of the week, each value should be 1 to 7.
1: Monday, 2: Tuesday, 3: Wednesday, 4: Thursday, 5: Friday, 6: Saturday, 7: Sunday
    Example: [1,5,6]

  - `startAt` (string,null)
    cdp-api will fill some value for old syndications with ScheduleType is not NoneType. '%Y-%M-%DT%h:%m:%s' is expected.

  - `runAt` (string)

  - `cron` (string)

  - `timezone` (string)

  - `connectionId` (integer,null)

  - `connectorConfig` (object,null)

  - `notifyOn` (array)
    Enum: "onSuccess", "onFailure"

  - `emailRecipients` (array)

  - `nestedWorkflowProjectName` (string)

  - `nestedWorkflowName` (string)

  - `lockEnabled` (boolean)

  - `activationTemplateId` (string,null)

  - `syndicationBehavior` (object,null)

  - `syndicationBehavior.behaviorTableName` (string)
    Behavior table name which contains behavior records
    Example: "purchase_history"

  - `syndicationBehavior.joinRow` (integer,null)
    How much rows would be joined (value is N for Top-N join)
    Example: 3

  - `syndicationBehavior.joinStrategy` (string)
    Enum: "All", "First", "Last", "Top-N"

  - `syndicationBehavior.formatting` (string)
    Enum: "rows", "cols"

  - `syndicationBehavior.orderBy` (array)
    Example: [{"key":"purchased_at","order":"descending"},{"key":"price","order":"ascending"}]

  - `syndicationBehavior.orderBy.key` (string)
    Example: "purchased_at"

  - `syndicationBehavior.orderBy.order` (string)
    Enum: "ascending", "descending"

  - `scheduleType` (string)
    Deprecated. Old parameter for setting schedule type. See/Use RepeatUnit instead.
    Enum: "cron", "daily", "hourly", "minutes_interval", "monthly", "none", "weekly"

  - `scheduleOption` (string)
    Deprecated. Old parameter for setting schedule. Use startAt instead.

## Response 200 fields (application/json):

  - `id` (string)

  - `audienceId` (string)

  - `segmentId` (string)

  - `name` (string)

  - `description` (string)

  - `allColumns` (boolean)
    syndication all column flag  ('true' means  that you use all attribute data)

  - `columns` (any)

  - `scheduleType` (string)
    Enum: "cron", "daily", "hourly", "minutes_interval", "monthly", "none", "weekly"

  - `scheduleOption` (string,null)

  - `startAt` (string,null)
    cdp-api will fill some value for old syndications with ScheduleType is not NoneType. '%Y-%M-%DT%h:%m:%s' is expected.

  - `endOn` (string,null)

  - `repeatUnit` (string,null)

  - `repeatFrequency` (integer,null)

  - `repeatSubFrequency` (array)
    Parameter for more detailed frequency settings. Values are array of integers.
Currently, this parameter is only valid for repeat unit "week".
For multiple days of the week, each value should be 1 to 7.
1: Monday, 2: Tuesday, 3: Wednesday, 4: Thursday, 5: Friday, 6: Saturday, 7: Sunday
    Example: [1,5,6]

  - `timezone` (string)

  - `connectionId` (string,null)

  - `connectorConfig` (object,null)

  - `createdAt` (string)

  - `updatedAt` (string)

  - `createdBy` (object)

  - `createdBy.td_user_id` (string)

  - `updatedBy` (object)

  - `valid` (boolean)

  - `executions` (array)

  - `executions.workflowId` (string, required)

  - `executions.workflowSessionId` (string, required)

  - `executions.finishedAt` (string,null, required)

  - `executions.status` (string, required)
    Enum: "success", "canceled", "error", "canceling", "blocked", "queued", "running"

  - `executions.workflowAttemptId` (string, required)

  - `executions.syndicationId` (string)

  - `notifyOn` (array)
    Enum: "onSuccess", "onFailure"

  - `emailRecipients` (array)

  - `activationTemplateId` (string,null)

## Response 400 fields (application/json):

  - `code` (string, required)

  - `message` (string, required)

## Response 401 fields (application/json):

  - `code` (string, required)

  - `message` (string, required)

## Response 403 fields (application/json):

  - `code` (string, required)

  - `message` (string, required)

## Response 404 fields (application/json):

  - `code` (string, required)

  - `message` (string, required)

## Response 4XX fields (application/json):

  - `code` (string, required)

  - `message` (string, required)

## Response 5XX fields (application/json):

  - `status` (integer, required)
    Error status

  - `error` (string, required)
    Error message

  - `details` (string)
    Detailed error message