---
title: "Export profile distribution"
method: POST
path: "/v1/commands/export_profile_distribution"
tags: ["Reports and exports"]
---

# Export profile distribution

`POST /v1/commands/export_profile_distribution`

## Request

- Base URL: `https://app.agentlinkops.com`
- URL: `https://app.agentlinkops.com/v1/commands/export_profile_distribution`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Shared command transport. All logical arguments in JSON; no query or Idempotency-Key header. See canonical operation reference.

## Headers

- `X-Workspace-ID` string

## Request body

- ExportProfileDistributionInput
  - `projectId` string, required: project ID from create/list.
  - `status` 'all' | 'active' | 'paused': Lifecycle status, separate from observed state.
  - `limit` integer: Page/report row cap; see bounds.
  - `comparison` object: comparison; see schema.
    - `setId` string, required
    - `revision` integer, required
    - `inventoryIds` string[], required
  - `indexSourceKey` string: index source key; see schema.
  - `dimension` 'source_host' | 'source_tld' | 'watch_created_month' | 'anchor' | 'anchor_term' | 'landing_url' | 'rel_set' | 'link_nofollow' | 'ugc' | 'sponsored' | 'page_nofollow' | 'link_type' | 'language' | 'google_index', required: dimension; see schema.
  - `format` 'json' | 'csv', required: format; see schema.

## Response `200`

Command result, including queued admission.

- ExportProfileDistributionOutput
  - `filename` string, required
  - `content_type` string, required
  - `text` string, required
  - `dimension` string, required
  - `report` object, required
    - `monitored` object, required
      - `schema_version` 1, required
      - `workspace_id` string, required: Workspace that owns this record.
      - `project_id` string, required: Project that owns this record.
      - `generated_at` string, required
      - `status_filter` 'all' | 'active' | 'paused', required
      - `coverage` object, required: Dataset scope and completeness, including limits on what these results establish.
        - `basis` 'latest_retained_attempt_per_watch', required
        - `whole_web_coverage` false, required: False: these results do not measure the whole web.
        - `total_watches` integer, required
        - `scanned_watches` integer, required
        - `eligible_present_watches` integer, required
        - `included_present_watches` integer, required
        - `excluded_evidence_watches` integer, required
        - `occurrences` integer, required
        - `scanned_bytes` integer, required
        - `partial` boolean, required
        - `limitations` string[], required
        - `overlapping_watches_deduplicated` false, required
      - `distributions` object, required
      - `notes` string[], required
    - `comparison` object, nullable, required
      - `set_id` string, required
      - `revision` integer, required: Optimistic concurrency revision; supply it as expectedRevision on the next write.
      - `whole_web_coverage` false, required: False: these results do not measure the whole web.
      - `absence_claim` 'not_supported', required: not_supported: missing dataset rows cannot prove link absence.
      - `pooled` false, required
      - `datasets` object[], required
        - `inventory_id` string, required
        - `member_id` string, required
        - `member_target` string, required
        - `provider` string, required
        - `data_mode` string, required
        - `captured_at` string, required
        - `member_role` 'customer' | 'competitor', required
        - `retrieved_from` string, nullable, required
        - `retrieved_to` string, nullable, required
        - `coverage` string, required: Dataset scope and completeness, including limits on what these results establish.
        - `row_count` integer, required
        - `basis` 'frozen_inventory_rows', required
        - `distributions` object, required
      - `notes` string[], required
    - `index` object, nullable, required
      - `source_key` string, required
      - `basis` 'latest_retained_receipt_per_watch_for_source', required
      - `total_watches` integer, required
      - `scanned_watches` integer, required
      - `partial` boolean, required
      - `expired_watches` integer, required
      - `missing_watches` integer, required
      - `distribution` object, required
        - `unit` 'watches' | 'occurrences' | 'anchor_terms' | 'inventory_rows', required
        - `denominator` integer, required
        - `known_count` integer, required
        - `unknown_count` integer, required
        - `unknown_share` number, nullable, required
        - `items` object[], required: Records in this bounded page.
          - `value` string, nullable, required
          - `count` integer, required
          - `share` number, required
        - `other_count` integer, required
        - `truncated` boolean, required
      - `notes` string[], required

## Other responses

- `429`: Request-rate or usage refusal. Inspect error.code and recovery details before retrying.
- `default`: Error envelope. Non-configuration 5xx messages are masked and details omitted; allowlisted configuration errors retain static operator recovery.

---

[API](https://skmtc.dev/agentlinkops/apis/agentlinkops-http-api.md) · [All operations](https://skmtc.dev/agentlinkops/apis/agentlinkops-http-api/llms.txt) · [OpenAPI document](https://skmtc.dev/agentlinkops/apis/agentlinkops-http-api/revisions/2a712a1dcfa7?raw)