> ## Documentation Index
> Fetch the complete documentation index at: https://www.vollna.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Activate auto-bidding setup

> Switches a setup on, so it bids on new jobs from its filter and spends Connects



## OpenAPI

````yaml post /auto-bidding/setups/{id}/activate
openapi: 3.0.4
info:
  title: Vollna API
  description: API for managing Upwork profiles, proposals, results, and filters
  version: 1.0.0
servers:
  - url: https://api.vollna.com/v1
security: []
tags:
  - name: Profiles
    description: Manage Upwork profiles
  - name: Proposals
    description: Access and manage Upwork proposals
  - name: Results
    description: View monitoring results and projects
  - name: Filters
    description: Manage monitoring filters
  - name: Auto Bidding
    description: Manage auto bidding jobs and setups
  - name: Account
    description: The token team's account, plan and meters
  - name: Invitations
    description: Upwork invitations
  - name: Projects
    description: Upwork jobs and their competition
  - name: AI Qualifier
    description: A filter's AI qualifier and its verdicts
  - name: Market Insights
    description: Upwork market analytics and saved searches
  - name: Proposal Templates
    description: Proposal templates and their results
paths:
  /auto-bidding/setups/{id}/activate:
    post:
      tags:
        - Auto Bidding
      summary: Activate auto-bidding setup
      description: >-
        Switches a setup on, so it bids on new jobs from its filter and spends
        Connects
      parameters:
        - name: id
          in: path
          required: true
          description: Setup ID
          schema:
            type: integer
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    example: done
                  setup:
                    $ref: '#/components/schemas/AutoBiddingSetupView'
        '400':
          description: The setup could not bid. message names what to fix
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServiceError'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '403':
          description: >-
            Only team owners and admins can change auto-bidding, or auto-bidding
            is not approved for the team yet
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServiceError'
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          $ref: '#/components/responses/TooManyRequests'
      security:
        - apiToken: []
components:
  schemas:
    AutoBiddingSetupView:
      type: object
      description: >-
        An auto-bidding setup in full, as the setup write endpoints return it.
        Dates are UTC
      properties:
        id:
          type: integer
        name:
          type: string
        status:
          type: string
          enum:
            - active
            - paused
            - inactive
            - draft
        archived:
          type: boolean
        priority:
          type: integer
          description: Lower bids first when two setups match the same job
        manualTriggerOnly:
          type: boolean
        filter:
          type: object
          properties:
            id:
              type: integer
            name:
              type: string
          nullable: true
        templates:
          type: array
          description: Proposal templates with their A/B weights
          items:
            type: object
            properties:
              id:
                type: integer
              name:
                type: string
                nullable: true
              weight:
                type: integer
        abTest:
          type: object
          properties:
            status:
              type: string
              enum:
                - running
                - completed
            metric:
              type: string
              enum:
                - reply_rate
                - view_rate
            winnerTemplateId:
              type: integer
              nullable: true
            startedAt:
              type: string
              format: date-time
              nullable: true
            stopAt:
              type: string
              format: date-time
              nullable: true
          nullable: true
        schedule:
          type: string
          enum:
            - 24/7
            - custom
        timezone:
          type: string
        biddingDelayMinutes:
          type: integer
        dailyProposalsLimit:
          type: integer
          nullable: true
        proposalsToday:
          type: integer
        boosting:
          type: object
          properties:
            enabled:
              type: boolean
            mode:
              type: string
              enum:
                - fixed
                - smart
            cases:
              type: array
              items:
                type: object
                properties:
                  condition:
                    type: string
                  amount:
                    type: integer
            maxBid:
              type: integer
              nullable: true
            dailyConnectsLimit:
              type: integer
              nullable: true
        qualifier:
          type: object
          properties:
            enabled:
              type: boolean
            source:
              type: string
              enum:
                - filter
                - qualifier
                - custom
              nullable: true
            id:
              type: integer
              nullable: true
            name:
              type: string
              nullable: true
        preScreening:
          type: object
          properties:
            enabled:
              type: boolean
            timeoutMinutes:
              type: integer
              nullable: true
            timeoutAction:
              type: string
              enum:
                - approve
                - skip
              nullable: true
        activationProblems:
          type: array
          description: >-
            What stops the setup from bidding if it were switched on now. Empty
            means it would bid
          items:
            type: string
        customSchedule:
          type: array
          items:
            type: object
            properties:
              day:
                type: string
              hour:
                type: integer
          nullable: true
          description: Only on a custom schedule
        catchUpBidding:
          type: boolean
        maxJobAgeHours:
          type: integer
          nullable: true
        qualifierPrompt:
          type: string
          description: Cut at 4,000 characters
          nullable: true
        qualifierModel:
          type: string
          nullable: true
        notifications:
          type: object
          properties:
            enabled:
              type: boolean
            telegramConnected:
              type: boolean
            slackChannel:
              type: string
              nullable: true
            notifyDisqualifiedJobs:
              type: boolean
        applyIfAlreadyAppliedByAnotherBidder:
          type: boolean
        roomInviteSettings:
          type: object
          description: null uses the team-wide room invite settings
          nullable: true
        totalProposalsSent:
          type: integer
        abHistory:
          type: array
          items:
            type: object
            description: >-
              A finished A/B test: status, metric, endReason, winnerTemplateId,
              startedAt, endedAt, templates and results
    ServiceError:
      type: object
      properties:
        error:
          type: string
          description: Short error title
          example: Validation failed
        message:
          type: string
          description: What went wrong and what to send instead, written for the user
        fields:
          type: object
          description: >-
            Per-field messages keyed by dot path, when several fields fail at
            once
          additionalProperties:
            type: string
    Error:
      type: object
      properties:
        error:
          type: string
  responses:
    Unauthorized:
      description: Missing or unknown API token
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    PaymentRequired:
      description: The team's subscription is not active
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    NotFound:
      description: Not found in the token's team
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ServiceError'
    TooManyRequests:
      description: More than 30 requests a minute. See Rate Limiting
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  securitySchemes:
    apiToken:
      type: apiKey
      name: X-API-TOKEN
      in: header
      description: API token for authentication

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.