Generate PDF

Generate a PDF for an existing object instance and return metadata for downloading it. The PDF is rendered on the server and uploaded to the target's storage bucket.

Requires READ, MANAGE_FORM, MANAGE_OBJECTS, or ADMIN permissions on the target.

Parameters

name * are required parameters	data type	description
body.objectInstanceId*	string	The object instance ID to render as a PDF. This is typically a form or task instance stored in the shared objects collection.

Return Value

{
  "message": "Successfully created server print",
  "data": {
    "fileName": "safety-inspection-1711987654321.pdf",
    "filePath": "targets/.../generated-pdfs/safety-inspection-1711987654321.pdf",
    "downloadUrl": "https://storage.googleapis.com/..."
  }
}

The returned downloadUrl is a temporary signed URL in non-emulator environments.

Error Codes

• 400 Bad Request: Returned when objectInstanceId is missing, not a string, or does not resolve to an existing object instance.
• 401 Unauthorized: Returned when the request is unauthenticated or the caller does not have any of the required permissions on the target.
• 500 Server Error: Returned when PDF generation, asset staging, or storage upload fails unexpectedly.

Examples

bash

curl -X POST "https://app.wombat.software/print/organization/org_123/tenant/tenant_456/print" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <firebase-id-token>" \
  -d '{"objectInstanceId":"object_123"}'