Box Developer Documentation

Box Doc Gen job (Full)

A full representation of a Box Doc Gen job.

This resource has a few variations that can be encountered when using the API.

The fields that are part of the full variant can be returned by API endpoints that support the fields parameter. For example, by defining the fields request parameter as id,type when requesting a file by ID, only those fields will be returned in the API response.

string
12345

The unique identifier that represent a Box Doc Gen job.

string
docgen_job

docgen_job

Value is always docgen_job

Box Doc Gen batch that the job belongs to.

string
2022-05-11T10:56:11-07:00

Time of job creation.

object

User who created the job.

11446498

The unique identifier for this user

user

user

Value is always user

object

ID of the enterprise.

1910967

The unique identifier for this enterprise

enterprise

enterprise

Value is always enterprise

The output file of the job. This property is null until the job is completed.

42037322

ID of the object

file

file

Value is always file

File version of the output file. This property is null until the job is completed.

12345

The unique identifier that represent a file version.

file_version

file_version

Value is always file_version

docx

Type of the generated file.

string
api

Source of the request.

string
completed

Status of the job.

Value is one of submitted,completed,failed,completed_with_error,pending

Box Doc Gen template used in the job.

42037322

ID of the object

file

file

Value is always file

File version of a template.

12345

The unique identifier that represent a file version.

file_version

file_version

Value is always file_version

Response Example

{
  "id": "12345",
  "type": "docgen_job",
  "batch": {
    "id": "12345",
    "type": "docgen_batch"
  },
  "created_at": "2022-05-11T10:56:11-07:00",
  "created_by": {
    "id": "11446498",
    "type": "user"
  },
  "enterprise": {
    "id": "1910967",
    "type": "enterprise"
  },
  "output_file": {
    "id": "42037322",
    "type": "file"
  },
  "output_file_version": {
    "id": "12345",
    "type": "file_version"
  },
  "output_type": "docx",
  "source": "api",
  "status": "completed",
  "template_file": {
    "id": "42037322",
    "type": "file"
  },
  "template_file_version": {
    "id": "12345",
    "type": "file_version"
  }
}