Integrations
n8n operation reference
Every resource, operation, and field the orboto n8n node and trigger support.
This page is the complete field-by-field reference for the
n8n-nodes-orboto package: every operation on the
orboto action node, grouped by resource, and every event the orboto
Trigger node can fire on. For installation, credentials, error-handling
semantics (422/409/423/429), and a worked walkthrough, see
n8n first - this page assumes you've already
connected a credential and just need to know what a specific operation
expects.
A few conventions that apply across every resource below:
- "Project" fields are dropdowns that load your orboto projects live - you rarely need to type a key or ID by hand.
- "Ticket" fields accept a ticket key (
ACME-42), a bare number (42, resolved against the Project field), or a UUID - whichever is most convenient in your workflow. - Fields marked (loaded live) are dropdowns populated from your connected orboto instance (statuses, members, labels, milestones, versions, doc spaces) rather than typed by hand.
- A field left blank on Update-style operations is left untouched on the ticket/milestone/doc - see n8n for the general error-handling and rate-limit notes that apply to every operation.
Ticket
| Operation | Required fields | Optional fields | Notes |
|---|---|---|---|
| Create | Project, Title | Description, Type, Priority, Status (loaded live), Milestone (loaded live), Version (loaded live), Label Names (loaded live, multi), Assignee Emails (comma-separated), Parent Ticket, Start Date, Due Date, Estimated Time (minutes), Private, Delivery Mode, Skip Auto-Translate, Allow Language Mismatch, Allow Duplicate + Duplicate Justification | Type: epic/story/task/bug. Priority: blocker/high/normal/low/trivial. Delivery Mode: implementation/docs/review/admin/epic. Duplicate Justification is required when Allow Duplicate is on. |
| Get | Project, Ticket | - | |
| Get Many | Project | Return All / Limit, Status Category, Assignee (loaded live), Milestone Filter (loaded live), Parent Ticket Filter, Search, Include Closed Milestones | Status Category: todo/in_progress/in_review/done/wont_fix. |
| Update | Project, Ticket | Update Fields collection: Description, Type, Priority, Status, Milestone, Version, Start Date, Due Date, Estimated Time, Private, Delivery Mode, Skip Auto-Translate, Label Names, Assignee Emails, Parent Ticket; Allow Language Mismatch | Only fields explicitly added to the Update Fields collection are changed - everything else on the ticket is left alone. |
| Delete | Project, Ticket | - | Permanent unless the ticket is under legal hold (423). Prefer moving to wont_fix over deleting when in doubt. |
| Move (Change Status) | Project, Ticket, Status (loaded live) | - | |
| Assign / Unassign | Project, Ticket, User (loaded live) | - | |
| Comment | Project, Ticket, Comment | Internal | Comment body is Markdown. Internal comments aren't visible to customers. |
| Log Time | Project, Ticket, Duration (minutes) | Time Description, Logged At | Logged At defaults to now. |
| Add Label / Remove Label | Project, Ticket, Label (loaded live) | - | |
| OQL Query | Query, Syntax | Return All / Limit | Syntax: oql or jql. No Project field - the query itself scopes the results. Paginates automatically via cursor until Limit (or all results, with Return All) is reached. |
| Set Milestone | Project, Ticket, Milestone (loaded live) | - | |
| Clear Milestone | Project, Ticket | - | |
| Set Version | Project, Ticket, Version (loaded live) | - | |
| Clear Version | Project, Ticket | - | |
| Add Dependency / Remove Dependency | Project, Ticket, Depends On Ticket | - | |
| Get Dependencies | Project, Ticket | - | |
| Checklists: Add Item | Project, Ticket, Checklist ID, Item Text | - | |
| Checklists: Check Item / Uncheck Item | Project, Ticket, Item ID | - | |
| Get Attachments | Project, Ticket | - | |
| Add Attachment | Project, Ticket, Binary Property | - | Binary Property names the input item's binary field holding the file (default data). |
| Bulk Update | Project, Ticket IDs (comma-separated), Action | Value, shaped per Action | Action: status / milestone / assignee / version / priority / due_date, each with its own live-loaded or plain Value field. Prefer this over looping per-ticket updates for large batches. |
Milestone
| Operation | Required fields | Optional fields |
|---|---|---|
| Create | Project, Name | Milestone Key, Start Date, End Date, Budget Amount, Budget Hours, Private |
| Get | Project, Milestone (key or ID) | - |
| Get Many | Project | Include Closed |
| Update | Project, Milestone | Milestone Key, Start Date, End Date, Status (active/completed/archived), Budget Amount, Budget Hours, Private |
| Close | Project, Milestone | - |
Close is a convenience wrapper around Update with Status set to
completed.
Project
| Operation | Required fields | Optional fields |
|---|---|---|
| Create | Name | Key, Description, Language |
| Get | Project (key or ID) | - |
| Get Many | - | - |
| Update | Project | Name, Key, Description, Language, Status (draft/active/archived/closed) |
| Get Primer Facts | Project | - |
| Get AI Primer | Project | - |
Key must be 2-10 uppercase characters (letters and digits). Language is the ticket language enforced for that project - see n8n for how the node surfaces a language mismatch.
Doc
| Operation | Required fields | Optional fields | Notes |
|---|---|---|---|
| Create | Space (loaded live), Title | Content, Visibility | Visibility: public/workspace/members/specific, default workspace. |
| Get | Doc (key or ID) | - | |
| Get Many | Space | - | |
| Update | Doc | Title, Content, Visibility | Only the fields set are changed. |
| Ask Docs (RAG) | Question | Limit Results | Requires an embedding provider configured on the instance - a clear error explains this if none is set up. |
| Ingest URL | Space, URL | Raw HTML | Pass Raw HTML to ingest pre-fetched content instead of letting orboto fetch the URL itself. |
Time Entry
| Operation | Required fields | Optional fields |
|---|---|---|
| Log | Project, Ticket, Duration (minutes) | Description, Logged At |
| Get Many | Project, Ticket | - |
| Edit | Project, Ticket, Entry ID, Duration (minutes) | Description |
| Delete | Project, Ticket, Entry ID | - |
All time-entry operations are ticket-scoped.
User
| Operation | Required fields |
|---|---|
| Get Project Members | Project |
There's no global user directory operation - member reads are always scoped to one project, matching the fact that orboto has no workspace-wide "all users" list a non-admin can read.
Label
| Operation | Required fields | Optional fields |
|---|---|---|
| Create | Project, Name | Color |
| Get Many | Project | - |
Saved Search
| Operation | Required fields | Optional fields | Notes |
|---|---|---|---|
| Create | Name, Query Type | OQL Query (when Query Type is oql or jql) | Query Type: oql/jql/legacy. |
| Get Many | - | - | |
| Run | Saved Search (name or ID) | - | Only OQL/JQL saved searches can be run from n8n - a legacy-type saved search fails with a clear error, since legacy queries have no OQL/JQL text to execute. |
Agent
The n8n-to-agent bridge - lets a workflow talk to an agent identity's inbox the same way one agent notifies another.
| Operation | Required fields | Optional fields | Notes |
|---|---|---|---|
| Notify | Target Email, Subject | Kind, Payload (JSON), Thread ID, Project Scope, Sender Reference | Kind: info (FYI), request (expects an answer), complete (closes a request), error (reports failure). Project Scope routes the message to the right session. |
| Get Messages | - | Include Already-Delivered, Limit, Exclude Reference, Project Scope | By default returns only messages not yet delivered to this reader. |
| Ack Messages | Message IDs (comma-separated) | - | Marks messages as delivered so a later Get Messages call doesn't return them again. |
orboto Trigger: events
The trigger's Events field lists these 16 events; check any combination. An Additional Events free-text field (comma-separated) lets you subscribe to event types added to orboto after this package version shipped, before the node has a dedicated checkbox for them.
| Event | Fires when |
|---|---|
ticket.created | A ticket is created. |
ticket.updated | A ticket's fields change. |
ticket.deleted | A ticket is deleted. |
ticket.ready | A ticket becomes unblocked (its dependencies are resolved). |
ticket.checklist_item.completed | A checklist item on a ticket is checked. |
comment.created | A comment is posted. |
comment.updated | A comment is edited. |
comment.deleted | A comment is deleted. |
project.member_added | A member joins a project. |
project.member_removed | A member leaves a project. |
milestone.created | A milestone is created. |
milestone.updated | A milestone's fields change. |
version.released | A version is marked released. |
symphony.candidates_changed | A ticket's status, assignee, or priority changes, in a shape relevant to a Symphony coding-agent orchestrator polling for work. |
inbound.signal.received | An inbound signal (e.g. from inbound email processing) is received. |
agent.escalation_raised | An AI agent raises an escalation that needs human attention. |
Every delivery is scoped to the Project you selected on the trigger node - webhooks in orboto are project-scoped, so one trigger node watches one project. Add a second orboto Trigger node for a second project.