Learn / Documentation / API reference / Projects

API reference

Early access. The VeraGen API is not open yet: this reference shows what it will do, and keys cannot be created until it opens. Request early access.

API reference

Projects

The projects in the account. Data Management items, and the workflows that write into them, belong to a project.

List projects

GET/v1/projectscontent:read

The account's projects, newest first. Archived projects are left out; read one by its id to see it.

Parameters

Name	Type	Description
`limit` query	integer	How many to return. 1 to 100. Default `25`.
`cursor` query	string	The `next_cursor` from the previous page. Leave it out for the first page.

Response 200

Field	Type	Description
`data`	array of object
`data[].id`	string (uuid)
`data[].name`	string
`data[].description`	string
`data[].archived`	boolean
`data[].created_at`	string (date-time)
`data[].updated_at`	string (date-time)
`has_more`	boolean
`next_cursor`	string or null

Errors

400 The request is not valid.
401 No valid API key.
403 The key may not do this.
404 No endpoint at that path.
429 Too many requests.
500 Something went wrong on our side.

The codes are listed under Errors.

cURL

curl "https://api.veragen.ai/v1/projects?limit=25" \
  -H "Authorization: Bearer $VERAGEN_API_KEY"

JavaScript

const res = await fetch("https://api.veragen.ai/v1/projects?limit=25", {
  headers: { Authorization: `Bearer ${process.env.VERAGEN_API_KEY}` },
});
const data = await res.json();

Python

import os, requests

res = requests.get(
    "https://api.veragen.ai/v1/projects",
    params={"limit": 25},
    headers={"Authorization": f"Bearer {os.environ['VERAGEN_API_KEY']}"},
)
data = res.json()

Response 200

{
  "data": [
    {
      "id": "9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d",
      "name": "Market research",
      "description": "Competitors, pricing and interviews.",
      "archived": false,
      "created_at": "2026-08-14T09:30:00.000Z",
      "updated_at": "2026-10-02T15:04:05.123Z"
    }
  ],
  "has_more": false,
  "next_cursor": null
}

Get a project

GET/v1/projects/{id}content:read

One project, archived or not.

Parameters

Name	Type	Description
`id` path, required	string (uuid)	The project's id.

Response 200

Field	Type	Description
`id`	string (uuid)
`name`	string
`description`	string
`archived`	boolean
`created_at`	string (date-time)
`updated_at`	string (date-time)

Errors

400 The request is not valid.
401 No valid API key.
403 The key may not do this.
404 Not found in this account.
429 Too many requests.
500 Something went wrong on our side.

The codes are listed under Errors.

cURL

curl "https://api.veragen.ai/v1/projects/{id}" \
  -H "Authorization: Bearer $VERAGEN_API_KEY"

JavaScript

const res = await fetch("https://api.veragen.ai/v1/projects/{id}", {
  headers: { Authorization: `Bearer ${process.env.VERAGEN_API_KEY}` },
});
const data = await res.json();

Python

import os, requests

res = requests.get(
    "https://api.veragen.ai/v1/projects/{id}",
    headers={"Authorization": f"Bearer {os.environ['VERAGEN_API_KEY']}"},
)
data = res.json()

Response 200

{
  "id": "9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d",
  "name": "Market research",
  "description": "Competitors, pricing and interviews.",
  "archived": false,
  "created_at": "2026-08-14T09:30:00.000Z",
  "updated_at": "2026-10-02T15:04:05.123Z"
}

cURL

curl "https://api.veragen.ai/v1/projects?limit=25" \
  -H "Authorization: Bearer $VERAGEN_API_KEY"

JavaScript

const res = await fetch("https://api.veragen.ai/v1/projects?limit=25", {
  headers: { Authorization: `Bearer ${process.env.VERAGEN_API_KEY}` },
});
const data = await res.json();

Python

import os, requests

res = requests.get(
    "https://api.veragen.ai/v1/projects",
    params={"limit": 25},
    headers={"Authorization": f"Bearer {os.environ['VERAGEN_API_KEY']}"},
)
data = res.json()

Response 200

{
  "data": [
    {
      "id": "9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d",
      "name": "Market research",
      "description": "Competitors, pricing and interviews.",
      "archived": false,
      "created_at": "2026-08-14T09:30:00.000Z",
      "updated_at": "2026-10-02T15:04:05.123Z"
    }
  ],
  "has_more": false,
  "next_cursor": null
}

cURL

curl "https://api.veragen.ai/v1/projects/{id}" \
  -H "Authorization: Bearer $VERAGEN_API_KEY"

JavaScript

const res = await fetch("https://api.veragen.ai/v1/projects/{id}", {
  headers: { Authorization: `Bearer ${process.env.VERAGEN_API_KEY}` },
});
const data = await res.json();

Python

import os, requests

res = requests.get(
    "https://api.veragen.ai/v1/projects/{id}",
    headers={"Authorization": f"Bearer {os.environ['VERAGEN_API_KEY']}"},
)
data = res.json()

Response 200

{
  "id": "9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d",
  "name": "Market research",
  "description": "Competitors, pricing and interviews.",
  "archived": false,
  "created_at": "2026-08-14T09:30:00.000Z",
  "updated_at": "2026-10-02T15:04:05.123Z"
}