Skip to main content
POST
Extract Agent
Build a chart-ready dataset from unstructured text, images, PDFs, or Excel spreadsheets. Returns a GraphConfig with the extracted data via Server-Sent Events.

Request body

Provide sourceText, attachments, or both — at least one is required. Each attachment is { kind: "image" | "document" | "spreadsheet", mimeType, dataBase64 }, where dataBase64 is RFC 4648 standard base64 (not a data: URL). Limits: 8 images (2 MB each), 2 PDFs (6 MB each), 2 spreadsheets (6 MB each); 12 attachments and 12 MB combined. The legacy images array is deprecated — use attachments with kind: "image". images and attachments cannot be combined.

Response

The response is a Server-Sent Events stream. See SSE Format for parsing details.
Final response data:

HTTP Status Codes

Errors may also arrive as SSE events within a 200 response. See Error Codes.

Authorizations

Authorization
string
header
required

Your Graphy API key (starts with graphy_). Create one in the Graphy console at https://agents.graphy.dev/console/

Body

application/json

Provide sourceText, attachments, or both — at least one is required. images and attachments are mutually exclusive.

sourceText
string

Raw text to extract data from

Maximum string length: 500000
attachments
object[]

Images (max 8), PDFs (max 2), and spreadsheets (max 2). Preferred over images[].

Maximum array length: 12
images
object[]

Deprecated — use attachments with kind "image".

Maximum array length: 8
metadata
object

Optional tracking information for requests

Response

SSE stream with progress and completion events

SSE event name is "progress"

message
string