Skip to content

Fix CEL syntax and invalid trigger in functions-automations docs#394

Merged
mindymo merged 5 commits into
mainfrom
docs-47-fix-functions-automations-accuracy
Jul 17, 2026
Merged

Fix CEL syntax and invalid trigger in functions-automations docs#394
mindymo merged 5 commits into
mainfrom
docs-47-fix-functions-automations-accuracy

Conversation

@mindymo

@mindymo mindymo commented Jul 16, 2026

Copy link
Copy Markdown
Collaborator

Summary

  • functions-automations.mdx: fixed CEL syntax (steps.<name>.output.<field>ctx.<step_name>.<field>, matching the actual automation execution engine and expressions-workflows.mdx) and swapped the example's invalid "Access request created" trigger for the real "Grant found" trigger.
  • functions-create.mdx: renamed "Use the copilot to write function code" to "Use C1AI to write function code" and fixed the button labels to match the actual UI text ("Create with Functions assistant" / "Edit with Functions assistant"), since the AI entry point now opens the shared C1AI assistant rather than a dedicated copilot.
  • functions-api.mdx: fixed "functionType": "FUNCTION_TYPE_DEFAULT" (not a real enum value — should be FUNCTION_TYPE_ANY) in both Create-function examples, and fixed the Invoke example's json field to be base64-encoded (it's a proto bytes field decoded via plain protojson.Unmarshal, so a raw JSON string fails to parse).

All fixes were verified against the c1 product source (protos, generated REST gateway code, and relevant Go controllers), not just re-reading the docs.

Test plan

  • Visual diff review of all three files

Step-output references used a nonexistent `steps.<name>.output.<field>`
form; the automation CEL context is `ctx.<step_name>.<field>` per the
workflow execution engine, matching expressions-workflows.mdx. Also
swapped the example's "Access request created" trigger, which isn't a
real automation trigger type, for "Grant found".
@linear-code

linear-code Bot commented Jul 16, 2026

Copy link
Copy Markdown

DOCS-47

@mintlify

mintlify Bot commented Jul 16, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
conductorone 🟢 Ready View Preview Jul 16, 2026, 10:01 PM

@mintlify

mintlify Bot commented Jul 16, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
conductorone 🟡 Building Jul 16, 2026, 9:59 PM

The function-editor AI entry point now opens the shared C1AI assistant
rather than a dedicated copilot, and the actual button labels are
"Create with Functions assistant" / "Edit with Functions assistant",
not "Create with AI" / "Edit with AI".
FUNCTION_TYPE_DEFAULT isn't a real FunctionType value; the proto only
defines UNSPECIFIED/ANY/CODE_MODE and explicitly calls for ANY on user
functions. The Invoke example's `json` field is proto bytes, decoded by
the generated gateway via plain protojson.Unmarshal, so it must be
base64-encoded rather than a raw JSON string.

@gromande gromande left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Changes look good

Training/compliance verification, custom approval routing, and risk
scoring aren't good candidates today since functions can't be invoked
from provisioning/access-request policies. Ticketing integration
should use native connectors instead of functions. Broadened username
generation into attribute generation more generally, and added
out-of-band API calls as a use case.
@mindymo
mindymo merged commit 56e3af9 into main Jul 17, 2026
3 checks passed
@mindymo
mindymo deleted the docs-47-fix-functions-automations-accuracy branch July 17, 2026 19:03
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants