Skip to main content

kiban-workfloo

API pública de Workfloo: ejecuta un workfloo, consulta su estatus y revisa el historial/detalle de ejecuciones. Todos los endpoints se autentican con el header x-api-key.

Ambientes: producción en https://workfloo.kiban.com y sandbox en https://sandbox.workfloo.kiban.com. El host sandbox activa ese modo de forma implícita y tiene precedencia: ahí el query param sandbox se ignora. Desde el host de producción se puede forzar el modo sandbox por request con sandbox=true.

This Python package is automatically generated by the OpenAPI Generator project:

  • API version: 1.0
  • Package version: 1.1.0
  • Generator version: 7.24.0
  • Build package: org.openapitools.codegen.languages.PythonClientCodegen For more information, please visit https://kiban.com

Requirements.

Python 3.10+

Installation & Usage

pip install

If the python package is hosted on a repository, you can install directly using:

pip install git+https://github.com/kiban-cloud/kiban-sdk.git

(you may need to run pip with root permission: sudo pip install git+https://github.com/kiban-cloud/kiban-sdk.git)

Then import the package:

import kiban.workfloo

Setuptools

Install via Setuptools.

python setup.py install --user

(or sudo python setup.py install to install the package for all users)

Then import the package:

import kiban.workfloo

Tests

Execute pytest to run the tests.

Getting Started

Please follow the installation procedure and then run the following:

import kiban.workfloo
from kiban.workfloo.rest import ApiException
from pprint import pprint

# Defining the host is optional and defaults to https://workfloo.kiban.com
# See configuration.py for a list of all supported configuration parameters.
configuration = kiban.workfloo.Configuration(
    host = "https://workfloo.kiban.com"
)

# The client must configure the authentication and authorization parameters
# in accordance with the API server security policy.
# Examples for each auth method are provided below, use the example that
# satisfies your auth use case.

# Configure API key authorization: ApiKeyAuth
configuration.api_key['ApiKeyAuth'] = os.environ["API_KEY"]

# Uncomment below to setup prefix (e.g. Bearer) for API key, if needed
# configuration.api_key_prefix['ApiKeyAuth'] = 'Bearer'


# Enter a context with an instance of the API client
with kiban.workfloo.ApiClient(configuration) as api_client:
    # Create an instance of the API class
    api_instance = kiban.workfloo.PoolApi(api_client)
    controller_pool_model_execute = kiban.workfloo.ControllerPoolModelExecute() # ControllerPoolModelExecute | Definición del pool y escenarios
    sandbox = True # bool | Fuerza el ambiente sandbox. Se ignora en el host sandbox, donde ya es implícito (optional)

    try:
        # Ejecutar un pool
        api_response = api_instance.execute_pool(controller_pool_model_execute, sandbox=sandbox)
        print("The response of PoolApi->execute_pool:\n")
        pprint(api_response)
    except ApiException as e:
        print("Exception when calling PoolApi->execute_pool: %s\n" % e)

Documentation for API Endpoints

All URIs are relative to https://workfloo.kiban.com

Class Method HTTP request Description
PoolApi execute_pool POST /api/v1/pool Ejecutar un pool
WorkflooApi execute_workfloo POST /api/v1/workfloo Ejecutar un workfloo
WorkflooApi execute_workfloo_document POST /api/v1/workfloo/{id}/document Enviar los documentos de un paso
WorkflooApi execute_workfloo_form POST /api/v1/workfloo/{id}/form Enviar el formulario de un paso
WorkflooApi fallback_workfloo_otp PATCH /api/v1/workfloo/{id}/otp/fallback Reenviar el código de verificación (OTP)
WorkflooApi get_workfloo GET /api/v1/workfloo/{id} Detalle de una ejecución
WorkflooApi get_workfloo_file GET /api/v1/workfloo/{id}/file Descargar un archivo de un nodo
WorkflooApi get_workfloo_file_v2 GET /api/v2/workfloo/{id}/file Descargar un archivo de un nodo (v2)
WorkflooApi get_workfloo_status GET /api/v1/workfloo/status/{id} Estatus de una ejecución
WorkflooApi list_workfloos GET /api/v1/workfloo Historial de ejecuciones (v1)
WorkflooApi list_workfloos_v2 GET /api/v2/workfloo Historial de ejecuciones (v2)
WorkflooApi resend_workfloo_nip PATCH /api/v1/workfloo/{id}/nip/resend Reenviar el NIP
WorkflooApi review_workfloo_validation POST /api/v1/workfloo/{id}/review Revisar un paso de validación
WorkflooApi send_workfloo_nip PATCH /api/v1/workfloo/{id}/nip/send Enviar el NIP
WorkflooApi submit_workfloo_correction POST /api/v1/workfloo/{id}/correction Enviar la corrección de un paso de validación
WorkflooApi validate_workfloo_field POST /api/v1/workfloo/{id}/field/{fieldId}/validate Validar un campo del formulario
WorkflooApi validate_workfloo_nip PATCH /api/v1/workfloo/{id}/nip/validate Validar el NIP
WorkflooApi validate_workfloo_otp PATCH /api/v1/workfloo/{id}/otp/validate Validar el código de verificación (OTP)

Documentation For Models

Documentation For Authorization

Authentication schemes defined for the API:

ApiKeyAuth

  • Type: API key
  • API key parameter name: x-api-key
  • Location: HTTP header

Author

hola@kiban.com

Metadata

Release files for kiban-workfloo 1.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for kiban-workfloo 1.1.0
File Size Uploaded Provenance Actions
kiban_workfloo-1.1.0.tar.gz 72.5 kB With provenance Details for kiban_workfloo-1.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for kiban-workfloo 1.1.0
File Interpreter ABI Platform Actions
kiban_workfloo-1.1.0-py3-none-any.whl Python 3 none any Details for kiban_workfloo-1.1.0-py3-none-any.whl

Total release size: 234.6 kB

Release files / kiban_workfloo-1.1.0.tar.gz

Download URL kiban_workfloo-1.1.0.tar.gz
Size 72.5 kB
Tags Source
SHA-256 checksum
How to use checksums
21cdb7338abe66db7fd38d4b00de80f8973457316a261ea853be7c6130a81e06
BLAKE2b-256 checksum
How to use checksums
80631a74b75164f0c6e17ca4f1fbf7e0ea338688c92685a736410847a8ecf9b6
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 28, 2026.

Transparency log

Release files / kiban_workfloo-1.1.0-py3-none-any.whl

Download URL kiban_workfloo-1.1.0-py3-none-any.whl
Size 162.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
0a9358e2c02351671081fe1bf86c842523a4b37c4d4ab307603914b533dc18aa
BLAKE2b-256 checksum
How to use checksums
81e1382af53ff719c20465223f05620ad56525449d97321236ed5a7c60b0de84
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 28, 2026.

Transparency log

Security for kiban-workfloo 1.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for kiban_workfloo-1.1.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 28, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

1.1.0 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page