Pylon AddNote

Pylon AddNote

Certified

Add an internal note to a Pylon issue

Calls POST /issues/{id}/note to post an internal note, not visible to the requester. If neither threadId nor messageId is set, the note is posted to the most recently created Slack-backed internal thread, or a new Pylon-only thread if none exists.

yaml
type: io.kestra.plugin.pylon.issue.AddNote

Leave an internal note after an automated check

yaml
id: add_pylon_note
namespace: company.team

inputs:
  - id: issue_id
    type: STRING

tasks:
  - id: add_note
    type: io.kestra.plugin.pylon.issue.AddNote
    apiToken: "{{ secret('PYLON_API_TOKEN') }}"
    issueId: "{{ inputs.issue_id }}"
    bodyHtml: "Automated check passed, closing shortly."
Properties

Pylon API token

API token created by a Pylon Admin user (Pylon Settings > API), sent as Authorization: Bearer <token> on every request. Store it as a Kestra secret and reference it with {{ secret('PYLON_API_TOKEN') }} — never hardcode it in a flow.

Note body (HTML)

HTML content of the internal note.

Issue ID or number

The Pylon issue to add the note to.

Assets this task consumes as inputs or produces as outputs, for lineage tracking and the asset graph (Enterprise Edition). A flow declaring this property on a task is rejected in the open-source edition.

Definitions
assetFailureBehaviorstring
Possible Values
IGNOREFAILWARN

Asset failure behavior

Behavior applied to the task state when a declared asset fails to render, emit, or be persisted (e.g. a lock conflict): FAIL escalates it to FAILED, WARN (default) warns it if it would otherwise succeed, IGNORE leaves the state untouched.

enableAutobooleanstring

Whether to auto-register assets referenced dynamically at runtime that are not statically declared in inputs or outputs.

inputsarray

The assets consumed as inputs.

id*string
Min length1
typestring
outputs

The assets produced as outputs.

id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*string
Min length1

Custom asset type

descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
SubTypestring

Attachment URLs

URLs of files to attach to this internal note.

Defaulthttps://api.usepylon.com

Pylon API base URL

Base URL of the Pylon API. Defaults to the US region (https://api.usepylon.com); override with https://api.eu.usepylon.com for the EU region.

Message ID

An existing internal note's id (from GET /issues/{id}/messages) whose thread should receive the new note. Cannot be combined with threadId.

Thread ID

Internal thread to post the note to (the id field from GET /issues/{id}/threads). Cannot be combined with messageId.

Thread name

Name for a new Pylon-only internal thread. Used only when neither threadId nor messageId is set and no Slack-backed internal thread exists.

User ID

Pylon user to post the note as. Defaults to the API token's user.

Issue ID

Identifier of the issue the note was posted on.

Message ID

Pylon-assigned identifier of the newly created note.