Contractors.es icon

Contractors.es

Interact with Contractors.es API

Actions995

Job Visit Notes Relation Api → Post Api Contractors Job Visits Job Visit Notes

AI-generated

Summary

Create a note for a specified job visit, optionally including attachments, visibility settings, alerts, and external metadata.

Inputs

  • Job Visit (required) — Job visit identifier to associate the note with.
  • Title — Note title. Defaults to DO_NOT_SET, which is omitted from the request.
  • Note — Note text. Defaults to DO_NOT_SET, which is omitted from the request.
  • Files — JSON array of note attachments. Items can be form-data upload files or base64 payload strings in the supported formats. Defaults to DO_NOT_SET, which is omitted.
  • Permission — Visibility setting: 1 for public, 2 for public read-only, or 3 for private. Defaults to DO_NOT_SET, which is omitted.
  • Sticky — Optional sticky value; defaults to DO_NOT_SET and is omitted.
  • Category Id — Optional category identifier; defaults to DO_NOT_SET and is omitted.
  • Alert — Optional alert value; defaults to DO_NOT_SET and is omitted.
  • Alert Grid — Optional alert grid value; defaults to DO_NOT_SET and is omitted.
  • Alert To — Optional alert recipient value; defaults to DO_NOT_SET and is omitted.
  • Alert Type — Optional alert type value; defaults to DO_NOT_SET and is omitted.
  • External Id — Optional external identifier; defaults to DO_NOT_SET and is omitted.
  • Request Options — Optional HTTP request settings, including batching, SSL certificate validation, proxy, and timeout.

Output shape

A list of items containing the API response for the created note.

The source pack shows the node is generated from an OpenAPI description and declares JSON request defaults, but does not include the endpoint response schema or execution logic, so the exact response fields and item shape are not specified. Optional fields with the DO_NOT_SET default are omitted from the request.

Examples

Example 1: Add a private note with an attachment

Provide the required Job Visit ID, set the title and note text, choose Permission 3, and pass Files as a JSON array of supported file payloads.

Links

Discussion