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.0.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.0.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.0.0
File Size Uploaded Provenance Actions
kiban_workfloo-1.0.0.tar.gz 71.3 kB With provenance Details for kiban_workfloo-1.0.0.tar.gz

Built distribution (wheel)

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

Total release size: 229.7 kB

Release files / kiban_workfloo-1.0.0.tar.gz

Download URL kiban_workfloo-1.0.0.tar.gz
Size 71.3 kB
Tags Source
SHA-256 checksum
How to use checksums
b5dd66e2d2afc20e7adfb62aea50198bff0ca168610169bb61db52e9f8d120e7
BLAKE2b-256 checksum
How to use checksums
c6c692802ff687fbf4fdb02262f58f9e52e6c145d2250891dcb94c67d11bf9cd
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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 19, 2026.

Transparency log

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

Download URL kiban_workfloo-1.0.0-py3-none-any.whl
Size 158.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
3c15e2ba9168d0f07397f48e82a9ba50695e99b543a84ff14ebf7cff210eccc5
BLAKE2b-256 checksum
How to use checksums
13c7e2c92d92c89f481a3830a80e358958720ec37ed1b8979b6226bc3e5b2623
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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 19, 2026.

Transparency log

Security for kiban-workfloo 1.0.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.0.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 19, 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.0.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