> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.itspropel.com/llms.txt. > For full documentation content, see https://docs.itspropel.com/llms-full.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.itspropel.com/_mcp/server. # Public Signature (Signed URL) POST https://public/signatures/%7Bsignable_type%7D/%7Bsignable_id%7D Content-Type: multipart/form-data Public signing endpoint. No auth required - protected by Laravel signed URL. signable_type: invoice, estimate, work-recommendation, work-order Reference: https://docs.itspropel.com/propel-biz/26-work-recommendations/public-signature-signed-url ## OpenAPI Specification ```yaml openapi: 3.1.0 info: title: PropelBiz version: 1.0.0 paths: /public/signatures/%7Bsignable_type%7D/%7Bsignable_id%7D: post: operationId: public-signature-signed-url summary: Public Signature (Signed URL) description: >- Public signing endpoint. No auth required - protected by Laravel signed URL. signable_type: invoice, estimate, work-recommendation, work-order tags: - subpackage_26WorkRecommendations parameters: - name: signature in: query description: 'Required: Laravel signed URL signature hash' required: false schema: type: string - name: expires in: query description: 'Required: Signed URL expiration timestamp' required: false schema: type: string responses: '200': description: Successful response content: application/json: schema: $ref: >- #/components/schemas/26 Work Recommendations_Public Signature (Signed URL)_Response_200 requestBody: content: multipart/form-data: schema: type: object properties: metadata: type: string description: 'Optional: Additional context - json - {}' signer_name: type: string description: >- Optional (Required for public): Full name of signer - string|max:255 - John Doe signer_role: type: string description: >- Required: Role of signer - enum: CUSTOMER,TENANT,PROPERTY_MANAGER,AUTHORIZED_REPRESENTATIVE,TECHNICIAN,SUBCONTRACTOR,INSPECTOR,SUPERVISOR,COMPANY_REPRESENTATIVE,WITNESS,OTHER signer_email: type: string description: >- Optional (Required for public): Email of signer - email|max:255 - john@example.com signature_file: type: string format: binary description: >- Required: Signature image file - mimes:png,jpg,jpeg|max:2048 - Binary file upload signer_role_description: type: string description: >- Conditional: Required when signer_role=OTHER - string|max:255 - Board Member required: - metadata - signer_name - signer_role - signer_email - signature_file - signer_role_description servers: - url: https:/ components: schemas: 26 Work Recommendations_Public Signature (Signed URL)_Response_200: type: object properties: {} description: Empty response body title: 26 Work Recommendations_Public Signature (Signed URL)_Response_200 ``` ## SDK Code Examples ```python import requests url = "https://https/public/signatures/%7Bsignable_type%7D/%7Bsignable_id%7D" querystring = {"signature":"{{signed_url_signature}}","expires":"{{expires}}"} files = { "signature_file": "open('signature_jane_smith.png', 'rb')" } payload = { "metadata": "{\"device\":\"iPad Pro\",\"location\":\"New York, NY\"}", "signer_name": "Jane Smith", "signer_role": "CUSTOMER", "signer_email": "jane.smith@example.com", "signer_role_description": "" } response = requests.post(url, data=payload, files=files, params=querystring) print(response.json()) ``` ```javascript const url = 'https://https/public/signatures/%7Bsignable_type%7D/%7Bsignable_id%7D?signature=%7B%7Bsigned_url_signature%7D%7D&expires=%7B%7Bexpires%7D%7D'; const form = new FormData(); form.append('metadata', '{"device":"iPad Pro","location":"New York, NY"}'); form.append('signer_name', 'Jane Smith'); form.append('signer_role', 'CUSTOMER'); form.append('signer_email', 'jane.smith@example.com'); form.append('signature_file', 'signature_jane_smith.png'); form.append('signer_role_description', ''); const options = {method: 'POST'}; options.body = form; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://https/public/signatures/%7Bsignable_type%7D/%7Bsignable_id%7D?signature=%7B%7Bsigned_url_signature%7D%7D&expires=%7B%7Bexpires%7D%7D" payload := strings.NewReader("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"metadata\"\r\n\r\n{\"device\":\"iPad Pro\",\"location\":\"New York, NY\"}\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"signer_name\"\r\n\r\nJane Smith\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"signer_role\"\r\n\r\nCUSTOMER\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"signer_email\"\r\n\r\njane.smith@example.com\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"signature_file\"; filename=\"signature_jane_smith.png\"\r\nContent-Type: application/octet-stream\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"signer_role_description\"\r\n\r\n\r\n-----011000010111000001101001--\r\n") req, _ := http.NewRequest("POST", url, payload) res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby require 'uri' require 'net/http' url = URI("https://https/public/signatures/%7Bsignable_type%7D/%7Bsignable_id%7D?signature=%7B%7Bsigned_url_signature%7D%7D&expires=%7B%7Bexpires%7D%7D") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request.body = "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"metadata\"\r\n\r\n{\"device\":\"iPad Pro\",\"location\":\"New York, NY\"}\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"signer_name\"\r\n\r\nJane Smith\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"signer_role\"\r\n\r\nCUSTOMER\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"signer_email\"\r\n\r\njane.smith@example.com\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"signature_file\"; filename=\"signature_jane_smith.png\"\r\nContent-Type: application/octet-stream\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"signer_role_description\"\r\n\r\n\r\n-----011000010111000001101001--\r\n" response = http.request(request) puts response.read_body ``` ```java import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://https/public/signatures/%7Bsignable_type%7D/%7Bsignable_id%7D?signature=%7B%7Bsigned_url_signature%7D%7D&expires=%7B%7Bexpires%7D%7D") .body("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"metadata\"\r\n\r\n{\"device\":\"iPad Pro\",\"location\":\"New York, NY\"}\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"signer_name\"\r\n\r\nJane Smith\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"signer_role\"\r\n\r\nCUSTOMER\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"signer_email\"\r\n\r\njane.smith@example.com\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"signature_file\"; filename=\"signature_jane_smith.png\"\r\nContent-Type: application/octet-stream\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"signer_role_description\"\r\n\r\n\r\n-----011000010111000001101001--\r\n") .asString(); ``` ```php request('POST', 'https://https/public/signatures/%7Bsignable_type%7D/%7Bsignable_id%7D?signature=%7B%7Bsigned_url_signature%7D%7D&expires=%7B%7Bexpires%7D%7D', [ 'multipart' => [ [ 'name' => 'metadata', 'contents' => '{"device":"iPad Pro","location":"New York, NY"}' ], [ 'name' => 'signer_name', 'contents' => 'Jane Smith' ], [ 'name' => 'signer_role', 'contents' => 'CUSTOMER' ], [ 'name' => 'signer_email', 'contents' => 'jane.smith@example.com' ], [ 'name' => 'signature_file', 'filename' => 'signature_jane_smith.png', 'contents' => null ] ] ]); echo $response->getBody(); ``` ```csharp using RestSharp; var client = new RestClient("https://https/public/signatures/%7Bsignable_type%7D/%7Bsignable_id%7D?signature=%7B%7Bsigned_url_signature%7D%7D&expires=%7B%7Bexpires%7D%7D"); var request = new RestRequest(Method.POST); request.AddParameter("undefined", "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"metadata\"\r\n\r\n{\"device\":\"iPad Pro\",\"location\":\"New York, NY\"}\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"signer_name\"\r\n\r\nJane Smith\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"signer_role\"\r\n\r\nCUSTOMER\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"signer_email\"\r\n\r\njane.smith@example.com\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"signature_file\"; filename=\"signature_jane_smith.png\"\r\nContent-Type: application/octet-stream\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"signer_role_description\"\r\n\r\n\r\n-----011000010111000001101001--\r\n", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift import Foundation let parameters = [ [ "name": "metadata", "value": "{\"device\":\"iPad Pro\",\"location\":\"New York, NY\"}" ], [ "name": "signer_name", "value": "Jane Smith" ], [ "name": "signer_role", "value": "CUSTOMER" ], [ "name": "signer_email", "value": "jane.smith@example.com" ], [ "name": "signature_file", "fileName": "signature_jane_smith.png" ], [ "name": "signer_role_description", "value": "" ] ] let boundary = "---011000010111000001101001" var body = "" var error: NSError? = nil for param in parameters { let paramName = param["name"]! body += "--\(boundary)\r\n" body += "Content-Disposition:form-data; name=\"\(paramName)\"" if let filename = param["fileName"] { let contentType = param["content-type"]! let fileContent = String(contentsOfFile: filename, encoding: String.Encoding.utf8) if (error != nil) { print(error as Any) } body += "; filename=\"\(filename)\"\r\n" body += "Content-Type: \(contentType)\r\n\r\n" body += fileContent } else if let paramValue = param["value"] { body += "\r\n\r\n\(paramValue)" } } let request = NSMutableURLRequest(url: NSURL(string: "https://https/public/signatures/%7Bsignable_type%7D/%7Bsignable_id%7D?signature=%7B%7Bsigned_url_signature%7D%7D&expires=%7B%7Bexpires%7D%7D")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```