---
title: "Export Object Records"
method: POST
path: "/objects/{object_slug}/exports"
tags: ["Objects"]
---

# Export Object Records

`POST /objects/{object_slug}/exports`

## Request

- Base URL: `https://be.graph8.com/api/v1`
- URL: `https://be.graph8.com/api/v1/objects/{object_slug}/exports`
- Auth: HTTP bearer

Download every matching native custom record of a view (filters, search, sort, columns, archived scope) as CSV or
typed JSON. Explicit objects:read and objects:export scopes and the key's read grant are required and rechecked before
delivery. Maximum 256 MB and 120 seconds; no partial files. CSV is spreadsheet-safe. Not a workspace backup.

## Path parameters

- `object_slug` string, required

## Headers

- `Authorization` string, nullable
- `X-Target-Org-Id` string, nullable

## Request body

- ObjectExportRequest
  - `format` 'csv' | 'json'
  - `state` ObjectViewState
    - `version` 1
    - `layout` 'table' | 'board'
    - `filters` RecordFilter[]
      - `attribute_slug` string, required
      - `operator` 'eq' | 'ne' | 'gt' | 'gte' | 'lt' | 'lte' | 'contains' | 'starts_with' | 'in' | 'is_null' | 'is_not_null', required
      - `value` unknown
    - `search` string
    - `sortBy` string, nullable
    - `sortOrder` 'asc' | 'desc'
    - `includeArchived` boolean
    - `columns` string[], nullable
    - `groupBy` string, nullable

## Response `200`

Complete CSV or JSON file, never a paginated JSON API envelope

- string, binary

## Other responses

- `422`: Validation Error

---

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