Skip to main content
GET
/
public
/
v1
/
projects
/
{projectId}
/
sources
/
{sourceId}
/
generation-events
List source generation events
curl --request GET \
  --url https://api.synthbrew.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