Create Drawing Set

Creates a drawing set with its sheets. The set is created immediately; each sheet's file and thumbnail are prepared asynchronously.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
required
length ≤ 24

The project ID the drawing set belongs to.

string
required
length ≤ 255

Name of the drawing set.

string
enum
required

Type of the drawing set.

Allowed:
sheets
array of objects
required
length between 1 and 1000

Sheets to create. One single-page PDF per sheet version. At most 1000 versions in total, where a sheet without versions counts as one.

sheets*
string
required

Sheet number / page label, e.g. "A-1.0". Must be unique within the payload.

string
required

Sheet title, e.g. "Cover Sheet".

string | null
Defaults to null

ID of a single-page PDF file uploaded via /v2/pub/files, for a sheet with a single version. Existence is checked synchronously; the single-page assertion happens asynchronously. Required unless versions is given.

string | null
enum
Defaults to null

Sheet discipline category.

integer | null
Defaults to null

Version to seed a single-version sheet with. Defaults to 1; a later in-app revision increments it. Cannot be combined with versions.

date | null
Defaults to null

Issue date of a single-version sheet in Y-m-d format. Defaults to the set-level issue_date. Cannot be combined with versions.

versions
array of objects | null
Defaults to null

Version history of the sheet, each version with its own file. Use instead of file_id, version and issue_date. Versions must be listed with unique, ascending version numbers; the last (highest) version becomes the current one.

versions
string | null
enum
Defaults to null

Discipline category of the drawing set.

date | null
Defaults to null

Issue date of the drawing set in Y-m-d format. Also the default issue date for sheets without their own.

Responses
201

Created

400

Bad Request

401

Unauthorized

403

Access forbidden

404

Project not found

422

Validation error

Language
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here!