Screens
API Reference for ProcessMaker Screen API
Create a new Settings css-override
POST /api/1.0/customize-ui HTTP/1.1
Host:
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 43
{
"variables": "text",
"sansSerifFont": "text"
}
success
{
"key": "text",
"config": [
{}
],
"name": "text",
"helper": "text",
"group": "text",
"format": "text",
"hidden": true,
"readonly": true,
"variables": "text",
"sansSerifFont": "text",
"id": "text",
"created_at": "2025-07-04T19:26:10.013Z",
"updated_at": "2025-07-04T19:26:10.013Z"
}
Display a listing of the Screen Categories.
Filter results by string. Searches Name, Description, and Status. All fields must match exactly.
Field to order results by
asc
Possible values: 10
GET /api/1.0/screen_categories HTTP/1.1
Host:
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
list of screens categories
{
"data": [
{
"name": "text",
"status": "ACTIVE",
"id": "text",
"created_at": "2025-07-04T19:26:10.013Z",
"updated_at": "2025-07-04T19:26:10.013Z"
}
],
"meta": {}
}
Store a newly created Screen Category in storage
Represents a business screen category definition.
POST /api/1.0/screen_categories HTTP/1.1
Host:
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 33
{
"name": "text",
"status": "ACTIVE"
}
success
{
"name": "text",
"status": "ACTIVE",
"id": "text",
"created_at": "2025-07-04T19:26:10.013Z",
"updated_at": "2025-07-04T19:26:10.013Z"
}
Display the specified screen category.
ID of screen category to return
GET /api/1.0/screen_categories/{screen_category_id} HTTP/1.1
Host:
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
Successfully found the screen
{
"name": "text",
"status": "ACTIVE",
"id": "text",
"created_at": "2025-07-04T19:26:10.013Z",
"updated_at": "2025-07-04T19:26:10.013Z"
}
Updates the current element
ID of screen category to return
Represents a business screen category definition.
PUT /api/1.0/screen_categories/{screen_category_id} HTTP/1.1
Host:
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 33
{
"name": "text",
"status": "ACTIVE"
}
success
{
"name": "text",
"status": "ACTIVE",
"id": "text",
"created_at": "2025-07-04T19:26:10.013Z",
"updated_at": "2025-07-04T19:26:10.013Z"
}
Remove the specified resource from storage.
ID of screen category to return
DELETE /api/1.0/screen_categories/{screen_category_id} HTTP/1.1
Host:
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
success
No content
Get a list of Screens.
Filter results by string. Searches Name, Description, and Status. Status must match exactly. Others can be a substring.
Field to order results by
asc
Possible values: 10
Include data from related models in payload. Comma separated list.
""
Comma separated list of fields to exclude from the response
""
GET /api/1.0/screens HTTP/1.1
Host:
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
list of screens
{
"data": [
{
"title": "text",
"type": "text",
"description": "text",
"config": [
{}
],
"computed": [
{}
],
"watchers": [
{}
],
"custom_css": "text",
"screen_category_id": "text",
"id": "text",
"created_at": "2025-07-04T19:26:10.013Z",
"updated_at": "2025-07-04T19:26:10.013Z"
}
],
"meta": {}
}
Create a new Screen.
Class Screen
POST /api/1.0/screens HTTP/1.1
Host:
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 145
{
"title": "text",
"type": "text",
"description": "text",
"config": [
{}
],
"computed": [
{}
],
"watchers": [
{}
],
"custom_css": "text",
"screen_category_id": "text"
}
success
{
"title": "text",
"type": "text",
"description": "text",
"config": [
{}
],
"computed": [
{}
],
"watchers": [
{}
],
"custom_css": "text",
"screen_category_id": "text",
"id": "text",
"created_at": "2025-07-04T19:26:10.013Z",
"updated_at": "2025-07-04T19:26:10.013Z"
}
Get a single Screen.
ID of screens to return
GET /api/1.0/screens/{screens_id} HTTP/1.1
Host:
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
Successfully found the screen
{
"title": "text",
"type": "text",
"description": "text",
"config": [
{}
],
"computed": [
{}
],
"watchers": [
{}
],
"custom_css": "text",
"screen_category_id": "text",
"id": "text",
"created_at": "2025-07-04T19:26:10.013Z",
"updated_at": "2025-07-04T19:26:10.013Z"
}
Update a Screen.
ID of screen to return
Class Screen
PUT /api/1.0/screens/{screens_id} HTTP/1.1
Host:
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 145
{
"title": "text",
"type": "text",
"description": "text",
"config": [
{}
],
"computed": [
{}
],
"watchers": [
{}
],
"custom_css": "text",
"screen_category_id": "text"
}
success
No content
duplicate a Screen.
ID of screen to return
Class Screen
PUT /api/1.0/screens/{screens_id}/duplicate HTTP/1.1
Host:
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 145
{
"title": "text",
"type": "text",
"description": "text",
"config": [
{}
],
"computed": [
{}
],
"watchers": [
{}
],
"custom_css": "text",
"screen_category_id": "text"
}
success
{
"title": "text",
"type": "text",
"description": "text",
"config": [
{}
],
"computed": [
{}
],
"watchers": [
{}
],
"custom_css": "text",
"screen_category_id": "text",
"id": "text",
"created_at": "2025-07-04T19:26:10.013Z",
"updated_at": "2025-07-04T19:26:10.013Z"
}
Export the specified screen.
ID of screen to return
POST /api/1.0/screens/{screensId}/export HTTP/1.1
Host:
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
Successfully exported the screen
{
"url": "text"
}
Import the specified screen.
file to import
POST /api/1.0/screens/import HTTP/1.1
Host:
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: multipart/form-data
Accept: */*
Content-Length: 17
{
"file": "binary"
}
success
{
"status": {}
}
Get preview a screen
POST /api/1.0/screens/preview HTTP/1.1
Host:
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 61
{
"config": {},
"watchers": {},
"computed": {},
"custom_css": "text"
}
Successfully found the screen
{
"title": "text",
"type": "text",
"description": "text",
"config": [
{}
],
"computed": [
{}
],
"watchers": [
{}
],
"custom_css": "text",
"screen_category_id": "text",
"id": "text",
"created_at": "2025-07-04T19:26:10.013Z",
"updated_at": "2025-07-04T19:26:10.013Z"
}
Last updated