{ "id": 12345, "externalId": "ext-123", "templateIdentifier": "my-template", "format": "pdf", "webhookIdentifier": "my-webhook", "mailServerIdentifier": "my-webhook", "brandIdentifier": "default", "metadata": { "reference": "my-reference-123", "info": { "version": 3, "type": "my-type" } }, "renderData": {}, "comment": "Here is my comment", "origin": "api", "documentRenderings": [ "https://example.com/" ], "externalState": "string", "state": "done", "createdBy": "user1@company.com", "updatedBy": "user1@company.com", "createdAt": "2024-08-23T00:00:00+00:00", "updatedAt": "2024-08-23T00:00:00+00:00", "blocked": true }

RenderingRequest

Retrieves a RenderingRequest resource.

Returns a RenderingRequest. Rendering Requests are generated in first process step, represents received data and are handled asynchronously.

GET/api/rendering-requests/{id}

Retrieves a RenderingRequest resource.

curl --request GET \
  --url 'https://app.output.rocks/api/rendering-requests/string' \
  --header 'X-AUTH-TOKEN: <api-key>'

200

application/json

{
  "id": 12345,
  "externalId": "ext-123",
  "templateIdentifier": "my-template",
  "format": "pdf",
  "webhookIdentifier": "my-webhook",
  "mailServerIdentifier": "my-webhook",
  "brandIdentifier": "default",
  "metadata": {
    "reference": "my-reference-123",
    "info": {
      "version": 3,
      "type": "my-type"
    }
  },
  "renderData": {},
  "comment": "Here is my comment",
  "origin": "api",
  "documentRenderings": [
    "https://example.com/"
  ],
  "externalState": "string",
  "state": "done",
  "createdBy": "user1@company.com",
  "updatedBy": "user1@company.com",
  "createdAt": "2024-08-23T00:00:00+00:00",
  "updatedAt": "2024-08-23T00:00:00+00:00",
  "blocked": true
}

Authorizations

X-AUTH-TOKEN

stringheaderrequired

Value for the X-AUTH-TOKEN header parameter.

Query Parameters

flags[]

string[]

Flags to fetch additional data

Path Parameters

stringrequired

RenderingRequest identifier

Response

200application/json

RenderingRequest resource

integer

RenderingRequest ID generated by Output.Rocks.

Example: 12345

externalId

string

Optional external ID provided by origin application

Example: "ext-123"

templateIdentifier

string

Template identifier provided in request

Example: "my-template"

format

enum<string>

Document format to be used for rendered documents

Available options: pdfdocodtrtfhtmltxt

Example: "pdf"

webhookIdentifier

string

Webhook identifier provided in request

Example: "my-webhook"

mailServerIdentifier

string

Mail-Server identifier provided in request

Example: "my-webhook"

brandIdentifier

string

Brand identifier resolved by the rendering workflow

Example: "default"

metadata

object

Optional metadata to be used in webhooks

Example: {"reference":"my-reference-123","info":{"version":3,"type":"my-type"}}

renderData

object

comment

string

Comment for the rendering request

Example: "Here is my comment"

origin

string

Rendering Request Origin (api / data collector)

Example: "api"

documentRenderings

string<iri-reference>[]

externalState

string

state

string

Workflow state of the request: start - Rendering request created mapped - Rendering request is mapped. Document & Email renderings (if any) are created. done - Rendering request is completely handled anonymized - Rendering request is anonymized (data is deleted)

Example: "done"

createdBy

string

User, created this entry

Example: "user1@company.com"

updatedBy

string

User, updated this entry

Example: "user1@company.com"

createdAt

string<date-time>

UTC date time of entry creation

Example: "2024-08-23T00:00:00+00:00"

updatedAt

string<date-time>

UTC date time of last entry update

Example: "2024-08-23T00:00:00+00:00"

blocked

boolean

Available options: truefalse