GET /v1/artifacts/{artifact_id}/export

curl -X GET -H "x-api-key: $SECAPI_API_KEY" -H "secapi-version: 2026-03-19" "https://api.secapi.ai/v1/artifacts/art_example_123/export?format=compact_json"

{
  "object": "artifact_export",
  "artifactId": "art_example_123",
  "format": "compact_json",
  "manifest": {
    "object": "artifact_manifest",
    "id": "aman_example_123",
    "artifactId": "art_example_123",
    "kind": "markdown_bundle",
    "status": "ready",
    "filename": "aapl-10-k-item-1a.md",
    "contentType": "text/markdown; charset=utf-8",
    "storageMode": "local",
    "objectKey": null,
    "byteLength": 18432,
    "lineCount": 420,
    "checksumSha1": "example_checksum",
    "filing": {
      "accessionNumber": "0000320193-25-000079",
      "form": "10-K",
      "filingUrl": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/aapl-20250927_htm.xml"
    },
    "section": {
      "key": "item_1a",
      "title": "Risk Factors"
    },
    "exportedFormats": [
      "json",
      "markdown",
      "compact_json"
    ],
    "createdAt": "2026-03-19T12:00:00.000Z"
  },
  "artifact": {
    "object": "artifact",
    "id": "art_example_123",
    "kind": "markdown_bundle",
    "status": "ready"
  }
}

Export one persisted artifact as JSON, compact JSON, or a markdown download envelope

Audience: developers choosing a structured handoff or markdown download for one persisted artifact.

Coverage and source scope

Returns the saved artifact with its manifest for json or compact_json. With format=markdown, the response is a download envelope rather than inline markdown; follow its download details. Compact JSON is intentionally reduced and may truncate large content or arrays.

Canonical metadata

artifactId
format
manifest
artifact
download

Example request

curl -X GET -H "x-api-key: $SECAPI_API_KEY" -H "secapi-version: 2026-03-19" "https://api.secapi.ai/v1/artifacts/art_example_123/export?format=compact_json"

Example response

{
  "object": "artifact_export",
  "artifactId": "art_example_123",
  "format": "compact_json",
  "manifest": {
    "object": "artifact_manifest",
    "id": "aman_example_123",
    "artifactId": "art_example_123",
    "kind": "markdown_bundle",
    "status": "ready",
    "filename": "aapl-10-k-item-1a.md",
    "contentType": "text/markdown; charset=utf-8",
    "storageMode": "local",
    "objectKey": null,
    "byteLength": 18432,
    "lineCount": 420,
    "checksumSha1": "example_checksum",
    "filing": {
      "accessionNumber": "0000320193-25-000079",
      "form": "10-K",
      "filingUrl": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/aapl-20250927_htm.xml"
    },
    "section": {
      "key": "item_1a",
      "title": "Risk Factors"
    },
    "exportedFormats": [
      "json",
      "markdown",
      "compact_json"
    ],
    "createdAt": "2026-03-19T12:00:00.000Z"
  },
  "artifact": {
    "object": "artifact",
    "id": "art_example_123",
    "kind": "markdown_bundle",
    "status": "ready"
  }
}

Format selection

Omit format or use format=json for the stored artifact object and manifest. format=markdown returns a download envelope rather than inline markdown. format=compact_json returns a reduced representation: large contentMd or content strings are truncated, snippets are shortened, and arrays are capped, so it is not a lossless archive format.

Errors

A missing, inaccessible, or failed export returns 404 artifact_export_failed.

Give this prompt to your agent

Failure posture

use full JSON or download when a workflow needs lossless saved content
label compact JSON as reduced when passing it to a reviewer
retain the manifest and artifact ID with every export

GET /v1/artifacts/{artifact_id}/download GET /v1/artifacts/{artifact_id}/manifest

​Coverage and source scope

​Canonical metadata

​Example request

​Example response

​Format selection

​Errors

​Give this prompt to your agent

​Failure posture

Coverage and source scope

Canonical metadata

Example request

Example response

Format selection

Errors

Give this prompt to your agent

Failure posture