Workflows
Create workflow
Make a workflow from plain words, and Orgo drafts the steps, or from its lines. It starts off.
POST
Makes a new workflow. Send
describe (plain words: Orgo drafts the steps) or lines (the steps themselves), one of the two. The workflow’s id is its name in lowercase words joined by -, so Morning report is morning-report.
A new workflow is off. Fix what to_fix says, check it with Validate, then turn it on with Update a workflow and { "on": true }.
Headers
8 to 255 printable characters. A retry with the same key and body within a day answers with the workflow the first request made, and makes nothing new. The same key with another body answers
409 with code: "idempotency_key_reused".Request body
A few words, at most 40 characters. Left out, the name the lines or the draft give the start, else the first words of
describe.What it does, in plain words, at most 2,000 characters: what starts it and each step. Orgo’s drafting model writes the lines. Needs a key with AI write as well as Workflows write. Send this or
lines.The workflow, one JSON object per line, the start first. The format is at orgo.ai/workflows.md. Send this or
describe.An IANA zone its times are read in, like
America/New_York. You can also set it later with Update a workflow.Response
201, with the version in the ETag header.
Example
Response
Errors
Every error is{ "error", "code" }, often with say (a few words) and next (the call that fixes it).
Authorizations
Headers
Body
application/json
describe or lines, one of the two.
The steps themselves, one JSON object per line (https://www.orgo.ai/workflows.md).
Response
The workflow, made.
The workflow, one JSON object per step, the start first (https://www.orgo.ai/workflows.md).