List transforms
GET/v1/transformspreview
List the app’s transforms with the destinations and sources that link each one.
Query parameters
kindstring OptionalOnly transforms of this kind. Omitted: every kind you can read.
Allowed values: "destination", "source"
Returns
The query result.200
dataobject[] RequiredEvery transform, by name.
idstring RequiredA transform ID, starting with tfm_.
kindstring Requireddestination: maps an event payload to the request a destination receives. source: builds an event from the request a source receives. A transform links only to resources of its kind.
Allowed values: "destination", "source"
namestring RequiredA name for people.
1 to 120 characters
managedobject | null RequiredThe managed transform version this transform runs in place of code of its own.
publishedAtstring | null RequiredWhen the live code was published. Null until the draft is first published, or when pinned.
unpublishedChangesboolean RequiredTrue when the draft is not the live code: it was never published, or it was saved since.
destinationsobject[] RequiredThe destinations that link this transform, by name.
Show child attributesHide child attributes
idstring RequiredA destination ID, starting with dst_.
namestring RequiredIts name.
sourcesobject[] RequiredThe sources that link this transform, by name.
Show child attributesHide child attributes
idstring RequiredA source ID, starting with src_.
namestring RequiredIts name.
createdAtstring (date-time) RequiredISO 8601 timestamp.
updatedAtstring (date-time) RequiredISO 8601 timestamp.
linksobject RequiredLinks for navigating a paginated collection.
nextstring | null RequiredURI reference for the next page, or null at the end.
Example
curl -X GET "https://api.payloadpuffin.com/v1/transforms" \
-H "Authorization: Bearer $PAYLOADPUFFIN_API_KEY"{
"data": [
{
"id": "id",
"kind": "destination",
"name": "name",
"managed": {
"provider": "provider",
"version": 1
},
"publishedAt": "publishedAt",
"unpublishedChanges": true,
"destinations": [
{
"id": "id",
"name": "name"
}
],
"sources": [
{
"id": "id",
"name": "name"
}
],
"createdAt": "createdAt",
"updatedAt": "updatedAt"
}
],
"links": {
"next": "next"
}
}Errors
Errors use application/problem+json. The code member is stable; branch on it rather than on title or detail.
4XXapplication/problem+jsonThe request was rejected.