Skip to main content
GET
/
public
/
v1
/
projects
/
{projectId}
/
sources
/
{sourceId}
/
generation-events
List source generation events
curl --request GET \
  --url https://your-synthbrew-server.com/api/public/v1/projects/{projectId}/sources/{sourceId}/generation-events \
  --header 'x-api-key: <api-key>'
[
  {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "slug": "<string>",
    "sourceId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "projectId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "teamId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "schemaVersionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "trigger": "<string>",
    "status": "<string>",
    "queuedAt": "2023-11-07T05:31:56Z",
    "startedAt": "2023-11-07T05:31:56Z",
    "finishedAt": "2023-11-07T05:31:56Z",
    "durationMs": 123,
    "totalInsertedRows": 123,
    "billableRows": 123,
    "errorMessage": "<string>",
    "metadata": {},
    "createdAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z"
  }
]

Authorizations

​
x-api-key
string
header
required

Team API key created under /api/api-keys. Prefix: sb_api_.

Path Parameters

​
projectId
string<uuid>
required

Project UUID in the team associated with the API key.

​
sourceId
string<uuid>
required

Source UUID. For runtime endpoints this identifies the source backing the table; for public v1 it identifies the source resource inside the project.

Query Parameters

​
limit
integer
default:50

Maximum number of latest events to return (newest first).

Required range: 1 <= x <= 200

Response

Generation events

​
id
string<uuid>
​
slug
string
​
sourceId
string<uuid>
​
projectId
string<uuid>
​
teamId
string<uuid>
​
schemaVersionId
string<uuid>
​
trigger
string

Generation trigger type (populate or regenerate).

​
status
string

Event status (queued, active, success, failed).

​
queuedAt
string<date-time>
​
startedAt
string<date-time> | null
​
finishedAt
string<date-time> | null
​
durationMs
integer | null

Duration in milliseconds when available.

​
totalInsertedRows
integer

Total generated rows inserted for this run.

​
billableRows
integer

Rows counted toward billing/usage for this run.

​
errorMessage
string | null

Sanitized error text when generation fails.

​
metadata
object

Additional context such as mode, targetProvider, targetSchema, targetProjectRef, and queue job details.

​
createdAt
string<date-time>
​
updatedAt
string<date-time> | null