API and agentsAPI reference
Recipe
object
editRevisionstringpattern^[0-9a-f]{32}$Opaque durable revision paired with this document state. Camera and derived writes do not change it.
lastChangedAtstringor nullformatdate-timeTime of the last accepted covered change, independent of camera and cache clocks.
lastChangedByA named actor has display and fixed SQL names. { deleted: true } explicitly identifies a deleted actor and carries no names or profile fields. Null explicitly means unknown. Never inferred from ownership.
One of:
object
namestringrequiredsqlNamestringrequired
No other keys.
object
deletedbooleanalwaystruerequired
No other keys.
or null
idstringnamestringoriginstringWhich surface made it: the workflows page lists
workflow; the builder's one-step Tools makebuilder. Fixed at creation.One of
workflow,builderprojectIdstringor nullThe project this workflow is in: on the caller's own workflow always, a project they no longer reach included (they withdraw it with PATCH /api/projects/{id}/members), and on anyone else's the project through which the caller reaches it; null = in no project.
ownerPersonrequiredThe workflow's owner.
homestringrequiredThe SQL name of the workflow's SQL home: the account whose datasets its plain table names mean, whoever reads or runs it.
createdAtstringupdatedAtstringWhen it was last edited: rename, or a step added, edited, reordered or removed. A run is not an edit, and neither is a refused change. Strictly increasing.
summaryRecipeSummarystepsarray of RecipeStep
All of:
object
editRevisionstringrequiredpattern^[0-9a-f]{32}$Opaque durable revision paired with this document state. Camera and derived writes do not change it.
lastChangedAtstringor nullrequiredformatdate-timeTime of the last accepted covered change, independent of camera and cache clocks.
lastChangedByrequiredA named actor has display and fixed SQL names. { deleted: true } explicitly identifies a deleted actor and carries no names or profile fields. Null explicitly means unknown. Never inferred from ownership.
One of:
object
namestringrequiredsqlNamestringrequired
No other keys.
object
deletedbooleanalwaystruerequired
No other keys.
or null
7439201b