submit_issue
Submit an issue to Neotoma and receive a guest access token for follow-up status. Provide reporter git SHA or app version.
Instructions
Submit an issue to the configured operator Neotoma instance; returns guest_access_token when accepted so callers can use token-scoped get_issue_status / add_issue_message read-back. Callers must provide at least one of reporter_git_sha or reporter_app_version. Deprecated alias: visibility 'advisory' is accepted as 'private' for one minor release and returns _deprecation: "visibility 'advisory' is deprecated; use 'private' instead."
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| title | Yes | Issue title. | |
| body | Yes | Issue body in markdown. | |
| labels | No | Labels to apply (e.g. bug, doc_gap, enhancement). | |
| visibility | No | Use 'private' for PII-sensitive issues (Neotoma only, no GitHub mirror). Default: 'public'. | |
| reporter_git_sha | No | Required (this OR reporter_app_version). Reporter git SHA (`git rev-parse HEAD`). | |
| reporter_git_ref | No | Optional reporter git ref / branch name. | |
| reporter_channel | No | Optional reporter channel (e.g. ci, local). | |
| reporter_app_version | No | Required (this OR reporter_git_sha). Reporter app / CLI version (semver). | |
| reporter_ci_run_id | No | Optional CI or workflow run id. | |
| reporter_patch_source_id | No | Optional source id for reporter patch artifact. | |
| target_repo | No | Optional GitHub mirror destination override (`owner/repo`). Use when filing issues about a repo other than the one Neotoma is globally configured for (e.g. `markmhendrickson/ateles`). Overrides only the GitHub mirror — Neotoma authoring home is unchanged. | |
| conversation_turn_id | No | Entity ID of the conversation turn (conversation_message entity) where this issue was observed. When provided, a REFERS_TO relationship is created from the filed issue to the conversation turn so the origin is traceable. |