{
  "opencollection": "1.0.0",
  "info": {
    "name": "Dust Agents Workspace API",
    "version": "1.0.2"
  },
  "items": [
    {
      "info": {
        "name": "Workspace",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "Export Workspace Analytics",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://dust.tt/api/v1/w/:wId/analytics/export",
            "params": [
              {
                "name": "wId",
                "value": "",
                "type": "path",
                "description": "Unique string identifier for the workspace"
              },
              {
                "name": "table",
                "value": "",
                "type": "query",
                "description": "The analytics table to export:\n- \"usage_metrics\": Messages, conversations, and active users over time.\n- \"active_users\": Daily, weekly, and monthly active user counts.\n- \"source\": Message volume by context origin (web, slack, etc.).\n- \"agents\": Top agents by message count.\n- \"users\": Top users by message count.\n- \"skill_usage\": Skill executions and unique users over time.\n- \"tool_usage\": Tool executions and unique users over time.\n- \"messages\": Detailed message-level logs.\n"
              },
              {
                "name": "startDate",
                "value": "",
                "type": "query",
                "description": "Start date in YYYY-MM-DD format"
              },
              {
                "name": "endDate",
                "value": "",
                "type": "query",
                "description": "End date in YYYY-MM-DD format"
              },
              {
                "name": "timezone",
                "value": "",
                "type": "query",
                "description": "IANA timezone name (defaults to UTC)"
              },
              {
                "name": "format",
                "value": "",
                "type": "query",
                "description": "Output format (defaults to csv)"
              }
            ],
            "auth": {
              "type": "bearer",
              "token": "{{bearerToken}}"
            }
          },
          "docs": "Export analytics data for the workspace identified by {wId} in CSV or JSON format."
        },
        {
          "info": {
            "name": "Get Workspace Usage Data",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://dust.tt/api/v1/w/:wId/workspace-usage",
            "params": [
              {
                "name": "wId",
                "value": "",
                "type": "path",
                "description": "Unique string identifier for the workspace"
              },
              {
                "name": "start",
                "value": "",
                "type": "query",
                "description": "The start date in YYYY-MM or YYYY-MM-DD format"
              },
              {
                "name": "end",
                "value": "",
                "type": "query",
                "description": "The end date in YYYY-MM or YYYY-MM-DD format (required when mode is 'range')"
              },
              {
                "name": "mode",
                "value": "",
                "type": "query",
                "description": "The mode of date range selection"
              },
              {
                "name": "format",
                "value": "",
                "type": "query",
                "description": "The output format of the data (defaults to 'csv')"
              },
              {
                "name": "table",
                "value": "",
                "type": "query",
                "description": "The name of the usage table to retrieve:\n- \"users\": The list of users categorized by their activity level.\n- \"assistant_messages\": The list of messages sent by users including the mentioned agents.\n- \"builders\": The list of builders categorized by their activity level.\n- \"assistants\": The list of workspace agents and their corresponding usage.\n- \"feedback\": The list of feedback given by users on the agent messages.\n- \"all\": A concatenation of all the above tables.\n"
              },
              {
                "name": "includeInactive",
                "value": "",
                "type": "query",
                "description": "Include users and assistants with zero messages in the export (defaults to false)"
              }
            ],
            "auth": {
              "type": "bearer",
              "token": "{{bearerToken}}"
            }
          },
          "docs": "Deprecated: this endpoint will be removed after 2026-06-01.\nUse GET /api/v1/w/{wId}/analytics/export instead.\n\nGet usage data for the workspace identified by {wId} in CSV or JSON format.\n"
        }
      ]
    }
  ],
  "bundled": true
}