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

# Send the campaign's brief to its eligible sellers



## OpenAPI

````yaml /openapi/buyer.yaml post /api/v2/buyer/campaigns/{id}/request-proposals
openapi: 3.1.0
info:
  title: Semicola Exchange buyer API
  version: 2.0.0
  description: >-
    Buyer endpoints: advertisers, storefronts and connections, product
    discovery, campaigns, proposals, media buys, creatives and reporting. Every
    write accepts an Idempotency-Key header.
servers:
  - url: https://api.semicola.com
security:
  - bearerAuth: []
  - sessionCookie: []
tags:
  - name: Advertisers
  - name: Storefronts
  - name: Product Discovery
  - name: Campaigns
  - name: Media Buys
  - name: Creatives
  - name: Reporting
  - name: Event Sources
  - name: Webhooks
  - name: Tasks
  - name: Audit Logs
paths:
  /api/v2/buyer/campaigns/{id}/request-proposals:
    post:
      tags:
        - Product Discovery
      summary: Send the campaign's brief to its eligible sellers
      operationId: postBuyerCampaignsByIdRequestProposals
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
            minLength: 1
        - name: Idempotency-Key
          in: header
          required: false
          schema:
            type: string
            minLength: 16
            maxLength: 255
            pattern: ^[A-Za-z0-9_.:-]+$
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    anyOf:
                      - type: object
                        properties:
                          executionId:
                            type: string
                          campaignId:
                            type: string
                          status:
                            type: string
                            enum:
                              - running
                              - complete
                              - partial
                              - failed
                          perSeller:
                            type: array
                            items:
                              type: object
                              properties:
                                sellerId:
                                  type: integer
                                  exclusiveMinimum: 0
                                  maximum: 9007199254740991
                                sellerName:
                                  type: string
                                status:
                                  type: string
                                  enum:
                                    - pending
                                    - quoted
                                    - products
                                    - failed
                                    - timeout
                                proposalIds:
                                  type: array
                                  items:
                                    type: string
                                productQueryId:
                                  type:
                                    - string
                                    - 'null'
                                error:
                                  type:
                                    - string
                                    - 'null'
                              required:
                                - sellerId
                                - sellerName
                                - status
                                - proposalIds
                                - productQueryId
                                - error
                              additionalProperties: false
                          summary:
                            type: object
                            properties:
                              sellersRequested:
                                type: integer
                                minimum: 0
                                maximum: 9007199254740991
                              sellersResponded:
                                type: integer
                                minimum: 0
                                maximum: 9007199254740991
                              sellersQuoted:
                                type: integer
                                minimum: 0
                                maximum: 9007199254740991
                              sellersWithProducts:
                                type: integer
                                minimum: 0
                                maximum: 9007199254740991
                              sellersPending:
                                type: integer
                                minimum: 0
                                maximum: 9007199254740991
                              sellersFailed:
                                type: integer
                                minimum: 0
                                maximum: 9007199254740991
                            required:
                              - sellersRequested
                              - sellersResponded
                              - sellersQuoted
                              - sellersWithProducts
                              - sellersPending
                              - sellersFailed
                            additionalProperties: false
                          page:
                            type: object
                            properties:
                              returned:
                                type: integer
                                minimum: 0
                                maximum: 9007199254740991
                              total:
                                type: integer
                                minimum: 0
                                maximum: 9007199254740991
                              hasMore:
                                type: boolean
                              nextCursor:
                                type:
                                  - string
                                  - 'null'
                            required:
                              - returned
                              - total
                              - hasMore
                              - nextCursor
                            additionalProperties: false
                        required:
                          - executionId
                          - campaignId
                          - status
                          - perSeller
                          - summary
                          - page
                        additionalProperties: false
                      - type: 'null'
                  error:
                    anyOf:
                      - type: object
                        properties:
                          code:
                            type: string
                          message:
                            type: string
                          field:
                            type: string
                          details: {}
                        required:
                          - code
                          - message
                        additionalProperties: false
                      - type: 'null'
                required:
                  - data
                  - error
                additionalProperties: false
        default:
          description: >-
            Error envelope `{data: null, error: {code, message, field?,
            details?}}`.
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: API key or OAuth access token.
    sessionCookie:
      type: apiKey
      in: cookie
      name: sc_session

````