Skip to main content
POST
cURL
Knowledge Graphs deployed to a specific team aren’t accessible via the API or SDK. To use a Knowledge Graph via the API or SDK, configure it with “All Teams” access in AI Studio.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your Writer API key.

Path Parameters

graph_id
string<uuid>
required

The unique identifier of the Knowledge Graph.

Body

application/json
file_id
string
required

The unique identifier of the file.

Response

200 - application/json
id
string
required

A unique identifier of the file.

created_at
string<date-time>
required

The timestamp when the file was uploaded.

name
string
required

The name of the file.

graph_ids
string<uuid>[]
required

A list of Knowledge Graph IDs that the file is associated with.

If you provided a graphId during upload, the file is associated with that Knowledge Graph. However, the graph_ids field in the upload response is an empty list. The association will be visible in the graph_ids list when you retrieve the file using the file retrieval endpoint.

status
string
required

The processing status of the file.