Transformation Project

Represents a transformation project in your Fivetran account. A transformation project is a container for a dbt Core configuration, including its repository connection, environment settings, and target group. Transformations are created within a project and inherit its configuration.

Resource attributes

The following attributes describe a transformation project and its setup state.

Field name	Type	Description
`id`	string, read-only	Unique identifier of the transformation project.
`type`	string	Type of the transformation project. Possible values: `DBT_CORE`.
`status`	string, read-only	Setup status of the project. Possible values: `READY` – The project is configured and ready to run transformations. `NOT_READY` – The project is not yet fully configured. `ERROR` – The project encountered an error during setup.
`errors`	array of strings, read-only	List of errors encountered during project setup. Present when `status` is `ERROR`.
`setup_tests`	array of objects, read-only	Results of the setup tests run against the project configuration.
`group_id`	string, read-only	Unique identifier of the group the project belongs to.
`created_at`	string, read-only	Date and time the project was created, in ISO 8601 format.
`created_by_id`	string, read-only	Unique identifier of the user or system key that created the project.

Supported operations

Category	Endpoint	Description
List	`GET /v1/transformation-projects`	Returns a paginated list of all transformation projects in the account.
Create	`POST /v1/transformation-projects`	Creates a new transformation project.
Retrieve	`GET /v1/transformation-projects/{projectId}`	Returns the details of a transformation project.
Update	`PATCH /v1/transformation-projects/{projectId}`	Updates an existing transformation project.
Delete	`DELETE /v1/transformation-projects/{projectId}`	Deletes a transformation project.
Test	`POST /v1/transformation-projects/{projectId}/test`	Triggers setup tests for a transformation project.