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

# Refresh Project Widgets

> Re-fetch DATA widgets on the project with their current config and the project date range. Optional `datasource_id` body scopes the refresh to widgets fed by that one source (direct + dependent goals / calc-metrics). Fire-and-forget — results broadcast via Realtime.



## OpenAPI

````yaml https://api.oviond.com/openapi.json post /v1/projects/{id}/refresh
openapi: 3.1.0
info:
  title: Oviond Backend API
  version: 1.0.0
  description: Authentication, account management, billing, and media services for Oviond.
  x-logo:
    url: https://app.oviond.com/img/oviond-full-logo.svg
    altText: Oviond
servers:
  - url: https://api.oviond.com
    description: Production
security:
  - ApiKeyAuth: []
  - BearerAuth: []
paths:
  /v1/projects/{id}/refresh:
    post:
      tags:
        - Projects
      summary: Refresh Project Widgets
      description: >-
        Re-fetch DATA widgets on the project with their current config and the
        project date range. Optional `datasource_id` body scopes the refresh to
        widgets fed by that one source (direct + dependent goals /
        calc-metrics). Fire-and-forget — results broadcast via Realtime.
      operationId: refresh_project_widgets
      parameters:
        - schema:
            type: string
          required: true
          name: id
          in: path
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties:
                datasource_id:
                  type: string
                  enum:
                    - advanced-web-ranking
                    - ac
                    - adroll
                    - ahrefs
                    - basecamp
                    - brightlocal
                    - call-rail
                    - drip
                    - keywords
                    - sendin-blue
                    - sendgrid
                    - moosend
                    - mailer-lite
                    - pingdom
                    - uptime-robot
                    - piwik-pro
                    - wordpress
                    - pabbly-connect
                    - ment
                    - twilio
                    - switchy
                    - vimeo
                    - pinterest
                    - pinterest-ads
                    - gtres
                    - paypal
                    - gps
                    - gs
                    - CUSTOM_IMPORT
                    - CUSTOM_DATA
                    - CALCULATION
                    - GOALS
                    - str
                    - wistia
                    - ca-mon
                    - convertkit
                    - woocommerce
                    - xero
                    - matomo
                    - go-high-level
                    - wcs
                    - bing-webmaster-tools
                    - pipedrive
                    - salesforce
                    - tiktok
                    - tiktok-ads
                    - twr
                    - twr-ads
                    - spf
                    - ytbe
                    - google-local-services-ads
                    - klaviyo
                    - gsh
                    - ga4
                    - lkdin-ads
                    - lkdin-pg
                    - mlchmp
                    - inst-ads
                    - inst
                    - fb-ads
                    - fb-pg
                    - gmb
                    - serpstat
                    - hubspot
                    - gadw
                    - sem-rush
                    - se-ranking
                    - microsoft-ads
                    - plausible
                    - snapchat-ads
                    - amazon-advertising
                    - microsoft-clarity
                    - serp-watch
                    - vbout
                    - moz
                    - chatgpt-ads
              additionalProperties: false
            example:
              datasource_id: gadw
      responses:
        '202':
          description: Refresh queued
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    enum:
                      - true
                  data:
                    type: object
                    properties:
                      accepted:
                        type: boolean
                        enum:
                          - true
                    required:
                      - accepted
                required:
                  - success
                  - data
        '404':
          description: Project not found
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error
components:
  securitySchemes:
    ApiKeyAuth:
      type: http
      scheme: bearer
      description: >-
        Oviond API key (prefix `oviond_`) sent as a Bearer token — the
        credential for REST/programmatic and headless integrations. Manage keys
        in Settings → API Keys. API keys do NOT authenticate the MCP endpoint
        (/mcp), which uses OAuth 2.1 + PKCE.
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        Supabase-issued JWT used by the Oviond web app session. External API
        consumers should authenticate with an Oviond API key (ApiKeyAuth)
        instead.

````