Files
List files
Files this workspace uploaded, newest first, one page at a time.
curl -X GET "https://api.pre.dev/v1/files"fetch("https://api.pre.dev/v1/files", { method: "GET"})package mainimport ( "fmt" "net/http" "io/ioutil")func main() { url := "https://api.pre.dev/v1/files" req, _ := http.NewRequest("GET", url, nil) res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := ioutil.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body))}import requestsurl = "https://api.pre.dev/v1/files"response = requests.request("GET", url)print(response.text)import java.net.URI;import java.net.http.HttpClient;import java.net.http.HttpRequest;import java.net.http.HttpResponse;import java.net.http.HttpResponse.BodyHandlers;import java.time.Duration;HttpClient client = HttpClient.newBuilder() .connectTimeout(Duration.ofSeconds(10)) .build();HttpRequest.Builder requestBuilder = HttpRequest.newBuilder() .uri(URI.create("https://api.pre.dev/v1/files")) .GET() .build();try { HttpResponse<String> response = client.send(requestBuilder.build(), BodyHandlers.ofString()); System.out.println("Status code: " + response.statusCode()); System.out.println("Response body: " + response.body());} catch (Exception e) { e.printStackTrace();}using System;using System.Net.Http;using System.Text;var client = new HttpClient();var response = await client.GetAsync("https://api.pre.dev/v1/files");var responseBody = await response.Content.ReadAsStringAsync();use reqwest::{Result, Client};async fn main() -> Result<()> { let client = Client::new(); let url = "https://api.pre.dev/v1/files"; let res = client .get(url) .send() .await? .text() .await?; println!("{}", res); Ok(())}{ "object": "list", "data": [ { "id": "file-8Kz3pQ", "object": "file", "bytes": 1024000, "created_at": 1790500000, "filename": "contract.pdf", "purpose": "user_data" } ], "first_id": "file-8Kz3pQ", "last_id": "file-8Kz3pQ", "has_more": false}{ "object": "list", "data": [ { "id": "file-8Kz3pQ", "object": "file", "bytes": 1024000, "created_at": 1790500000, "filename": "contract.pdf", "purpose": "user_data" } ], "first_id": "file-8Kz3pQ", "last_id": "file-8Kz3pQ", "has_more": true, "predev": { "skipped": [ "file-2Lm9Rt" ] }}The workspace API key (pdk_…) from Integrations → Built-in in the pre.dev dashboard.
In: header
Query Parameters
Files per page, 1 to 50.
1 <= value <= 5020desc for newest first, asc for oldest first.
"desc"Value in
- "desc"
- "asc"
A file id from an earlier page, usually its last_id. It must be one of this workspace's files, or the call returns 404 not_found.
Only files with this purpose, for example user_data.
Response Body
application/json
One page of files.
TypeScript Definitions
Use the response body type in TypeScript.
One page of this workspace's files. To read the next page, pass last_id as after while has_more is true.
application/json
Missing or invalid API key.
TypeScript Definitions
Use the response body type in TypeScript.
An error raised by pre.dev, in the OpenAI error shape with an extra predev object (absent on catalog_unavailable from the catalog listings). Branch on error.code.
application/json
after is not one of this workspace's files.
TypeScript Definitions
Use the response body type in TypeScript.
An error raised by pre.dev, in the OpenAI error shape with an extra predev object (absent on catalog_unavailable from the catalog listings). Branch on error.code.
application/json
Over the per-minute request limit for the workspace, or too many failed key attempts from this IP address. Wait Retry-After seconds.
TypeScript Definitions
Use the response body type in TypeScript.
An error raised by pre.dev, in the OpenAI error shape with an extra predev object (absent on catalog_unavailable from the catalog listings). Branch on error.code.
application/json
Unexpected error.
TypeScript Definitions
Use the response body type in TypeScript.
An error raised by pre.dev, in the OpenAI error shape with an extra predev object (absent on catalog_unavailable from the catalog listings). Branch on error.code.