{
  "opencollection": "1.0.0",
  "info": {
    "name": "Campaigns Ad Servers Concepts API",
    "version": "3.0.1807"
  },
  "request": {
    "auth": {
      "type": "oauth2",
      "flow": "authorization_code",
      "authorizationUrl": "https://auth.mediamath.com/authorize",
      "accessTokenUrl": "https://auth.mediamath.com/oauth/token",
      "credentials": {
        "clientId": "{{clientId}}",
        "clientSecret": "{{clientSecret}}"
      }
    }
  },
  "items": [
    {
      "info": {
        "name": "Concepts",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "List Concepts",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.mediamath.com/api/v3.0/concepts",
            "params": [
              {
                "name": "page_limit",
                "value": "",
                "type": "query",
                "description": "Number of elements in the collection to retrieve"
              },
              {
                "name": "page_offset",
                "value": "",
                "type": "query",
                "description": "Index of the first element in the collection to retrieve"
              },
              {
                "name": "sort_by",
                "value": "",
                "type": "query",
                "description": "The field to sort by. You can use any field name in ascending or descending order.\nFor ascending order, use the field name directly, e.g., `id`. \nFor descending order, prefix the field name with a hyphen (`-`), e.g., `-id`.\n"
              },
              {
                "name": "q",
                "value": "",
                "type": "query",
                "description": "Query search for filtering. This parameter can be used to filter results based on various fields.\nSupported operators:\n- `==` - numeric equality or case-sensitive string identity, \n- `==(1,2,3)` - IN query (only works for integers),\n- `!=` - numeric inequality or case-sensitive string non-identity,\n- `=:` - case-insensitive match, allows substring using * wildcards,\n- `<` - less than,\n- `<=` - less than or equal to,\n- `>` - greater than,\n- `>=` - greater than or equal to.\nExamples: \n- `q=name=:{search}*` to find all results with names starting with {search}.\n- `q=status==true` to find all active entities.\n- `q=id>=1000` to find all entities with id greater than or equal to 1000.\n- `q=id==(1,2,3)` to find specific entities by ID.\n- `q=created_on>1999-02-02` or `q=created_on>1999-02-02T00:00:00Z` to find entities created later than date.\n- `q=id>5&status==true` to find all active entities with id greater than 5.\n"
              },
              {
                "name": "full",
                "value": "",
                "type": "query",
                "description": "To return all fields, set the value to `*`. For example, `full=*` will include all properties.\n"
              },
              {
                "name": "media_type",
                "value": "",
                "type": "query",
                "description": "Optional filter by media type. If provided only concepts with at least one atomic creative with requested type will be returned.\nCan be used with one or several types: 'audio', 'display', 'native', 'video'. \nIf filter have several types, they will be applied using OR logic.\n"
              }
            ]
          },
          "docs": "Get a list of concepts. Concepts can be sorted by fields:\n- `id`,\n- `version`,\n- `advertiser_id`,\n- `name`,\n- `status`,\n- `archived`,\n- `created_on`,\n- `updated_on`,\n- `advertiser_name`\nand queried by fields:\n- `id`,\n- `version`,\n- `advertiser_id`,\n- `name`,\n- `status`,\n- `archived`,\n- `created_on`,\n- `updated_on`,\n- `advertiser_name`,\n- `organization_id`,\n- `agency_id`.\n"
        },
        {
          "info": {
            "name": "Create a Concept",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://api.mediamath.com/api/v3.0/concepts",
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Create a concept"
        },
        {
          "info": {
            "name": "Get a Concept",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.mediamath.com/api/v3.0/concepts/:concept_id",
            "params": [
              {
                "name": "concept_id",
                "value": "",
                "type": "path",
                "description": "Numeric ID of the concept to get"
              }
            ]
          },
          "docs": "Get a concept by ID"
        },
        {
          "info": {
            "name": "Update a Concept",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://api.mediamath.com/api/v3.0/concepts/:concept_id",
            "params": [
              {
                "name": "concept_id",
                "value": "",
                "type": "path",
                "description": "Numeric ID of the concept to update"
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Update a concept by ID"
        },
        {
          "info": {
            "name": "Concepts Audit Log",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.mediamath.com/api/v3.0/concepts/:concept_id/history",
            "params": [
              {
                "name": "page_limit",
                "value": "",
                "type": "query",
                "description": "Number of elements in the collection to retrieve"
              },
              {
                "name": "page_offset",
                "value": "",
                "type": "query",
                "description": "Index of the first element in the collection to retrieve"
              },
              {
                "name": "concept_id",
                "value": "",
                "type": "path",
                "description": "Numeric ID of the concept"
              }
            ]
          },
          "docs": "Get a list changes to this concept"
        },
        {
          "info": {
            "name": "Bulk Update Concepts",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://api.mediamath.com/api/v3.0/bulk_update/concepts",
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Update multiple concepts"
        }
      ]
    }
  ],
  "bundled": true
}