Projects - Kodexa Developer Portal

A Project is the workspace boundary for a document-heavy business process. It brings together the documents, data definitions, review forms, Activity Plans, Tasks, knowledge, integrations, and access rules needed to run a real workflow. Projects do not define the whole operating model by themselves. The operating model comes from the mental model introduced in Concepts:

Activities run automated work.
Tasks represent human review and exception handling.
Data Definitions describe the structured business data you want from unstructured documents.
Data Forms give reviewers a usable surface for reviewing that data.
Knowledge captures reusable business context, classifications, and rules.

What a Project Contains

Resource	Role in the workflow
Document Stores	Where incoming files and their Kodexa document representations live
Data Stores	Structured operational data associated with the process
Data Definitions	The object and field model for extracted business data
Activity Plans	Reusable automated processes bound into this project
Task Templates	Human review surfaces and assignments that Activities can create
Data Forms	Review and correction UI for extracted data
Knowledge Sets	Reference knowledge, classifications, and enrichment rules
Statuses	Project-specific document, task, and attribute states
Service Bridges	External systems the workflow calls through governed integrations

Why Projects Matter

Projects let you keep reusable platform assets and local business configuration separate. An Activity Plan can be defined once for an organization, then bound to multiple projects that have different stores, data definitions, review queues, or downstream systems. That separation is important when the same process shape repeats across business units. An invoice intake workflow, claims intake workflow, or covenant compliance workflow may share the same Activity structure while still using project-specific stores, forms, statuses, and permissions.

Working with Projects in the SDK

Projects are owned by organizations. Use the SDK to find an organization, then list or load its projects.

from kodexa.platform import KodexaClient

client = KodexaClient()
organization = client.organizations.find_by_slug("acme")

projects = organization.projects.list().to_df()
print(projects)

project = organization.projects.find_by_name("Invoice Operations")
print(project.id)

Once you have a project, use its resource accessors to inspect the project boundary.

document_stores = project.document_stores.to_df()
print(document_stores)

Project Design Checklist

When modeling a new business process, define these decisions explicitly:

Which documents enter the process, and where they should be stored.
Which business objects and fields must be extracted.
Which Activity Plan runs the automated work.
Which Tasks are created when judgment or exception handling is required.
Which Data Forms reviewers use to complete those Tasks.
Which Service Bridges connect to downstream systems.
Which statuses show the state of documents, Tasks, and attributes.

Next Steps

Activities

Understand automated business process runs.

Tasks

Understand human review work inside the workflow.

Activity Plans

Configure the steps that run automated work.

Project Templates

Package reusable project setup for repeatable deployments.

​What a Project Contains

​Why Projects Matter

​Working with Projects in the SDK

​Project Design Checklist

​Next Steps