post:
  operationId: startCampaign
  tags:
    - Certification Campaigns
  summary: Activate a Campaign
  description: >-
    Submits a job to activate the campaign with the given Id. The campaign must be staged.

    Requires roles of CERT_ADMIN and ORG_ADMIN
  security:
    - oauth2: [idn:campaign:update]
  requestBody:
    description:
      Optional. If no timezone is specified, the standard UTC timezone is used (i.e. UTC+00:00).
      Although this can take any timezone, the intended value is the caller's timezone. The activation time
      calculated from the given timezone may cause the campaign deadline time to be modified, but it will remain
      within the original date. The timezone must be in a valid ISO 8601 format.
    required: false
    content:
      application/json:
        schema:
          $ref: '../schemas/ActivateCampaignOptions.yaml'
  parameters:
    - in: path
      name: id
      schema:
        type: string
      required: true
      description: The campaign id
      example: ef38f94347e94562b5bb8424a56397d8
  responses:
    '202':
      $ref: '../responses/202.yaml'
    '400':
      $ref: '../responses/400.yaml'
    '401':
      $ref: '../responses/401.yaml'
    '403':
      $ref: '../responses/403.yaml'
    '404':
      $ref: '../responses/404.yaml'
    '429':
      $ref: '../responses/429.yaml'
    '500':
      $ref: '../responses/500.yaml'