{ "openapi": "3.0.0", "info": { "title": "ProcessMaker API", "description": "", "contact": { "email": "info@processmaker.com" }, "license": { "name": "Apache 2.0", "url": "http://www.apache.org/licenses/LICENSE-2.0.html" }, "version": "1.0.0" }, "servers": [ { "url": "/api/1.0" } ], "paths": { "/customize-ui": { "post": { "tags": [ "CssSettings" ], "summary": "Create or update a new setting", "operationId": "updateCssSetting", "requestBody": { "required": true, "content": { "application/json": { "schema": { "properties": { "variables": { "description": "Create a new Settings css-override", "type": "string" }, "sansSerifFont": { "description": "Create a new Settings css-override", "type": "string" } }, "type": "object" } } } }, "responses": { "201": { "description": "success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/settings" } } } } } } }, "/environment_variables": { "get": { "tags": [ "Environment Variables" ], "summary": "Returns all environmentVariables that the user has access to. For security, values are not included.", "operationId": "getEnvironmentVariables", "parameters": [ { "$ref": "#/components/parameters/filter" }, { "$ref": "#/components/parameters/order_by" }, { "$ref": "#/components/parameters/order_direction" }, { "$ref": "#/components/parameters/per_page" }, { "$ref": "#/components/parameters/include" } ], "responses": { "200": { "description": "list of environmentVariables", "content": { "application/json": { "schema": { "properties": { "data": { "description": "Fetch a collection of variables based on paged request and filter if provided", "type": "array", "items": { "$ref": "#/components/schemas/EnvironmentVariable" } }, "meta": { "description": "Fetch a collection of variables based on paged request and filter if provided", "type": "object" } }, "type": "object" } } } } } }, "post": { "tags": [ "Environment Variables" ], "summary": "Create a new environment variable", "operationId": "createEnvironmentVariable", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EnvironmentVariableEditable" } } } }, "responses": { "201": { "description": "success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EnvironmentVariable" } } } } } } }, "/environment_variables/{environment_variable_id}": { "get": { "tags": [ "Environment Variables" ], "summary": "Get an environment variable by id. For security, the value is not included.", "operationId": "getEnvironmentVariableById", "parameters": [ { "name": "environment_variable_id", "in": "path", "description": "ID of environment_variables to return", "required": true, "schema": { "type": "integer" } } ], "responses": { "201": { "description": "success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EnvironmentVariable" } } } } } }, "put": { "tags": [ "Environment Variables" ], "summary": "Update an environment variable", "operationId": "updateEnvironmentVariable", "parameters": [ { "name": "environment_variable_id", "in": "path", "description": "ID of environment variables to update", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EnvironmentVariableEditable" } } } }, "responses": { "200": { "description": "success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EnvironmentVariable" } } } } } }, "delete": { "tags": [ "Environment Variables" ], "summary": "Delete an environment variable", "operationId": "deleteEnvironmentVariable", "parameters": [ { "name": "environment_variable_id", "in": "path", "description": "ID of environment_variables to return", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "success" } } } }, "/files": { "get": { "tags": [ "Files" ], "summary": "Returns the list of files", "operationId": "getFiles", "parameters": [ { "$ref": "#/components/parameters/filter" }, { "$ref": "#/components/parameters/order_by" }, { "$ref": "#/components/parameters/order_direction" }, { "$ref": "#/components/parameters/per_page" } ], "responses": { "200": { "description": "list of files", "content": { "application/json": { "schema": { "properties": { "data": { "description": "Display a listing of the resource.", "type": "array", "items": { "$ref": "#/components/schemas/media" } }, "meta": { "$ref": "#/components/schemas/metadata" } }, "type": "object" } } } } } }, "post": { "tags": [ "Files" ], "summary": "Save a new media file. Note: To upload files to a request, use createRequestFile in the RequestFile API", "operationId": "createFile", "parameters": [ { "name": "model_id", "in": "query", "description": "ID of the model to which the file will be associated", "required": true, "schema": { "type": "integer" } }, { "name": "model", "in": "query", "description": "Full namespaced class of the model to associate", "required": true, "schema": { "type": "string" } }, { "name": "data_name", "in": "query", "description": "Name of the variable used in a request", "required": false, "schema": { "type": "string" } }, { "name": "collection", "in": "query", "description": "Media collection name. For requests, use 'default'", "required": false, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "multipart/form-data": { "schema": { "properties": { "file": { "description": "save a new media file", "type": "string", "format": "binary" } }, "type": "object" } } } }, "responses": { "200": { "description": "success", "content": { "application/json": { "schema": { "properties": { "id": { "description": "Store a newly created resource in storage.", "type": "string" }, "model_id": { "description": "Store a newly created resource in storage.", "type": "string" }, "file_name": { "description": "Store a newly created resource in storage.", "type": "string" }, "mime_type": { "description": "Store a newly created resource in storage.", "type": "string" } }, "type": "object" } } } } } } }, "/files/{file_id}": { "get": { "tags": [ "Files" ], "summary": "Get the metadata of a file. To actually fetch the file see Get File Contents", "operationId": "getFileById", "parameters": [ { "name": "file_id", "in": "path", "description": "ID of the file to return", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successfully found the file", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/media" } } } }, "404": { "$ref": "#/components/responses/404" } } }, "delete": { "tags": [ "Files" ], "summary": "Delete a media file", "operationId": "deleteFile", "parameters": [ { "name": "file_id", "in": "path", "description": "ID of the file", "required": true, "schema": { "type": "integer" } } ], "responses": { "204": { "description": "success" }, "404": { "$ref": "#/components/responses/404" } } } }, "/files/{file_id}/contents": { "get": { "tags": [ "Files" ], "summary": "Get the contents of a file", "operationId": "getFileContentsById", "parameters": [ { "name": "file_id", "in": "path", "description": "ID of the file to return", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "File stream", "content": { "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } }, "404": { "$ref": "#/components/responses/404" } } } }, "/groups": { "get": { "tags": [ "Groups" ], "summary": "Returns all groups that the user has access to", "operationId": "getGroups", "parameters": [ { "$ref": "#/components/parameters/status" }, { "$ref": "#/components/parameters/filter" }, { "$ref": "#/components/parameters/order_by" }, { "$ref": "#/components/parameters/order_direction" }, { "$ref": "#/components/parameters/per_page" }, { "$ref": "#/components/parameters/include" } ], "responses": { "200": { "description": "list of groups", "content": { "application/json": { "schema": { "properties": { "data": { "description": "Display a listing of the resource.", "type": "array", "items": { "$ref": "#/components/schemas/groups" } }, "meta": { "$ref": "#/components/schemas/metadata" } }, "type": "object" } } } } } }, "post": { "tags": [ "Groups" ], "summary": "Save a new group", "operationId": "createGroup", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/groupsEditable" } } } }, "responses": { "201": { "description": "success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/groups" } } } }, "422": { "$ref": "#/components/responses/422" } } } }, "/groups/{group_id}": { "get": { "tags": [ "Groups" ], "summary": "Get single group by ID", "operationId": "getGroupById", "parameters": [ { "name": "group_id", "in": "path", "description": "ID of group to return", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successfully found the group", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/groups" } } } }, "404": { "$ref": "#/components/responses/404" } } }, "put": { "tags": [ "Groups" ], "summary": "Update a group", "operationId": "updateGroup", "parameters": [ { "name": "group_id", "in": "path", "description": "ID of group to return", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/groupsEditable" } } } }, "responses": { "204": { "description": "success" }, "404": { "$ref": "#/components/responses/404" } } }, "delete": { "tags": [ "Groups" ], "summary": "Delete a group", "operationId": "deleteGroup", "parameters": [ { "name": "group_id", "in": "path", "description": "ID of group to return", "required": true, "schema": { "type": "integer" } } ], "responses": { "204": { "description": "success" }, "404": { "$ref": "#/components/responses/404" } } } }, "/groups/{group_id}/users": { "get": { "tags": [ "Groups" ], "summary": "Returns all users of a group", "operationId": "getGroupUsers", "parameters": [ { "name": "group_id", "in": "path", "description": "ID of group", "required": true, "schema": { "type": "integer" } }, { "$ref": "#/components/parameters/filter" }, { "$ref": "#/components/parameters/order_direction" }, { "$ref": "#/components/parameters/per_page" } ], "responses": { "200": { "description": "list of members of a group", "content": { "application/json": { "schema": { "properties": { "data": { "description": "Display the list of users in a group", "type": "array", "items": { "$ref": "#/components/schemas/users" } }, "meta": { "$ref": "#/components/schemas/metadata" } }, "type": "object" } } } } } } }, "/group_members": { "get": { "tags": [ "Group Members" ], "summary": "Returns all groups for a given member", "operationId": "getGroupMembers", "parameters": [ { "$ref": "#/components/parameters/member_id" }, { "$ref": "#/components/parameters/order_by" }, { "$ref": "#/components/parameters/order_direction" }, { "$ref": "#/components/parameters/per_page" } ], "responses": { "200": { "description": "list of group_members", "content": { "application/json": { "schema": { "properties": { "data": { "description": "Display a listing of the resource.", "type": "array", "items": { "$ref": "#/components/schemas/groupMembers" } }, "meta": { "$ref": "#/components/schemas/metadata" } }, "type": "object" } } } } } }, "post": { "tags": [ "Group Members" ], "summary": "Save a new group member", "operationId": "createGroupMember", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/groupMembersEditable" } } } }, "responses": { "201": { "description": "success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/createGroupMembers" } } } } } } }, "/group_members/{group_member_id}": { "get": { "tags": [ "Group Members" ], "summary": "Get single group member by ID", "operationId": "getGroupMemberById", "parameters": [ { "name": "group_member_id", "in": "path", "description": "ID of group members to return", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successfully found the group members", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/getGroupMembersById" } } } } } }, "delete": { "tags": [ "Group Members" ], "summary": "Delete a group member", "operationId": "deleteGroupMember", "parameters": [ { "name": "group_member_id", "in": "path", "description": "ID of group_members to return", "required": true, "schema": { "type": "string" } } ], "responses": { "204": { "description": "success" } } } }, "/group_members_available": { "get": { "tags": [ "Group Members" ], "summary": "Returns all groups available for a given member", "operationId": "getGroupMembersAvailable", "parameters": [ { "name": "member_id", "in": "path", "description": "ID of group member to return", "required": true, "schema": { "type": "string" } }, { "name": "member_type", "in": "path", "description": "type of group member to return", "required": true, "schema": { "type": "string" } }, { "$ref": "#/components/parameters/filter" }, { "$ref": "#/components/parameters/order_by" }, { "$ref": "#/components/parameters/order_direction" }, { "$ref": "#/components/parameters/per_page" } ], "responses": { "200": { "description": "list of groups available to be assigned as member", "content": { "application/json": { "schema": { "properties": { "data": { "description": "Display a listing of groups available", "type": "array", "items": { "$ref": "#/components/schemas/availableGroupMembers" } }, "meta": { "$ref": "#/components/schemas/metadata" } }, "type": "object" } } } } } } }, "/user_members_available": { "get": { "tags": [ "Group Members" ], "summary": "Returns all users available for a given group", "operationId": "getUserMembersAvailable", "parameters": [ { "name": "group_id", "in": "path", "description": "ID of group to return", "required": true, "schema": { "type": "string" } }, { "name": "filter", "in": "query", "description": "Filter results by string. Searches Name. Can be a substring.", "schema": { "type": "string" } }, { "$ref": "#/components/parameters/order_by" }, { "$ref": "#/components/parameters/order_direction" }, { "$ref": "#/components/parameters/per_page" } ], "responses": { "200": { "description": "list of users available to be assigned as member", "content": { "application/json": { "schema": { "properties": { "data": { "description": "Display a listing of users available", "type": "array", "items": { "$ref": "#/components/schemas/users" } }, "meta": { "$ref": "#/components/schemas/metadata" } }, "type": "object" } } } } } } }, "/notifications": { "get": { "tags": [ "Notifications" ], "summary": "Returns all notifications that the user has access to", "operationId": "getNotifications", "parameters": [ { "name": "status", "in": "query", "description": "Only return notifications by status (unread, all, etc.)", "required": false, "schema": { "type": "string" } }, { "$ref": "#/components/parameters/filter" }, { "$ref": "#/components/parameters/order_by" }, { "$ref": "#/components/parameters/order_direction" }, { "$ref": "#/components/parameters/per_page" }, { "$ref": "#/components/parameters/include" } ], "responses": { "200": { "description": "list of notifications", "content": { "application/json": { "schema": { "properties": { "data": { "description": "Display a listing of the resource.", "type": "array", "items": { "$ref": "#/components/schemas/Notification" } }, "meta": { "description": "Display a listing of the resource." } }, "type": "object" } } } } } }, "post": { "tags": [ "Notifications" ], "summary": "Save a new notifications", "operationId": "createNotification", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/NotificationEditable" } } } }, "responses": { "201": { "description": "success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Notification" } } } } } } }, "/notifications/{notification_id}": { "get": { "tags": [ "Notifications" ], "summary": "Get single notification by ID", "operationId": "getNotificationById", "parameters": [ { "name": "notification_id", "in": "path", "description": "ID of notification to return", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successfully found the notification", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Notification" } } } } } }, "put": { "tags": [ "Notifications" ], "summary": "Update a notification", "operationId": "updateNotification", "parameters": [ { "name": "notification_id", "in": "path", "description": "ID of notification to return", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/NotificationEditable" } } } }, "responses": { "204": { "description": "success" } } }, "delete": { "tags": [ "Notifications" ], "summary": "Delete a notification", "operationId": "deleteNotification", "parameters": [ { "name": "notification_id", "in": "path", "description": "ID of notification to return", "required": true, "schema": { "type": "string" } } ], "responses": { "204": { "description": "success" } } } }, "/read_notifications": { "put": { "tags": [ "Notifications" ], "summary": "Mark notifications as read by the user", "operationId": "markNotificationAsRead", "requestBody": { "required": true, "content": { "application/json": { "schema": { "properties": { "message_ids": { "description": "list of message ids that will be marked as read", "type": "array", "items": { "type": "string" } }, "routes": { "description": "all messages that has an url that is in this list will be marked as read", "type": "array", "items": { "type": "string" } } }, "type": "object" } } } }, "responses": { "201": { "description": "success" } } } }, "/unread_notifications": { "put": { "tags": [ "Notifications" ], "summary": "Mark notifications as unread by the user", "operationId": "markNotificationAsUnread", "requestBody": { "required": true, "content": { "application/json": { "schema": { "properties": { "message_ids": { "description": "list of message ids that will be marked as read", "type": "array", "items": { "type": "string" } }, "routes": { "description": "all messages that has an url that is in this list will be marked as read", "type": "array", "items": { "type": "string" } } }, "type": "object" } } } }, "responses": { "201": { "description": "success" } } } }, "/read_all_notifications": { "put": { "tags": [ "Notifications" ], "summary": "Mark notifications as read by id and type", "operationId": "markAllAsRead", "requestBody": { "required": true, "content": { "application/json": { "schema": { "properties": { "id": { "description": "Polymorphic relation id", "type": "integer", "items": { "type": "integer" } }, "type": { "description": "Polymorphic relation type", "type": "string", "items": { "type": "string" } } }, "type": "object" } } } }, "responses": { "201": { "description": "success" } } } }, "/permissions": { "put": { "tags": [ "Permissions" ], "summary": "Update the permissions of an user", "operationId": "ProcessMaker\\Http\\Controllers\\Api\\PermissionController::update", "requestBody": { "required": true, "content": { "application/json": { "schema": { "properties": { "user_id": { "description": "Id of the user whose permissions are configured", "type": "integer" }, "group_id": { "description": "Id of the group whose permissions are configured", "type": "integer" }, "permission_names": { "description": "Update permissions", "type": "array", "items": { "type": "string" } } }, "type": "object" } } } }, "responses": { "204": { "description": "success" } } } }, "/process_categories": { "get": { "tags": [ "Process Categories" ], "summary": "Returns all processes categories that the user has access to", "operationId": "getProcessCategories", "parameters": [ { "name": "filter", "in": "query", "description": "Filter results by string. Searches Name and Status. All fields must match exactly.", "schema": { "type": "string" } }, { "$ref": "#/components/parameters/order_by" }, { "$ref": "#/components/parameters/order_direction" }, { "$ref": "#/components/parameters/per_page" } ], "responses": { "200": { "description": "list of processes categories", "content": { "application/json": { "schema": { "properties": { "data": { "description": "Display a listing of the Process Categories.", "type": "array", "items": { "$ref": "#/components/schemas/ProcessCategory" } }, "meta": { "description": "Display a listing of the Process Categories.", "type": "object" } }, "type": "object" } } } } } }, "post": { "tags": [ "Process Categories" ], "summary": "Save a new process Category", "operationId": "createProcessCategory", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProcessCategoryEditable" } } } }, "responses": { "201": { "description": "success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProcessCategory" } } } } } } }, "/process_categories/{process_category_id}": { "get": { "tags": [ "Process Categories" ], "summary": "Get single process category by ID", "operationId": "getProcessCategoryById", "parameters": [ { "name": "process_category_id", "in": "path", "description": "ID of process category to return", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successfully found the process", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProcessCategory" } } } } } }, "put": { "tags": [ "Process Categories" ], "summary": "Update a process Category", "operationId": "updateProcessCategory", "parameters": [ { "name": "process_category_id", "in": "path", "description": "ID of process category to return", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProcessCategoryEditable" } } } }, "responses": { "200": { "description": "success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProcessCategory" } } } } } }, "delete": { "tags": [ "Process Categories" ], "summary": "Delete a process category", "operationId": "deleteProcessCategory", "parameters": [ { "name": "process_category_id", "in": "path", "description": "ID of process category to return", "required": true, "schema": { "type": "integer" } } ], "responses": { "204": { "description": "success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Process" } } } } } } }, "/processes": { "get": { "tags": [ "Processes" ], "summary": "Returns all processes that the user has access to", "operationId": "getProcesses", "parameters": [ { "$ref": "#/components/parameters/filter" }, { "$ref": "#/components/parameters/order_by" }, { "$ref": "#/components/parameters/order_direction" }, { "$ref": "#/components/parameters/per_page" }, { "$ref": "#/components/parameters/status" }, { "$ref": "#/components/parameters/include" } ], "responses": { "200": { "description": "list of processes", "content": { "application/json": { "schema": { "properties": { "data": { "description": "Get list Process", "type": "array", "items": { "$ref": "#/components/schemas/Process" } }, "meta": { "$ref": "#/components/schemas/metadata" } }, "type": "object" } } } } } }, "post": { "tags": [ "Processes" ], "summary": "Save a new process", "operationId": "createProcess", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProcessEditable" } } } }, "responses": { "201": { "description": "success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Process" } } } } } } }, "/processes/{processId}": { "get": { "tags": [ "Processes" ], "summary": "Get single process by ID", "operationId": "getProcessById", "parameters": [ { "name": "processId", "in": "path", "description": "ID of process to return", "required": true, "schema": { "type": "integer" } }, { "$ref": "#/components/parameters/include" } ], "responses": { "200": { "description": "Successfully found the process", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Process" } } } } } }, "put": { "tags": [ "Processes" ], "summary": "Update a process", "operationId": "updateProcess", "parameters": [ { "name": "processId", "in": "path", "description": "ID of process to return", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProcessEditable" } } } }, "responses": { "200": { "description": "success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Process" } } } } } }, "delete": { "tags": [ "Processes" ], "summary": "Delete a process", "operationId": "deleteProcess", "parameters": [ { "name": "processId", "in": "path", "description": "ID of process to return", "required": true, "schema": { "type": "integer" } } ], "responses": { "204": { "description": "success" } } } }, "/start_processes": { "get": { "tags": [ "Processes" ], "summary": "Returns the list of processes that the user can start", "operationId": "startProcesses", "parameters": [ { "$ref": "#/components/parameters/filter" }, { "$ref": "#/components/parameters/order_by" }, { "$ref": "#/components/parameters/order_direction" }, { "$ref": "#/components/parameters/per_page" }, { "$ref": "#/components/parameters/include" } ], "responses": { "200": { "description": "list of processes that the user can start", "content": { "application/json": { "schema": { "properties": { "data": { "description": "Returns the list of processes that the user can start.", "type": "array", "items": { "$ref": "#/components/schemas/ProcessWithStartEvents" } }, "meta": { "$ref": "#/components/schemas/metadata" } }, "type": "object" } } } } } } }, "/processes/{processId}/restore": { "put": { "tags": [ "Processes" ], "summary": "Restore an inactive process", "operationId": "restoreProcess", "parameters": [ { "name": "processId", "in": "path", "description": "ID of process to return", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Process" } } } } } } }, "/processes/{processId}/export": { "post": { "tags": [ "Processes" ], "summary": "Export a single process by ID and return a URL to download it", "operationId": "exportProcess", "parameters": [ { "name": "processId", "in": "path", "description": "ID of process to export", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successfully built the process for export", "content": { "application/json": { "schema": { "properties": { "url": { "description": "Export the specified process.", "type": "string" } }, "type": "object" } } } } } } }, "/processes/import": { "post": { "tags": [ "Processes" ], "summary": "Import a new process", "operationId": "importProcess", "requestBody": { "required": true, "content": { "multipart/form-data": { "schema": { "properties": { "file": { "description": "file to import", "type": "string", "format": "binary" } }, "type": "object" } } } }, "responses": { "200": { "description": "success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProcessImport" } } } } } } }, "/processes/import/{code}/is_ready": { "head": { "tags": [ "Processes" ], "summary": "Check if the import is ready", "operationId": "ProcessMaker\\Http\\Controllers\\Api\\ProcessController::import_ready", "parameters": [ { "name": "code", "in": "path", "description": "Import code", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "check is import is ready", "content": { "application/json": { "schema": { "properties": { "ready": { "description": "Check if the import is ready", "type": "boolean" } }, "type": "object" } } } } } } }, "/processes/{process_id}/import/assignments": { "post": { "tags": [ "Processes" ], "summary": "Update assignments after import", "operationId": "assignmentProcess", "parameters": [ { "name": "process_id", "in": "path", "description": "ID of process to return", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProcessAssignments" } } } }, "responses": { "204": { "description": "success" } } } }, "/process_events/{process_id}": { "post": { "tags": [ "Processes" ], "summary": "Start a new process", "operationId": "triggerStartEvent", "parameters": [ { "name": "process_id", "in": "path", "description": "ID of process to return", "required": true, "schema": { "type": "integer" } }, { "name": "event", "in": "query", "description": "Node ID of the start event", "required": true, "schema": { "type": "string" } } ], "requestBody": { "description": "data that will be stored as part of the created request", "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/processRequest" } } } } } } }, "/requests": { "get": { "tags": [ "Process Requests" ], "summary": "Returns all process Requests that the user has access to", "operationId": "getProcessesRequests", "parameters": [ { "name": "type", "in": "query", "description": "Only return requests by type (all|in_progress|completed)", "required": false, "schema": { "type": "string", "enum": [ "all", "in_progress", "completed", "started_me" ] } }, { "$ref": "#/components/parameters/filter" }, { "$ref": "#/components/parameters/order_by" }, { "$ref": "#/components/parameters/order_direction" }, { "$ref": "#/components/parameters/per_page" }, { "$ref": "#/components/parameters/include" } ], "responses": { "200": { "description": "list of processes", "content": { "application/json": { "schema": { "properties": { "data": { "description": "Display a listing of the resource.", "type": "array", "items": { "$ref": "#/components/schemas/processRequest" } }, "meta": { "$ref": "#/components/schemas/metadata" } }, "type": "object" } } } } } } }, "/requests/{process_request_id}": { "get": { "tags": [ "Process Requests" ], "summary": "Get single process request by ID", "operationId": "getProcessRequestById", "parameters": [ { "name": "process_request_id", "in": "path", "description": "ID of process request to return", "required": true, "schema": { "type": "integer" } }, { "$ref": "#/components/parameters/include" } ], "responses": { "200": { "description": "Successfully found the process", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/processRequest" } } } }, "404": { "$ref": "#/components/responses/404" } } }, "put": { "tags": [ "Process Requests" ], "summary": "Update a process request", "operationId": "updateProcessRequest", "parameters": [ { "name": "process_request_id", "in": "path", "description": "ID of process request to return", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/processRequestEditable" } } } }, "responses": { "204": { "description": "success" }, "404": { "$ref": "#/components/responses/404" } } }, "delete": { "tags": [ "Process Requests" ], "summary": "Delete a process request", "operationId": "deleteProcessRequest", "parameters": [ { "name": "process_request_id", "in": "path", "description": "ID of process request to return", "required": true, "schema": { "type": "integer" } } ], "responses": { "204": { "description": "success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/processRequest" } } } }, "404": { "$ref": "#/components/responses/404" } } } }, "/requests/{process_request_id}/events/{event_id}": { "post": { "tags": [ "Process Requests" ], "summary": "Update a process request event", "operationId": "updateProcessRequestEvent", "parameters": [ { "name": "process_request_id", "in": "path", "description": "ID of process request to return", "required": true, "schema": { "type": "string" } }, { "name": "event_id", "in": "path", "description": "ID of process event to return", "required": true, "schema": { "type": "string" } } ], "responses": { "204": { "description": "success" } } } }, "/requests/{request_id}/files": { "get": { "tags": [ "Request Files" ], "summary": "Returns the list of files associated with a request", "operationId": "getRequestFiles", "parameters": [ { "$ref": "#/components/parameters/filter" }, { "$ref": "#/components/parameters/order_by" }, { "$ref": "#/components/parameters/order_direction" }, { "$ref": "#/components/parameters/per_page" }, { "name": "request_id", "in": "path", "description": "ID of the request", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "list of files", "content": { "application/json": { "schema": { "properties": { "data": { "description": "Display a listing of the resource.", "type": "array", "items": { "$ref": "#/components/schemas/media" } }, "meta": { "description": "Display a listing of the resource.", "type": "object", "allOf": [ { "$ref": "#/components/schemas/metadata" } ] } }, "type": "object" } } } } } }, "post": { "tags": [ "Request Files" ], "summary": "Save a new media file to a request", "operationId": "createRequestFile", "parameters": [ { "name": "request_id", "in": "path", "description": "ID of the request", "required": true, "schema": { "type": "integer" } }, { "name": "data_name", "in": "query", "description": "Variable name in the request data to use for the file name", "required": false, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "multipart/form-data": { "schema": { "properties": { "file": { "description": "save a new media file", "type": "string", "format": "binary" } }, "type": "object" } } } }, "responses": { "200": { "description": "success", "content": { "application/json": { "schema": { "properties": { "message": { "description": "Store a newly created resource in storage.", "type": "string" }, "fileUploadId": { "description": "Store a newly created resource in storage.", "type": "integer" } }, "type": "object" } } } } } } }, "/requests/{request_id}/files/{file_id}": { "get": { "tags": [ "Request Files" ], "summary": "Get a file uploaded to a request", "operationId": "getRequestFilesById", "parameters": [ { "name": "request_id", "in": "path", "description": "ID of the request", "required": true, "schema": { "type": "integer" } }, { "name": "file_id", "in": "path", "description": "ID of the file to return", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "File stream", "content": { "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } }, "404": { "$ref": "#/components/responses/404" } } }, "delete": { "tags": [ "Request Files" ], "summary": "Delete all media associated with a request", "operationId": "deleteRequestFile", "parameters": [ { "name": "file_id", "in": "path", "description": "ID of the file", "required": true, "schema": { "type": "integer" } }, { "name": "request_id", "in": "path", "description": "ID of the request", "required": true, "schema": { "type": "string" } } ], "responses": { "204": { "description": "success" }, "404": { "$ref": "#/components/responses/404" } } } }, "/screen_categories": { "get": { "tags": [ "Screen Categories" ], "summary": "Returns all screens categories that the user has access to", "operationId": "getScreenCategories", "parameters": [ { "name": "filter", "in": "query", "description": "Filter results by string. Searches Name, Description, and Status. All fields must match exactly.", "schema": { "type": "string" } }, { "$ref": "#/components/parameters/order_by" }, { "$ref": "#/components/parameters/order_direction" }, { "$ref": "#/components/parameters/per_page" } ], "responses": { "200": { "description": "list of screens categories", "content": { "application/json": { "schema": { "properties": { "data": { "description": "Display a listing of the Screen Categories.", "type": "array", "items": { "$ref": "#/components/schemas/ScreenCategory" } }, "meta": { "description": "Display a listing of the Screen Categories.", "type": "object" } }, "type": "object" } } } } } }, "post": { "tags": [ "Screen Categories" ], "summary": "Save a new Screen Category", "operationId": "createScreenCategory", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ScreenCategoryEditable" } } } }, "responses": { "201": { "description": "success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ScreenCategory" } } } } } } }, "/screen_categories/{screen_category_id}": { "get": { "tags": [ "Screen Categories" ], "summary": "Get single screen category by ID", "operationId": "getScreenCategoryById", "parameters": [ { "name": "screen_category_id", "in": "path", "description": "ID of screen category to return", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successfully found the screen", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ScreenCategory" } } } } } }, "put": { "tags": [ "Screen Categories" ], "summary": "Update a screen Category", "operationId": "updateScreenCategory", "parameters": [ { "name": "screen_category_id", "in": "path", "description": "ID of screen category to return", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ScreenCategoryEditable" } } } }, "responses": { "200": { "description": "success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ScreenCategory" } } } } } }, "delete": { "tags": [ "Screen Categories" ], "summary": "Delete a screen category", "operationId": "deleteScreenCategory", "parameters": [ { "name": "screen_category_id", "in": "path", "description": "ID of screen category to return", "required": true, "schema": { "type": "string" } } ], "responses": { "204": { "description": "success" } } } }, "/screens": { "get": { "tags": [ "Screens" ], "summary": "Returns all screens that the user has access to", "operationId": "getScreens", "parameters": [ { "$ref": "#/components/parameters/filter" }, { "$ref": "#/components/parameters/order_by" }, { "$ref": "#/components/parameters/order_direction" }, { "$ref": "#/components/parameters/per_page" }, { "$ref": "#/components/parameters/include" } ], "responses": { "200": { "description": "list of screens", "content": { "application/json": { "schema": { "properties": { "data": { "description": "Get a list of Screens.", "type": "array", "items": { "$ref": "#/components/schemas/screens" } }, "meta": { "description": "Get a list of Screens.", "type": "object" } }, "type": "object" } } } } } }, "post": { "tags": [ "Screens" ], "summary": "Save a new screens", "operationId": "createScreen", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/screensEditable" } } } }, "responses": { "201": { "description": "success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/screens" } } } } } } }, "/screens/{screens_id}": { "get": { "tags": [ "Screens" ], "summary": "Get single screens by ID", "operationId": "getScreensById", "parameters": [ { "name": "screens_id", "in": "path", "description": "ID of screens to return", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successfully found the screen", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/screens" } } } } } }, "put": { "tags": [ "Screens" ], "summary": "Update a screen", "operationId": "updateScreen", "parameters": [ { "name": "screens_id", "in": "path", "description": "ID of screen to return", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/screensEditable" } } } }, "responses": { "204": { "description": "success" } } }, "delete": { "tags": [ "Screens" ], "summary": "Delete a screen", "operationId": "deleteScreen", "parameters": [ { "name": "screens_id", "in": "path", "description": "ID of screen to return", "required": true, "schema": { "type": "string" } } ], "responses": { "204": { "description": "success" } } } }, "/screens/{screens_id}/duplicate": { "put": { "tags": [ "Screens" ], "summary": "duplicate a screen", "operationId": "duplicateScreen", "parameters": [ { "name": "screens_id", "in": "path", "description": "ID of screen to return", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/screensEditable" } } } }, "responses": { "201": { "description": "success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/screens" } } } } } } }, "/screens/{screensId}/export": { "post": { "tags": [ "Screens" ], "summary": "Export a single screen by ID", "operationId": "exportScreen", "parameters": [ { "name": "screensId", "in": "path", "description": "ID of screen to return", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successfully exported the screen", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/screenExported" } } } } } } }, "/screens/import": { "post": { "tags": [ "Screens" ], "summary": "Import a new screen", "operationId": "importScreen", "requestBody": { "required": true, "content": { "multipart/form-data": { "schema": { "properties": { "file": { "description": "file to import", "type": "string", "format": "binary" } }, "type": "object" } } } }, "responses": { "201": { "description": "success", "content": { "application/json": { "schema": { "properties": { "status": { "description": "Import the specified screen.", "type": "object" } }, "type": "object" } } } } } } }, "/screens/preview": { "post": { "tags": [ "Screens" ], "summary": "Preview a screen", "operationId": "preview", "requestBody": { "required": true, "content": { "application/json": { "schema": { "properties": { "config": { "description": "Get preview a screen", "type": "object" }, "watchers": { "description": "Get preview a screen", "type": "object" }, "computed": { "description": "Get preview a screen", "type": "object" }, "custom_css": { "description": "Get preview a screen", "type": "string" } }, "type": "object" } } } }, "responses": { "200": { "description": "Successfully found the screen", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/screens" } } } } } } }, "/script_categories": { "get": { "tags": [ "Script Categories" ], "summary": "Returns all scripts categories that the user has access to", "operationId": "getScriptCategories", "parameters": [ { "name": "filter", "in": "query", "description": "Filter results by string. Searches Name, Description, and Status. All fields must match exactly.", "schema": { "type": "string" } }, { "$ref": "#/components/parameters/order_by" }, { "$ref": "#/components/parameters/order_direction" }, { "$ref": "#/components/parameters/per_page" } ], "responses": { "200": { "description": "list of scripts categories", "content": { "application/json": { "schema": { "properties": { "data": { "description": "Display a listing of the Script Categories.", "type": "array", "items": { "$ref": "#/components/schemas/ScriptCategory" } }, "meta": { "description": "Display a listing of the Script Categories.", "type": "object" } }, "type": "object" } } } } } }, "post": { "tags": [ "Script Categories" ], "summary": "Save a new Script Category", "operationId": "createScriptCategory", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ScriptCategoryEditable" } } } }, "responses": { "201": { "description": "success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ScriptCategory" } } } } } } }, "/script_categories/{script_category_id}": { "get": { "tags": [ "Script Categories" ], "summary": "Get single script category by ID", "operationId": "getScriptCategoryById", "parameters": [ { "name": "script_category_id", "in": "path", "description": "ID of script category to return", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successfully found the script", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ScriptCategory" } } } } } }, "put": { "tags": [ "Script Categories" ], "summary": "Update a script Category", "operationId": "updateScriptCategory", "parameters": [ { "name": "script_category_id", "in": "path", "description": "ID of script category to return", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ScriptCategoryEditable" } } } }, "responses": { "200": { "description": "success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ScriptCategory" } } } } } }, "delete": { "tags": [ "Script Categories" ], "summary": "Delete a script category", "operationId": "deleteScriptCategory", "parameters": [ { "name": "script_category_id", "in": "path", "description": "ID of script category to return", "required": true, "schema": { "type": "string" } } ], "responses": { "204": { "description": "success" } } } }, "/scripts": { "get": { "tags": [ "Scripts" ], "summary": "Returns all scripts that the user has access to", "operationId": "getScripts", "parameters": [ { "$ref": "#/components/parameters/filter" }, { "$ref": "#/components/parameters/order_by" }, { "$ref": "#/components/parameters/order_direction" }, { "$ref": "#/components/parameters/per_page" }, { "$ref": "#/components/parameters/include" } ], "responses": { "200": { "description": "list of scripts", "content": { "application/json": { "schema": { "properties": { "data": { "description": "Get a list of scripts in a process.", "type": "array", "items": { "$ref": "#/components/schemas/scripts" } }, "meta": { "description": "Get a list of scripts in a process.", "type": "object" } }, "type": "object" } } } } } }, "post": { "tags": [ "Scripts" ], "summary": "Save a new script", "operationId": "createScript", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/scriptsEditable" } } } }, "responses": { "201": { "description": "success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/scripts" } } } } } } }, "/scripts/{script_id}/preview": { "post": { "tags": [ "Scripts" ], "summary": "Test script code without saving it", "operationId": "previewScript", "parameters": [ { "name": "script_id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "properties": { "data": { "description": "Previews executing a script, with sample data/config data", "type": "array", "items": { "type": "object" } }, "config": { "description": "Previews executing a script, with sample data/config data", "type": "array", "items": { "type": "object" } }, "code": { "description": "Previews executing a script, with sample data/config data", "type": "string" }, "nonce": { "description": "Previews executing a script, with sample data/config data", "type": "string" } }, "type": "object" } } } }, "responses": { "200": { "description": "success if the script was queued" } } } }, "/scripts/execute/{script_id}": { "post": { "tags": [ "Scripts" ], "summary": "Execute script", "operationId": "executeScript", "parameters": [ { "name": "script_id", "in": "path", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "properties": { "data": { "description": "Executes a script, with sample data/config data", "type": "array", "items": { "type": "object" } }, "config": { "description": "Executes a script, with sample data/config data", "type": "array", "items": { "type": "object" } } }, "type": "object" } } } }, "responses": { "200": { "description": "success if the script was queued", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/scriptsPreview" } } } } } } }, "/scripts/execution/{key}": { "get": { "tags": [ "Scripts" ], "summary": "Get the response of a script execution by execution key", "operationId": "getScriptExecutionResponse", "parameters": [ { "name": "key", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "response of a script execution", "content": { "application/json": { "schema": {} } } } } } }, "/scripts/{script_id}": { "get": { "tags": [ "Scripts" ], "summary": "Get single script by ID", "operationId": "getScriptsById", "parameters": [ { "name": "script_id", "in": "path", "description": "ID of script to return", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successfully found the script", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/scripts" } } } } } }, "put": { "tags": [ "Scripts" ], "summary": "Update a script", "operationId": "updateScript", "parameters": [ { "name": "script_id", "in": "path", "description": "ID of script to return", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/scriptsEditable" } } } }, "responses": { "204": { "description": "success" } } }, "delete": { "tags": [ "Scripts" ], "summary": "Delete a script", "operationId": "deleteScript", "parameters": [ { "name": "script_id", "in": "path", "description": "ID of script to return", "required": true, "schema": { "type": "string" } } ], "responses": { "204": { "description": "success" } } } }, "/scripts/{scripts_id}/duplicate": { "put": { "tags": [ "Scripts" ], "summary": "duplicate a script", "operationId": "duplicateScript", "parameters": [ { "name": "scripts_id", "in": "path", "description": "ID of script to return", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/scriptsEditable" } } } }, "responses": { "201": { "description": "success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/scripts" } } } } } } }, "/tasks": { "get": { "tags": [ "Tasks" ], "summary": "Returns all tasks that the user has access to", "operationId": "getTasks", "parameters": [ { "name": "process_request_id", "in": "query", "description": "Process request id", "required": false, "schema": { "type": "integer" } }, { "$ref": "#/components/parameters/filter" }, { "$ref": "#/components/parameters/order_by" }, { "$ref": "#/components/parameters/order_direction" }, { "$ref": "#/components/parameters/include" } ], "responses": { "200": { "description": "list of tasks", "content": { "application/json": { "schema": { "properties": { "data": { "description": "Display a listing of the resource.", "type": "array", "items": { "$ref": "#/components/schemas/processRequestToken" } }, "meta": { "$ref": "#/components/schemas/metadata" } }, "type": "object" } } } } } } }, "/tasks/{task_id}": { "get": { "tags": [ "Tasks" ], "summary": "Get a single task by ID", "operationId": "getTasksById", "parameters": [ { "name": "task_id", "in": "path", "description": "task id", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/processRequestToken" } } } }, "404": { "$ref": "#/components/responses/404" } } }, "put": { "tags": [ "Tasks" ], "summary": "Update a task", "operationId": "updateTask", "parameters": [ { "name": "task_id", "in": "path", "description": "ID of task to update", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "required": [ "status", "data" ], "properties": { "status": { "description": "Updates the current element", "type": "string", "example": "COMPLETED" }, "data": { "description": "Updates the current element", "type": "object" } }, "type": "object" } } } }, "responses": { "200": { "description": "success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/processRequestToken" } } } }, "404": { "$ref": "#/components/responses/404" }, "422": { "$ref": "#/components/responses/422" } } } }, "/users": { "get": { "tags": [ "Users" ], "summary": "Returns all users", "operationId": "getUsers", "parameters": [ { "$ref": "#/components/parameters/status" }, { "$ref": "#/components/parameters/filter" }, { "$ref": "#/components/parameters/order_by" }, { "$ref": "#/components/parameters/order_direction" }, { "$ref": "#/components/parameters/per_page" }, { "$ref": "#/components/parameters/include" } ], "responses": { "200": { "description": "list of users", "content": { "application/json": { "schema": { "properties": { "data": { "description": "Display a listing of the resource.", "type": "array", "items": { "$ref": "#/components/schemas/users" } }, "meta": { "$ref": "#/components/schemas/metadata" } }, "type": "object" } } } } } }, "post": { "tags": [ "Users" ], "summary": "Save a new users", "operationId": "createUser", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/usersEditable" } } } }, "responses": { "201": { "description": "success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/users" } } } }, "422": { "$ref": "#/components/responses/422" } } } }, "/users/{user_id}": { "get": { "tags": [ "Users" ], "summary": "Get single user by ID", "operationId": "getUserById", "parameters": [ { "name": "user_id", "in": "path", "description": "ID of user to return", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Successfully found the process", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/users" } } } }, "404": { "$ref": "#/components/responses/404" } } }, "put": { "tags": [ "Users" ], "summary": "Update a user", "operationId": "updateUser", "parameters": [ { "name": "user_id", "in": "path", "description": "ID of user to return", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/usersEditable" } } } }, "responses": { "204": { "description": "success" }, "404": { "$ref": "#/components/responses/404" }, "422": { "$ref": "#/components/responses/422" } } }, "delete": { "tags": [ "Users" ], "summary": "Delete a user", "operationId": "deleteUser", "parameters": [ { "name": "user_id", "in": "path", "description": "ID of user to delete", "required": true, "schema": { "type": "integer" } } ], "responses": { "204": { "description": "success" }, "404": { "$ref": "#/components/responses/404" } } } }, "/users/{user_id}/groups": { "put": { "tags": [ "Users" ], "summary": "Set the groups a users belongs to", "operationId": "updateUserGroups", "parameters": [ { "name": "user_id", "in": "path", "description": "ID of user", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/updateUserGroups" } } } }, "responses": { "204": { "description": "success" } } } }, "/users/restore": { "put": { "tags": [ "Users" ], "summary": "Restore a soft deleted user", "operationId": "restoreUser", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/restoreUser" } } } }, "responses": { "200": { "description": "success" } } } } }, "components": { "schemas": { "DateTime": { "properties": { "date": { "type": "string" } }, "type": "object" }, "columns": { "properties": { "label": { "type": "string" }, "field": { "type": "string" }, "sortable": { "type": "boolean" }, "default": { "type": "boolean" }, "format": { "type": "string" }, "mask": { "type": "string" } }, "type": "object" }, "commentsEditable": { "properties": { "id": { "description": "Represents a business process definition.", "type": "string", "format": "id" }, "user_id": { "description": "Represents a business process definition.", "type": "string", "format": "id" }, "commentable_id": { "description": "Represents a business process definition.", "type": "string", "format": "id" }, "commentable_type": { "description": "Represents a business process definition.", "type": "string" }, "up": { "description": "Represents a business process definition.", "type": "integer" }, "down": { "description": "Represents a business process definition.", "type": "integer" }, "subject": { "description": "Represents a business process definition.", "type": "string" }, "body": { "description": "Represents a business process definition.", "type": "string" }, "hidden": { "description": "Represents a business process definition.", "type": "boolean" }, "type": { "description": "Represents a business process definition.", "type": "string", "enum": [ "LOG", "MESSAGE" ] } }, "type": "object" }, "comments": { "properties": { "created_at": { "description": "Represents a business process definition.", "type": "string", "format": "date-time" }, "updated_at": { "description": "Represents a business process definition.", "type": "string", "format": "date-time" } }, "type": "object", "allOf": [ { "$ref": "#/components/schemas/commentsEditable" } ] }, "EnvironmentVariableEditable": { "properties": { "name": { "type": "string" }, "description": { "type": "string" }, "value": { "type": "string" } }, "type": "object" }, "EnvironmentVariable": { "allOf": [ { "$ref": "#/components/schemas/EnvironmentVariableEditable" }, { "properties": { "id": { "type": "integer", "format": "id" }, "created_at": { "type": "string", "format": "date-time" }, "updated_at": { "type": "string", "format": "date-time" } }, "type": "object" } ] }, "groupsEditable": { "properties": { "name": { "description": "Represents a group definition.", "type": "string" }, "description": { "description": "Represents a group definition.", "type": "string" }, "status": { "description": "Represents a group definition.", "type": "string", "enum": [ "ACTIVE", "INACTIVE" ] } }, "type": "object" }, "groups": { "allOf": [ { "$ref": "#/components/schemas/groupsEditable" }, { "properties": { "created_at": { "description": "Represents a group definition.", "type": "string", "format": "date-time" }, "updated_at": { "description": "Represents a group definition.", "type": "string", "format": "date-time" }, "id": { "description": "Represents a group definition.", "type": "string", "format": "id" } }, "type": "object" } ] }, "groupMembersEditable": { "properties": { "group_id": { "description": "Represents a group Members definition.", "type": "string", "format": "id" }, "member_id": { "description": "Represents a group Members definition.", "type": "string", "format": "id" }, "member_type": { "description": "Represents a group Members definition.", "type": "string" }, "description": { "description": "Represents a group Members definition.", "type": "string" } }, "type": "object" }, "groupMembers": { "allOf": [ { "$ref": "#/components/schemas/groupMembersEditable" }, { "properties": { "id": { "description": "Represents a group Members definition.", "type": "string", "format": "id" }, "created_at": { "description": "Represents a group Members definition.", "type": "string", "format": "date-time" }, "updated_at": { "description": "Represents a group Members definition.", "type": "string", "format": "date-time" } }, "type": "object" } ] }, "createGroupMembers": { "allOf": [ { "$ref": "#/components/schemas/groupMembersEditable" }, { "properties": { "id": { "description": "Represents a group Members definition.", "type": "string", "format": "id" }, "group": { "description": "Represents a group Members definition.", "type": "object" }, "member": { "description": "Represents a group Members definition.", "type": "object" }, "created_at": { "description": "Represents a group Members definition.", "type": "string", "format": "date-time" }, "updated_at": { "description": "Represents a group Members definition.", "type": "string", "format": "date-time" } }, "type": "object" } ] }, "getGroupMembersById": { "allOf": [ { "properties": { "group_id": { "description": "Represents a group Members definition.", "type": "string", "format": "id" }, "member_id": { "description": "Represents a group Members definition.", "type": "string", "format": "id" }, "member_type": { "description": "Represents a group Members definition.", "type": "string" }, "id": { "description": "Represents a group Members definition.", "type": "string", "format": "id" }, "created_at": { "description": "Represents a group Members definition.", "type": "string", "format": "date-time" }, "updated_at": { "description": "Represents a group Members definition.", "type": "string", "format": "date-time" } }, "type": "object" } ] }, "availableGroupMembers": { "allOf": [ { "properties": { "id": { "description": "Represents a group Members definition.", "type": "string", "format": "id" }, "description": { "description": "Represents a group Members definition.", "type": "string" }, "name": { "description": "Represents a group Members definition.", "type": "string" }, "status": { "description": "Represents a group Members definition.", "type": "string", "enum": [ "ACTIVE", "INACTIVE" ] }, "created_at": { "description": "Represents a group Members definition.", "type": "string", "format": "date-time" }, "updated_at": { "description": "Represents a group Members definition.", "type": "string", "format": "date-time" } }, "type": "object" } ] }, "mediaEditable": { "properties": { "id": { "description": "Represents media files stored in the database", "type": "integer", "format": "id" }, "model_id": { "description": "Represents media files stored in the database", "type": "integer", "format": "id" }, "model_type": { "description": "Represents media files stored in the database", "type": "string", "format": "id" }, "collection_name": { "description": "Represents media files stored in the database", "type": "string" }, "name": { "description": "Represents media files stored in the database", "type": "string" }, "file_name": { "description": "Represents media files stored in the database", "type": "string" }, "mime_type": { "description": "Represents media files stored in the database", "type": "string" }, "disk": { "description": "Represents media files stored in the database", "type": "string" }, "size": { "description": "Represents media files stored in the database", "type": "integer" }, "manipulations": { "description": "Represents media files stored in the database", "type": "object" }, "custom_properties": { "description": "Represents media files stored in the database", "type": "object" }, "responsive_images": { "description": "Represents media files stored in the database", "type": "object" }, "order_column": { "description": "Represents media files stored in the database", "type": "integer" } }, "type": "object" }, "media": { "properties": { "created_at": { "description": "Represents media files stored in the database", "type": "string", "format": "date-time" }, "updated_at": { "description": "Represents media files stored in the database", "type": "string", "format": "date-time" } }, "type": "object", "allOf": [ { "$ref": "#/components/schemas/mediaEditable" } ] }, "mediaExported": { "properties": { "url": { "description": "Represents media files stored in the database", "type": "string" } }, "type": "object" }, "NotificationEditable": { "properties": { "type": { "description": "Represents a notification definition.", "type": "string" }, "notifiable_type": { "description": "Represents a notification definition.", "type": "string" }, "notifiable_id": { "description": "Represents a notification definition.", "type": "integer" }, "data": { "description": "Represents a notification definition.", "type": "string" }, "name": { "description": "Represents a notification definition.", "type": "string" }, "message": { "description": "Represents a notification definition.", "type": "string" }, "processName": { "description": "Represents a notification definition.", "type": "string" }, "userName": { "description": "Represents a notification definition.", "type": "string" }, "request_id": { "description": "Represents a notification definition.", "type": "string" } }, "type": "object" }, "Notification": { "allOf": [ { "$ref": "#/components/schemas/NotificationEditable" }, { "properties": { "id": { "description": "Represents a notification definition.", "type": "string" }, "read_at": { "description": "Represents a notification definition.", "type": "string", "format": "date-time" }, "created_at": { "description": "Represents a notification definition.", "type": "string", "format": "date-time" }, "updated_at": { "description": "Represents a notification definition.", "type": "string", "format": "date-time" } }, "type": "object" } ] }, "ProcessEditable": { "properties": { "process_category_id": { "description": "Represents a business process definition.", "type": "integer", "format": "id" }, "name": { "description": "Represents a business process definition.", "type": "string" }, "description": { "description": "Represents a business process definition.", "type": "string" }, "status": { "description": "Represents a business process definition.", "type": "string", "enum": [ "ACTIVE", "INACTIVE" ] }, "pause_timer_start": { "description": "Represents a business process definition.", "type": "integer" }, "cancel_screen_id": { "description": "Represents a business process definition.", "type": "integer" }, "has_timer_start_events": { "description": "Represents a business process definition.", "type": "boolean" }, "request_detail_screen_id": { "description": "Represents a business process definition.", "type": "integer", "format": "id" }, "is_valid": { "description": "Represents a business process definition.", "type": "integer" }, "package_key": { "description": "Represents a business process definition.", "type": "string" }, "start_events": { "description": "Represents a business process definition.", "type": "array", "items": { "$ref": "#/components/schemas/ProcessStartEvents" } }, "warnings": { "description": "Represents a business process definition.", "type": "string" }, "self_service_tasks": { "description": "Represents a business process definition.", "type": "array", "items": { "type": "object" } }, "signal_events": { "description": "Represents a business process definition.", "type": "array", "items": { "type": "object" } }, "category": { "description": "Represents a business process definition." } }, "type": "object" }, "Process": { "allOf": [ { "$ref": "#/components/schemas/ProcessEditable" }, { "properties": { "user_id": { "description": "Represents a business process definition.", "type": "integer", "format": "id" }, "id": { "description": "Represents a business process definition.", "type": "string", "format": "id" }, "deleted_at": { "description": "Represents a business process definition.", "type": "string", "format": "date-time" }, "created_at": { "description": "Represents a business process definition.", "type": "string", "format": "date-time" }, "updated_at": { "description": "Represents a business process definition.", "type": "string", "format": "date-time" }, "notifications": { "description": "Represents a business process definition.", "type": "object" }, "task_notifications": { "description": "Represents a business process definition.", "type": "object" } }, "type": "object" } ] }, "ProcessStartEvents": {}, "ProcessWithStartEvents": { "allOf": [ { "$ref": "#/components/schemas/Process" }, { "properties": { "events": { "description": "Represents a business process definition.", "type": "array", "items": { "$ref": "#/components/schemas/ProcessStartEvents" } } }, "type": "object" } ] }, "ProcessImport": { "allOf": [ { "$ref": "#/components/schemas/ProcessEditable" }, { "properties": { "status": { "description": "Represents a business process definition.", "type": "array", "items": { "type": "object" } }, "assignable": { "description": "Represents a business process definition.", "type": "array", "items": { "type": "object" } }, "process": { "description": "Represents a business process definition." } }, "type": "object" } ] }, "ProcessAssignments": { "properties": { "assignable": { "description": "Represents a business process definition.", "type": "array", "items": { "type": "object" } }, "cancel_request": { "description": "Represents a business process definition.", "type": "object" }, "edit_data": { "description": "Represents a business process definition.", "type": "object" } }, "type": "object" }, "ProcessCategoryEditable": { "properties": { "name": { "description": "Represents a business process category definition.", "type": "string" }, "status": { "description": "Represents a business process category definition.", "type": "string", "enum": [ "ACTIVE", "INACTIVE" ] } }, "type": "object" }, "ProcessCategory": { "allOf": [ { "$ref": "#/components/schemas/ProcessCategoryEditable" }, { "properties": { "id": { "description": "Represents a business process category definition.", "type": "string", "format": "id" }, "created_at": { "description": "Represents a business process category definition.", "type": "string", "format": "date-time" }, "updated_at": { "description": "Represents a business process category definition.", "type": "string", "format": "date-time" } }, "type": "object" } ] }, "processPermissionsEditable": { "properties": { "id": { "description": "Represents a Process permission.", "type": "integer", "format": "id" }, "process_id": { "description": "Represents a Process permission.", "type": "integer", "format": "id" }, "permission_id": { "description": "Represents a Process permission.", "type": "integer", "format": "id" }, "assignable_id": { "description": "Represents a Process permission.", "type": "integer", "format": "id" }, "assignable_type": { "description": "Represents a Process permission.", "type": "string" } }, "type": "object" }, "processPermissions": { "properties": { "created_at": { "description": "Represents a Process permission.", "type": "string", "format": "date-time" }, "updated_at": { "description": "Represents a Process permission.", "type": "string", "format": "date-time" } }, "type": "object", "allOf": [ { "$ref": "#/components/schemas/processPermissionsEditable" } ] }, "processRequestEditable": { "properties": { "user_id": { "description": "Represents an Eloquent model of a Request which is an instance of a Process.", "type": "string", "format": "id" }, "callable_id": { "description": "Represents an Eloquent model of a Request which is an instance of a Process.", "type": "string", "format": "id" }, "data": { "description": "Represents an Eloquent model of a Request which is an instance of a Process.", "type": "object" }, "status": { "description": "Represents an Eloquent model of a Request which is an instance of a Process.", "type": "string", "enum": [ "ACTIVE", "COMPLETED", "ERROR", "CANCELED" ] }, "name": { "description": "Represents an Eloquent model of a Request which is an instance of a Process.", "type": "string" }, "process_id": { "description": "Represents an Eloquent model of a Request which is an instance of a Process.", "type": "integer" }, "process": { "description": "Represents an Eloquent model of a Request which is an instance of a Process.", "type": "object" } }, "type": "object" }, "processRequest": { "allOf": [ { "$ref": "#/components/schemas/processRequestEditable" }, { "properties": { "id": { "description": "Represents an Eloquent model of a Request which is an instance of a Process.", "type": "string", "format": "id" }, "process_id": { "description": "Represents an Eloquent model of a Request which is an instance of a Process.", "type": "string", "format": "id" }, "process_collaboration_id": { "description": "Represents an Eloquent model of a Request which is an instance of a Process.", "type": "string", "format": "id" }, "participant_id": { "description": "Represents an Eloquent model of a Request which is an instance of a Process.", "type": "string", "format": "id" }, "process_category_id": { "description": "Represents an Eloquent model of a Request which is an instance of a Process.", "type": "string", "format": "id" }, "created_at": { "description": "Represents an Eloquent model of a Request which is an instance of a Process.", "type": "string", "format": "date-time" }, "updated_at": { "description": "Represents an Eloquent model of a Request which is an instance of a Process.", "type": "string", "format": "date-time" }, "user": { "description": "Represents an Eloquent model of a Request which is an instance of a Process." }, "participants": { "description": "Represents an Eloquent model of a Request which is an instance of a Process.", "type": "array", "items": { "$ref": "#/components/schemas/users" } } }, "type": "object" } ] }, "processRequestTokenEditable": { "properties": { "user_id": { "description": "ProcessRequestToken is used to store the state of a token of the\nNayra engine", "type": "string", "format": "id" }, "status": { "description": "ProcessRequestToken is used to store the state of a token of the\nNayra engine", "type": "string" }, "due_at": { "description": "ProcessRequestToken is used to store the state of a token of the\nNayra engine", "type": "date-time" }, "initiated_at": { "description": "ProcessRequestToken is used to store the state of a token of the\nNayra engine", "type": "string", "format": "date-time" }, "riskchanges_at": { "description": "ProcessRequestToken is used to store the state of a token of the\nNayra engine", "type": "string", "format": "date-time" }, "subprocess_start_event_id": { "description": "ProcessRequestToken is used to store the state of a token of the\nNayra engine", "type": "string" }, "data": { "description": "ProcessRequestToken is used to store the state of a token of the\nNayra engine", "type": "object" } }, "type": "object" }, "processRequestToken": { "allOf": [ { "$ref": "#/components/schemas/processRequestTokenEditable" }, { "properties": { "id": { "description": "ProcessRequestToken is used to store the state of a token of the\nNayra engine", "type": "string", "format": "id" }, "process_id": { "description": "ProcessRequestToken is used to store the state of a token of the\nNayra engine", "type": "string", "format": "id" }, "process_request_id": { "description": "ProcessRequestToken is used to store the state of a token of the\nNayra engine", "type": "string", "format": "id" }, "element_id": { "description": "ProcessRequestToken is used to store the state of a token of the\nNayra engine", "type": "string", "format": "id" }, "element_type": { "description": "ProcessRequestToken is used to store the state of a token of the\nNayra engine", "type": "string", "format": "id" }, "element_index": { "description": "ProcessRequestToken is used to store the state of a token of the\nNayra engine", "type": "string" }, "element_name": { "description": "ProcessRequestToken is used to store the state of a token of the\nNayra engine", "type": "string" }, "created_at": { "description": "ProcessRequestToken is used to store the state of a token of the\nNayra engine", "type": "string", "format": "date-time" }, "updated_at": { "description": "ProcessRequestToken is used to store the state of a token of the\nNayra engine", "type": "string", "format": "date-time" }, "initiated_at": { "description": "ProcessRequestToken is used to store the state of a token of the\nNayra engine", "type": "string", "format": "date-time" }, "advanceStatus": { "description": "ProcessRequestToken is used to store the state of a token of the\nNayra engine", "type": "string" }, "due_notified": { "description": "ProcessRequestToken is used to store the state of a token of the\nNayra engine", "type": "integer" }, "user": { "description": "ProcessRequestToken is used to store the state of a token of the\nNayra engine" }, "process": { "description": "ProcessRequestToken is used to store the state of a token of the\nNayra engine" }, "process_request": { "description": "ProcessRequestToken is used to store the state of a token of the\nNayra engine" } }, "type": "object" } ] }, "taskAssignmentsEditable": { "properties": { "process_id": { "description": "Represents a business process task assignment definition.", "type": "string", "format": "id" }, "process_task_id": { "description": "Represents a business process task assignment definition.", "type": "string", "format": "id" }, "assignment_id": { "description": "Represents a business process task assignment definition.", "type": "string", "format": "id" }, "assignment_type": { "description": "Represents a business process task assignment definition.", "type": "string", "enum": [ "ProcessMaker\\Models\\User", "ProcessMaker\\Models\\Group" ] } }, "type": "object" }, "taskAssignments": { "properties": { "id": { "description": "Represents a business process task assignment definition.", "type": "string", "format": "id" }, "created_at": { "description": "Represents a business process task assignment definition.", "type": "string", "format": "date-time" }, "updated_at": { "description": "Represents a business process task assignment definition.", "type": "string", "format": "date-time" } }, "type": "object", "allOf": [ { "$ref": "#/components/schemas/taskAssignmentsEditable" } ] }, "screensEditable": { "properties": { "title": { "description": "Class Screen", "type": "string" }, "type": { "description": "Class Screen", "type": "string" }, "description": { "description": "Class Screen", "type": "string" }, "config": { "description": "Class Screen", "type": "array", "items": { "type": "object" } }, "computed": { "description": "Class Screen", "type": "array", "items": { "type": "object" } }, "watchers": { "description": "Class Screen", "type": "array", "items": { "type": "object" } }, "custom_css": { "description": "Class Screen", "type": "string" }, "screen_category_id": { "description": "Class Screen", "type": "string" } }, "type": "object" }, "screens": { "allOf": [ { "$ref": "#/components/schemas/screensEditable" }, { "properties": { "id": { "description": "Class Screen", "type": "string", "format": "id" }, "created_at": { "description": "Class Screen", "type": "string", "format": "date-time" }, "updated_at": { "description": "Class Screen", "type": "string", "format": "date-time" } }, "type": "object" } ] }, "screenExported": { "properties": { "url": { "description": "Class Screen", "type": "string" } }, "type": "object" }, "ScreenCategoryEditable": { "properties": { "name": { "description": "Represents a business screen category definition.", "type": "string" }, "status": { "description": "Represents a business screen category definition.", "type": "string", "enum": [ "ACTIVE", "INACTIVE" ] } }, "type": "object" }, "ScreenCategory": { "allOf": [ { "$ref": "#/components/schemas/ScreenCategoryEditable" }, { "properties": { "id": { "description": "Represents a business screen category definition.", "type": "string", "format": "id" }, "created_at": { "description": "Represents a business screen category definition.", "type": "string", "format": "date-time" }, "updated_at": { "description": "Represents a business screen category definition.", "type": "string", "format": "date-time" } }, "type": "object" } ] }, "ScreenTypeEditable": { "properties": { "name": { "description": "Represents a business screen Type definition.", "type": "string" } }, "type": "object" }, "ScreenType": { "allOf": [ { "$ref": "#/components/schemas/ScreenTypeEditable" }, { "properties": { "id": { "description": "Represents a business screen Type definition.", "type": "string", "format": "id" } }, "type": "object" } ] }, "scriptsEditable": { "properties": { "title": { "description": "Represents an Eloquent model of a Script", "type": "string" }, "description": { "description": "Represents an Eloquent model of a Script", "type": "string" }, "language": { "description": "Represents an Eloquent model of a Script", "type": "string" }, "code": { "description": "Represents an Eloquent model of a Script", "type": "string" }, "timeout": { "description": "Represents an Eloquent model of a Script", "type": "integer" }, "run_as_user_id": { "description": "Represents an Eloquent model of a Script", "type": "integer" }, "key": { "description": "Represents an Eloquent model of a Script", "type": "string" }, "script_category_id": { "description": "Represents an Eloquent model of a Script", "type": "integer" } }, "type": "object" }, "scripts": { "allOf": [ { "$ref": "#/components/schemas/scriptsEditable" }, { "properties": { "id": { "description": "Represents an Eloquent model of a Script", "type": "integer", "format": "id" }, "created_at": { "description": "Represents an Eloquent model of a Script", "type": "string", "format": "date-time" }, "updated_at": { "description": "Represents an Eloquent model of a Script", "type": "string", "format": "date-time" } }, "type": "object" } ] }, "scriptsPreview": { "properties": { "status": { "description": "Represents an Eloquent model of a Script", "type": "string" }, "key": { "description": "Represents an Eloquent model of a Script", "type": "string" } }, "type": "object" }, "ScriptCategoryEditable": { "properties": { "name": { "description": "Represents a business script category definition.", "type": "string" }, "status": { "description": "Represents a business script category definition.", "type": "string", "enum": [ "ACTIVE", "INACTIVE" ] } }, "type": "object" }, "ScriptCategory": { "allOf": [ { "$ref": "#/components/schemas/ScriptCategoryEditable" }, { "properties": { "id": { "description": "Represents a business script category definition.", "type": "string", "format": "id" }, "created_at": { "description": "Represents a business script category definition.", "type": "string", "format": "date-time" }, "updated_at": { "description": "Represents a business script category definition.", "type": "string", "format": "date-time" } }, "type": "object" } ] }, "settingsEditable": { "properties": { "key": { "description": "Class Settings", "type": "string" }, "config": { "description": "Class Settings", "type": "array", "items": { "type": "object" } }, "variables": { "description": "Class Settings", "type": "string" }, "sansSerifFont": { "description": "Class Settings", "type": "string" } }, "type": "object" }, "settings": { "allOf": [ { "$ref": "#/components/schemas/settingsEditable" }, { "properties": { "id": { "description": "Class Settings", "type": "string", "format": "id" }, "created_at": { "description": "Class Settings", "type": "string", "format": "date-time" }, "updated_at": { "description": "Class Settings", "type": "string", "format": "date-time" } }, "type": "object" } ] }, "usersEditable": { "properties": { "email": { "description": "The attributes that are mass assignable.", "type": "string", "format": "email" }, "firstname": { "description": "The attributes that are mass assignable.", "type": "string" }, "lastname": { "description": "The attributes that are mass assignable.", "type": "string" }, "username": { "description": "The attributes that are mass assignable.", "type": "string" }, "password": { "description": "The attributes that are mass assignable.", "type": "string" }, "address": { "description": "The attributes that are mass assignable.", "type": "string" }, "city": { "description": "The attributes that are mass assignable.", "type": "string" }, "state": { "description": "The attributes that are mass assignable.", "type": "string" }, "postal": { "description": "The attributes that are mass assignable.", "type": "string" }, "country": { "description": "The attributes that are mass assignable.", "type": "string" }, "phone": { "description": "The attributes that are mass assignable.", "type": "string" }, "fax": { "description": "The attributes that are mass assignable.", "type": "string" }, "cell": { "description": "The attributes that are mass assignable.", "type": "string" }, "title": { "description": "The attributes that are mass assignable.", "type": "string" }, "timezone": { "description": "The attributes that are mass assignable.", "type": "string" }, "datetime_format": { "description": "The attributes that are mass assignable.", "type": "string" }, "language": { "description": "The attributes that are mass assignable.", "type": "string" }, "is_administrator": { "description": "The attributes that are mass assignable.", "type": "boolean" }, "expires_at": { "description": "The attributes that are mass assignable.", "type": "string" }, "loggedin_at": { "description": "The attributes that are mass assignable.", "type": "string" }, "remember_token": { "description": "The attributes that are mass assignable.", "type": "string" }, "status": { "description": "The attributes that are mass assignable.", "type": "string", "enum": [ "ACTIVE", "INACTIVE" ] }, "fullname": { "description": "The attributes that are mass assignable.", "type": "string" }, "avatar": { "description": "The attributes that are mass assignable.", "type": "string" }, "media": { "description": "The attributes that are mass assignable.", "type": "array", "items": { "$ref": "#/components/schemas/media" } }, "birthdate": { "description": "The attributes that are mass assignable.", "type": "string", "format": "date" } }, "type": "object" }, "users": { "allOf": [ { "$ref": "#/components/schemas/usersEditable" }, { "properties": { "id": { "description": "The attributes that are mass assignable.", "type": "integer" }, "created_at": { "description": "The attributes that are mass assignable.", "type": "string", "format": "date-time" }, "updated_at": { "description": "The attributes that are mass assignable.", "type": "string", "format": "date-time" }, "deleted_at": { "description": "The attributes that are mass assignable.", "type": "string", "format": "date-time" } }, "type": "object" } ] }, "updateUserGroups": { "properties": { "groups": { "description": "Update a user's groups", "type": "array", "items": { "type": "integer", "example": 1 } } }, "type": "object" }, "restoreUser": { "properties": { "username": { "description": "Username to restore", "type": "string" } }, "type": "object" }, "metadata": { "properties": { "filter": { "type": "string" }, "sort_by": { "type": "string" }, "sort_order": { "type": "string", "enum": [ "asc", "desc" ] }, "count": { "type": "integer" }, "total_pages": { "type": "integer" }, "current_page": { "type": "integer" }, "form": { "type": "integer" }, "last_page": { "type": "integer" }, "path": { "type": "string" }, "per_page": { "type": "integer" }, "to": { "type": "integer" }, "total": { "type": "integer" } }, "type": "object" }, "taskMetadata": { "allOf": [ { "$ref": "#/components/schemas/metadata" }, { "properties": { "filter": { "type": "string" }, "sort_by": { "type": "string" }, "sort_order": { "type": "string", "enum": [ "asc", "desc" ] }, "count": { "type": "integer" }, "total_pages": { "type": "integer" }, "current_page": { "type": "integer" }, "form": { "type": "integer" }, "last_page": { "type": "integer" }, "path": { "type": "string" }, "per_page": { "type": "integer" }, "to": { "type": "integer" }, "total": { "type": "integer" }, "in_overdue": { "type": "integer" } }, "type": "object" } ] } }, "responses": { "404": { "description": "Not Found", "content": { "application/json": { "schema": { "properties": { "error": { "type": "string" } }, "type": "object" } } } }, "422": { "description": "Unprocessable Entity", "content": { "application/json": { "schema": { "properties": { "message": { "type": "string" }, "errors": { "type": "object" } }, "type": "object" } } } } }, "parameters": { "filter": { "name": "filter", "in": "query", "description": "Filter results by string. Searches Name, Description, and Status. Status must match exactly. Others can be a substring.", "schema": { "type": "string" } }, "order_by": { "name": "order_by", "in": "query", "description": "Field to order results by", "schema": { "type": "string" } }, "status": { "name": "status", "in": "query", "description": "ACTIVE or INACTIVE", "schema": { "type": "string", "enum": [ "ACTIVE", "INACTIVE" ] } }, "order_direction": { "name": "order_direction", "in": "query", "schema": { "type": "string", "default": "asc", "enum": [ "asc", "desc" ] } }, "per_page": { "name": "per_page", "in": "query", "schema": { "type": "integer", "default": "10" } }, "include": { "name": "include", "in": "query", "description": "Include data from related models in payload. Comma separated list.", "schema": { "type": "string", "default": "" } }, "member_id": { "name": "member_id", "in": "query", "schema": { "type": "integer" } }, "commentable_id": { "name": "commentable_id", "in": "query", "schema": { "type": "integer" } }, "commentable_type": { "name": "commentable_type", "in": "query", "schema": { "type": "string", "default": "" } } }, "securitySchemes": { "pm_api_auth_code": { "type": "oauth2", "flows": { "authorizationCode": { "authorizationUrl": "/oauth/authorize", "tokenUrl": "/oauth/token", "scopes": { "*": "" } } } }, "pm_api_bearer": { "type": "http", "scheme": "bearer", "bearerFormat": "JWT" }, "pm_api_key": { "type": "apiKey", "in": "header", "name": "Authorization" } } }, "security": [ { "pm_api_auth_code": [] }, { "pm_api_bearer": [] }, { "pm_api_key": [] } ] }