Skip to main content
POST
Create brief

Authorizations

Authorization
string
header
required

Use a valid Bearer token to authenticate.

Body

multipart/form-data
name
string
required

Brief name, max 100 characters, unique in your organization (briefs in Trash do not count). Example: SOP Servis Berkala 10.000 km

type
enum<string>
required

Document type. Only pdf today.

Available options:
pdf
sourceType
enum<string>
required

link: the brief points to a URL. upload: the brief holds an uploaded PDF.

Available options:
link,
upload
url
string

Required when sourceType is link. Must start with https://, max 2048 characters. Ignored for upload. Example: https://docs.example.com/oli-mesin-2026.pdf

file
file

The PDF, max 20 MB. Required when sourceType is upload. fileName and fileSize are read from this file; do not send them.

roleIds[]
string[]

Role IDs that can see the brief, one field per role. Leave it out to show the brief to every role. Example: 64b0c1d2e3f4a5b6c7d8e9f0

Response

Success

status
boolean

Status of response.

message
string

Message of API response.

data
object

The created brief.