Get Asset Topics

curl --request GET \
  --url https://mm-midmarket-integrations-api-preview.azurewebsites.net/api/integrations/submissions/{submission_id}/assets/{asset_id}/topics \
  --header 'X-API-Key: <api-key>'

{
  "assetId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "topics": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "assetId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "topicType": "<string>",
      "title": "<string>",
      "issueCount": 123,
      "summary": {
        "totalIssues": 123,
        "criticalIssues": 123,
        "resolvedIssues": 123,
        "openIssues": 123,
        "text": "<string>"
      },
      "issues": [
        {
          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "assetId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "summary": "<string>",
          "severity": "<string>",
          "status": "<string>",
          "createdAt": "2023-11-07T05:31:56Z",
          "updatedAt": "2023-11-07T05:31:56Z",
          "referenceNumber": 123,
          "ruleId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "ruleCode": "<string>",
          "details": "<string>",
          "severityReasoning": "<string>",
          "severityReasoningHeadline": "<string>",
          "precedents": [
            {
              "url": "<string>",
              "title": "<string>",
              "decision": "<string>",
              "date": "<string>"
            }
          ],
          "contributors": [
            {
              "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
              "label": "<string>",
              "reasoning": "<string>",
              "confidence": 0.5,
              "relationType": "<string>",
              "evidence": [
                {
                  "id": "<string>",
                  "sourceType": "<string>",
                  "confidence": 0.5,
                  "content": "<unknown>",
                  "anchor": {}
                }
              ],
              "resolutionRequirement": {}
            }
          ],
          "resolutionRequirement": {},
          "anchor": {}
        }
      ],
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z",
      "anchor": {}
    }
  ],
  "orphanIssues": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "assetId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "summary": "<string>",
      "severity": "<string>",
      "status": "<string>",
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z",
      "referenceNumber": 123,
      "ruleId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "ruleCode": "<string>",
      "details": "<string>",
      "severityReasoning": "<string>",
      "severityReasoningHeadline": "<string>",
      "precedents": [
        {
          "url": "<string>",
          "title": "<string>",
          "decision": "<string>",
          "date": "<string>"
        }
      ],
      "contributors": [
        {
          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "label": "<string>",
          "reasoning": "<string>",
          "confidence": 0.5,
          "relationType": "<string>",
          "evidence": [
            {
              "id": "<string>",
              "sourceType": "<string>",
              "confidence": 0.5,
              "content": "<unknown>",
              "anchor": {}
            }
          ],
          "resolutionRequirement": {}
        }
      ],
      "resolutionRequirement": {},
      "anchor": {}
    }
  ],
  "metadata": {
    "totalTopics": 123,
    "orphanIssueCount": 123
  }
}

API Endpoints

Get Asset Topics

Get AI-clustered topics for a single asset.

Each topic groups related issues — root-cause clusters from the LLM, or issues sharing a physical anchor. orphanIssues are issues not in any topic — expected, not an error: the semantic clusterer only emits topics with at least two related issues.

Authentication: Requires X-API-Key header with valid API key.

Raises: 404: If the asset is not found, belongs to a different submission, or the submission is not in the authenticated workspace. 404: If the asset has not finished processing yet (handled globally via AssetProcessingPendingError). 502: If the topics or issues blob can’t be downloaded or parsed (handled globally via BlobLoadError).

GET

api

integrations

submissions

{submission_id}

assets

{asset_id}

topics

Get Asset Topics

curl --request GET \
  --url https://mm-midmarket-integrations-api-preview.azurewebsites.net/api/integrations/submissions/{submission_id}/assets/{asset_id}/topics \
  --header 'X-API-Key: <api-key>'

{
  "assetId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "topics": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "assetId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "topicType": "<string>",
      "title": "<string>",
      "issueCount": 123,
      "summary": {
        "totalIssues": 123,
        "criticalIssues": 123,
        "resolvedIssues": 123,
        "openIssues": 123,
        "text": "<string>"
      },
      "issues": [
        {
          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "assetId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "summary": "<string>",
          "severity": "<string>",
          "status": "<string>",
          "createdAt": "2023-11-07T05:31:56Z",
          "updatedAt": "2023-11-07T05:31:56Z",
          "referenceNumber": 123,
          "ruleId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "ruleCode": "<string>",
          "details": "<string>",
          "severityReasoning": "<string>",
          "severityReasoningHeadline": "<string>",
          "precedents": [
            {
              "url": "<string>",
              "title": "<string>",
              "decision": "<string>",
              "date": "<string>"
            }
          ],
          "contributors": [
            {
              "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
              "label": "<string>",
              "reasoning": "<string>",
              "confidence": 0.5,
              "relationType": "<string>",
              "evidence": [
                {
                  "id": "<string>",
                  "sourceType": "<string>",
                  "confidence": 0.5,
                  "content": "<unknown>",
                  "anchor": {}
                }
              ],
              "resolutionRequirement": {}
            }
          ],
          "resolutionRequirement": {},
          "anchor": {}
        }
      ],
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z",
      "anchor": {}
    }
  ],
  "orphanIssues": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "assetId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "summary": "<string>",
      "severity": "<string>",
      "status": "<string>",
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z",
      "referenceNumber": 123,
      "ruleId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "ruleCode": "<string>",
      "details": "<string>",
      "severityReasoning": "<string>",
      "severityReasoningHeadline": "<string>",
      "precedents": [
        {
          "url": "<string>",
          "title": "<string>",
          "decision": "<string>",
          "date": "<string>"
        }
      ],
      "contributors": [
        {
          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "label": "<string>",
          "reasoning": "<string>",
          "confidence": 0.5,
          "relationType": "<string>",
          "evidence": [
            {
              "id": "<string>",
              "sourceType": "<string>",
              "confidence": 0.5,
              "content": "<unknown>",
              "anchor": {}
            }
          ],
          "resolutionRequirement": {}
        }
      ],
      "resolutionRequirement": {},
      "anchor": {}
    }
  ],
  "metadata": {
    "totalTopics": 123,
    "orphanIssueCount": 123
  }
}

Authorizations

X-API-Key

string

header

default:sk_live_your_api_key_here

required

Workspace-scoped API key. Format: sk_live_{64 hex chars}

Path Parameters

submission_id

string<uuid>

required

asset_id

string<uuid>

required

Response

Successful Response

Per-asset topics with embedded issues and a flat list of orphan issues.

Orphan issues are not an error: the semantic clusterer only emits topics with ≥2 issues, so a unique issue with no semantic neighbour stays unclustered.

assetId

string<uuid>

required

Asset ID

topics

TopicSchema · object[]

required

Topics with embedded issues

Show child attributes

orphanIssues

EnrichedIssueSchema · object[]

required

Issues not referenced by any topic

Show child attributes

metadata

AssetTopicsMetadata · object

required

Counts

Show child attributes

Get Asset Result Get Asset Issues

⌘I