Actions16
- Record Actions
- Attachment Actions
- Report Actions
- Schema Actions
Attachment → Get Upload URL
AI-generatedSummary
Request a signed upload URL for attaching a file to a Nexoid record, optionally specifying the attachment's content type and authentication mode.
Inputs
- Authentication Mode — Select to authenticate using the API service account or a provided Nexoid session ID for permission scoping.
- Provided Session ID (required) — A session ID to use instead of the API user, required if Authentication Mode is 'Provided Session'.
- Record type (required) — The Nexoid record type (similar to a database table) for which to request the upload URL.
- Record ID (required) — The identifier of the Nexoid record; any prefix in the ID is automatically stripped.
- Attachment Name (required) — The display filename for the attachment or the filename the upload URL will be requested for.
- Content Type — An optional MIME content type to include in the signed upload request; overrides default content type if provided.
Output shape
a single JSON object containing a signed URL and related metadata for file upload
The operation returns a JSON structure in the 'data' property with the signed upload URL and optional content type. The signed URL can be used to upload the file via HTTP PUT without further authentication.
Examples
Example 1: Using API User authentication to get an upload URL for a 'contact' record with ID '123' and filename 'photo.jpg'.
Set Authentication Mode to 'API User', Record type to 'contact', Record ID to '123', Attachment Name to 'photo.jpg', Content Type to 'image/jpeg' (optional). The returned URL can be used for direct file upload.
Example 2: Using a provided session ID to get an upload URL for an 'invoice' record with ID '456' and filename 'invoice.pdf'.
Set Authentication Mode to 'Provided Session', supply the session ID, set Record type to 'invoice', Record ID to '456', Attachment Name to 'invoice.pdf', and optionally specify 'application/pdf' as Content Type.