Seliom
Español
Español
  • Bienvenido a Seliom
  • Empezar con Seliom
    • Tutorial de Inicio
      • Añadir miembros al equipo
      • Cómo diseñar tu primer proceso
      • Crea tu proceso con Seliom
      • Lanza tu proceso Seliom
  • API
    • Introducción
    • Authorización
    • Procesos
    • Casos
  • Resources
    • ¿Por qué usar Seliom?
    • Preguntas Frecuentes
Powered by GitBook
On this page
  • Index
  • Show Case
  • List Case Documents
  • Create New Case
  • Pause Case
  • Stop Case
  • Resume Case
  • Delete Case

Was this helpful?

  1. API

Casos

List of public endpoints for cases

Esta página aún no ha sido traducida al español.

Cases represent instances of your process templates. For example, if you have a process template called Purchase Order Approval, a case would be a specific purchase order that needs to be approved.

In Seliom's API, cases also receive the name of Process Instances.

Dont forget to include the Authorization and X-Organization headers in every request. They have been omitted from these endpoints for brevity.

Index

GET https://api.seliom.com/process_monitor/process_instances

This endpoint retrieves all the cases that the user has permissions to see.

Query Parameters

Name
Type
Description

sort_by

string

Sort the resulting cases by: status, newest, oldest.

created_before

string

Date in ISO 8601 to filter by.

created_after

string

Date in ISO 8601 to filter by.

status

array

Array of statuses to filter by: running, error, stopped, completed, paused.

process_type

array

Array of UUIDs of the process templates to filter by

cursor

string

Cursor used for pagination

{
    "processes": [
        "name": "My first time-off request",
        "created_at": "2021-02-22 18:37:25 UTC",
        "uuid": "23d6ff0b-717c-4712-b988-ab3e5c9732f3",
        "completed_date": null,
        "status": "running",
        "sequential_id": 1,
        "process_template": {
            "name": "Time-off Requests",
            "uuid": "5c7549b6-3f7b-4c96-8346-141326da5cf0",
            "launchable": true,
            "resource_type": "process",
            "automated": true
        }, 
        "launcher" : {
            "first_name": "Clark",
            "last_name": "Kent",
            "uuid": "3cd4ca21-fa4d-4bed-9217-fb495c748d0c"
        }
    ],
    "next_cursor": null,
    "prev_cursor": null, 
    "total": 1,
    "limit": 15,
    "page": 1
}

Show Case

GET https://api.seliom.com/process_monitor/process_instances/:process_instance_uuid

This endpoint retrieves a specific case and the permissions your user has for it.

Path Parameters

Name
Type
Description

process_instance_uuid

string

UUID of the process instance

{
    "process_instance": {
        "name": "My first time-off request",
        "created_at": "2021-02-22 18:37:25 UTC",
        "uuid": "23d6ff0b-717c-4712-b988-ab3e5c9732f3",
        "completed_date": null,
        "status": "running",
        "sequential_id": 1,
        "process_template": {
            "name": "Time-off Requests",
            "uuid": "5c7549b6-3f7b-4c96-8346-141326da5cf0",
            "launchable": true,
            "resource_type": "process",
            "automated": true
        }, 
        "launcher" : {
            "first_name": "Clark",
            "last_name": "Kent",
            "uuid": "3cd4ca21-fa4d-4bed-9217-fb495c748d0c"
        }
    },
    "permissions": [
        "Edit tasks",
        "Perform actions",
        "Delete instance",
        "Edit comments",
        "View process instance",
        "Manage case permissions",
        "Rollback case"
    ]
}
{
    "message": "You do not have permissions to view this process instance"
}
{
    "message": "Process instance not found"
}

List Case Documents

GET https://api.seliom.com/process_monitor/process_instances/:process_instance_uuid/documents

This endpoint retrieves all task submissions associated to a case that contain documents.

Path Parameters

Name
Type
Description

process_instance_uuid

string

UUID of the process instance

{
    "docs": [
        {
            "id": "a340197d-7eab-49d5-9880-1da29fefaa35",
            "status": "completed",
            "assignee_type": "member",
            "member": {
                "first_name": "Clark",
                "last_name": "Kent",
                "uuid": "23d6ff0b-717c-4712-b988-ab3e5c9732f3"
            },
            "task_definition": {
                 "id": "cade268a-443e-44d8-9c71-667079bb7ac5",
                 "name": "Upload customer documentation",
                 "task_type": "task"
            },
            "documents_info": [
                "field_name": "Customer documents",
                "content": {
                   "type": "attachment",
                   "files": [
                       {
                           "originalName": "mydocs.pdf",
                           "storageName": "cade268a-443e-44d8-9c71-667079bb7ac5/1572657277933_mydocs.pdf"
                       }
                   ]
                }
            ]
        }
    ]
}

Create New Case

POST https://api.seliom.com/process_instances

This endpoint creates a new case based on a given process template.

Request Body

Name
Type
Description

label

string

Label for the new case. Required if it has not been automated in the process template.

submission_elements

object

Form elements required to create a case for the given process template

process_template_uuid

string

UUID of the process template

{
    "message": "Process launched successfully!",
    "process_instance_uuid": "972a4cb0-8f4e-43b3-9e54-99c952f8531e"
}
{
    "message": "Please provide a label"
}
{
    "message": "You do not have permissions to launch this process"
}

Pause Case

PUT https://api.seliom.com/process_monitor/process_instances/:process_instance_uuid/pause

This endpoint pauses a process instance that is currently running.

{
    "message": "Your process instance has been paused"
}

Stop Case

PUT https://api.seliom.com/process_monitor/process_instances/:process_instance_uuid/stop

This endpoint stops a process instance that is currently running.

{
    "message": "Your process instance has been stopped"
}

Resume Case

PUT https://api.seliom.com/process_monitor/process_instances/:process_instance_uuid/resume

This endpoint resumes a process instance that was previously stopped or paused.

{
    "message": "Your process instance has been resumed"
}

Delete Case

DELETE https://api.seliom.com/process_monitor/process_instances/:process_instance_uuid

This endpoint permanently deletes a process instance.

{
    "message": "Your process instance has been deleted"
}
PreviousProcesosNext¿Por qué usar Seliom?

Last updated 4 years ago

Was this helpful?