Duplicate board | Sarvam API Docs

import requests
url = "https://apps.sarvam.ai/api/analytics/v1/org_id/workspace_id/boards/0b7f2c9a-5e41-4d2a-9f3b-8c1d6e7a0b52/duplicate"
payload = {
    "name": "Campaign Overview (Q4)",
    "tag": "Quarterly reporting"
}
headers = {
    "X-API-Key": "<your-api-key>",
    "Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())

{
  "id": "5c2e9f14-8a3b-4d70-b6e1-0f9d4a7c2e83",
  "name": "Campaign Overview (Q4)",
  "created_by": {
    "type": "api_key",
    "id": "sk_live_a1b2c3"
  },
  "created_at": "2026-09-15T06:02:47Z",
  "updated_by": {
    "type": "api_key",
    "id": "sk_live_a1b2c3"
  },
  "updated_at": "2026-09-15T06:02:47Z",
  "tabs": [
    {
      "id": "b2d8f0a6-4e17-4c93-a5b1-7d2e6f9c0a34",
      "name": "Connectivity",
      "position": 0,
      "widgets": [
        {
          "id": "d6a1c3e8-9f42-4b05-8e7d-2a4c6b1f3e90",
          "board_id": "5c2e9f14-8a3b-4d70-b6e1-0f9d4a7c2e83",
          "name": "Daily connected calls",
          "sql": "SELECT\n  toDate(effective_datetime) AS day,\n  countIf(v2v_connectivity_status = 'connected') AS connected,\n  count() AS total\nFROM EngagementFactsBoardsView\nWHERE effective_datetime >= {{start_date}}\n  [[AND app_id = {{agent_id}}]]\nGROUP BY day\nORDER BY day",
          "viz_type": "line",
          "viz_config": {
            "x_axis": "day",
            "y_axis": [
              "connected",
              "total"
            ]
          },
          "created_by": {
            "type": "api_key",
            "id": "sk_live_a1b2c3"
          },
          "created_at": "2026-09-15T06:02:47Z",
          "updated_by": {
            "type": "api_key",
            "id": "sk_live_a1b2c3"
          },
          "updated_at": "2026-09-15T06:02:47Z"
        },
        {
          "id": "08e5b7d2-6c19-4fa3-b8d0-5e1a9c7f2b64",
          "board_id": "5c2e9f14-8a3b-4d70-b6e1-0f9d4a7c2e83",
          "name": "Calls by language",
          "sql": "SELECT language_name, count() AS calls\nFROM EngagementFactsBoardsView\nWHERE effective_datetime >= {{start_date}}\nGROUP BY language_name\nORDER BY calls DESC",
          "viz_type": "bar",
          "viz_config": {
            "x_axis": "language_name",
            "y_axis": [
              "calls"
            ]
          },
          "created_by": {
            "type": "api_key",
            "id": "sk_live_a1b2c3"
          },
          "created_at": "2026-09-15T06:02:47Z",
          "updated_by": {
            "type": "api_key",
            "id": "sk_live_a1b2c3"
          },
          "updated_at": "2026-09-15T06:02:47Z"
        }
      ]
    }
  ],
  "filters": [
    {
      "id": "c4f7a2e9-3b58-4d16-9a0c-8e2b5d7f1a43",
      "internal_name": "start_date",
      "display_label": "Start date",
      "filter_type": "date",
      "is_required": true,
      "default_value": "2026-09-01T00:00:00+05:30",
      "dropdown_options": null
    },
    {
      "id": "61b9d4f3-7a2e-4c85-b0d6-3f8e1a5c9d27",
      "internal_name": "agent_id",
      "display_label": "Agent",
      "filter_type": "string",
      "is_required": false,
      "default_value": null,
      "dropdown_options": null
    }
  ],
  "tag": "Quarterly reporting"
}

Deep-copies the board, with new IDs for the board and everything on it, and returns the copy in full, in the same shape as a board read. The copy is named <source name> (copy) and inherits the source’s tag unless you send name or tag.

Path parameters

org_idstringRequired

Organization ID

workspace_idstringRequired

Workspace ID

board_idstringRequiredformat: "uuid"

Board ID, as returned in id by Create board or List boards. Must be a UUID; anything else is rejected with 422.

Request

This endpoint expects a nullable object.

namestring or nullOptional4-80 characters

Name for the copy, 4 to 80 characters. Defaults to <source name> (copy).

tagstring or nullOptional4-80 characters

Tag for the copy, 4 to 80 characters. Omit to inherit the source board’s tag; send null to leave the copy untagged.

Response

Successful Response

idstringformat: "uuid"

Board identifier, used as {board_id} in every nested route

namestring

Board display name

created_byobject

Actor that created the board

created_atdatetime

Creation time, UTC, RFC 3339

updated_byobject

Actor that last changed the board or anything on it

updated_atdatetime

Last change time, UTC, RFC 3339

tabslist of objects

The board's tabs in position order, each with its widgets nested

filterslist of objects

Every filter token declared by this board's widgets, in display order

tagstring or nullOptional

The board's grouping tag, or null when untagged

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

422

Unprocessable Entity Error

429

Too Many Requests Error

500

Internal Server Error

Path parameters

Headers

Request

Response

Errors