---
title: "Create an SSAI strategy config"
method: POST
path: "/v2/sites/{site_id}/ssai_strategies/"
tags: ["ssai"]
---

# Create an SSAI strategy config

`POST /v2/sites/{site_id}/ssai_strategies/`

Create an SSAI strategy config for a site

## Path parameters

- `site_id` string, required — Unique identifier for a resource

## Request body

- StrategyConfigMetadata
  - `metadata` object, required
    - `name` string, required — Name of the SSAI strategy rules
    - `strategy_rules` object, required — Rule sets used to dynamically evaluate advertising strategies and select the ad_config_id to apply
      - `rules` LineItem[], required — List of line-items to evaluate and redirect to the first match - If no rules evaluate to true, the ad-config-id for the request will be null, and SSAI will not be applied. - If exactly one rule evaluates to true, the values defined in its action object override any default ad config values. - If multiple rules evaluate to true, one rule is selected randomly, weighted by each rule's weight value, and its action values are applied.
        - `weight` number — Weight used to determine which line-item should receive traffic when multiple predicates match
        - `predicates` Predicate[] — Conditions evaluated at request time to determine which line-item applies Predicates compare known request data, such as query parameters or request headers, against expected values to decide which ad config should be shown
          - `key` string, required — Name of a session-defined variable to compare against the `value`
          - `op` 'equals' | 'not-equals' | 'contains' | 'not-contains' | 'greater-than' | 'less-than' | 'greater-than-equals' | 'less-than-equals' — Comparison operator for the key and value
          - `value` string, required — Value to compare `key` against
        - `action` object, required — Defines the action taken in response to a line-item's selection
          - `ad_config_id` string, required — Unique alphanumeric ID of an ad config
          - `stitch_mode` 'ssai' | 'jit' | 'sgai' — Stitching mode to use for ad insertion
          - `bumpers` 'disabled' | 'start' | 'end' | 'both' — Configuration for ad bumpers
      - `config` object — Object containing the parameters used to evaluate all SSAI strategy rules
        - `weight_keys` string[] — Specifies the variables that are input into the algorithm to generate a deterministic hash

## Response `201`

Request to create SSAI strategy config successful

- StrategyConfigResourceRead
  - `schema` string
  - `id` string — Unique identifier for a resource
  - `created` string — Date and time at which the resource was created
  - `last_modified` string — Date and time at which the resource was most recently modified
  - `type` string — Name of the type of resource.
  - `relationships` object — Ancilliary resources associated to the primary resource being read
  - `metadata` object, required
    - `name` string, required — Name of the SSAI strategy rules
    - `strategy_rules` object, required — Rule sets used to dynamically evaluate advertising strategies and select the ad_config_id to apply
      - `rules` LineItem[], required — List of line-items to evaluate and redirect to the first match - If no rules evaluate to true, the ad-config-id for the request will be null, and SSAI will not be applied. - If exactly one rule evaluates to true, the values defined in its action object override any default ad config values. - If multiple rules evaluate to true, one rule is selected randomly, weighted by each rule's weight value, and its action values are applied.
        - `weight` number — Weight used to determine which line-item should receive traffic when multiple predicates match
        - `predicates` Predicate[] — Conditions evaluated at request time to determine which line-item applies Predicates compare known request data, such as query parameters or request headers, against expected values to decide which ad config should be shown
          - `key` string, required — Name of a session-defined variable to compare against the `value`
          - `op` 'equals' | 'not-equals' | 'contains' | 'not-contains' | 'greater-than' | 'less-than' | 'greater-than-equals' | 'less-than-equals' — Comparison operator for the key and value
          - `value` string, required — Value to compare `key` against
        - `action` object, required — Defines the action taken in response to a line-item's selection
          - `ad_config_id` string, required — Unique alphanumeric ID of an ad config
          - `stitch_mode` 'ssai' | 'jit' | 'sgai' — Stitching mode to use for ad insertion
          - `bumpers` 'disabled' | 'start' | 'end' | 'both' — Configuration for ad bumpers
      - `config` object — Object containing the parameters used to evaluate all SSAI strategy rules
        - `weight_keys` string[] — Specifies the variables that are input into the algorithm to generate a deterministic hash

---

[API](https://skmtc.net/jwplayer/apis/management-api-v2.md) · [All operations](https://skmtc.net/jwplayer/apis/management-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/jwplayer/management-api-v2/revisions/180db7cada27/schema)