Skip to main content
PUT
/
api
/
projects
/
{id}
Update Project
curl --request PUT \
  --url https://platform.kodexa.ai/api/projects/{id} \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "changeSequence": 123,
  "color": "#4A90D9",
  "createdOn": "2023-11-07T05:31:56Z",
  "dataFlow": {
    "edges": [
      {
        "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
        "properties": {},
        "source": "<string>",
        "target": "<string>"
      }
    ],
    "nodes": [
      {
        "dimensions": {
          "height": 123,
          "width": 123
        },
        "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
        "parentId": "<string>",
        "position": {
          "x": 123,
          "y": 123
        },
        "properties": {},
        "type": "<string>"
      }
    ],
    "viewPort": {
      "x": 123,
      "y": 123,
      "zoom": 123
    }
  },
  "description": "Automated invoice processing pipeline.",
  "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "memory": {
    "changeSequence": 123,
    "orderedDashboards": [
      "<string>"
    ],
    "recentFilters": {},
    "recentQueries": {}
  },
  "name": "Invoice Processing",
  "notes": "<string>",
  "options": {
    "dataOptions": [
      {
        "aliases": [
          "<string>"
        ],
        "default": {},
        "description": "Automated invoice processing pipeline.",
        "developerOnly": true,
        "displayProperties": {},
        "falseLabel": "<string>",
        "featureFlag": "<string>",
        "groupOptions": [
          {}
        ],
        "hint": "<string>",
        "label": "<string>",
        "listDescription": "<string>",
        "listLabel": "<string>",
        "listType": "<string>",
        "name": "Invoice Processing",
        "overviewMarkdown": "<string>",
        "possibleValues": [
          {
            "description": "Automated invoice processing pipeline.",
            "label": "<string>",
            "value": {}
          }
        ],
        "properties": {},
        "required": true,
        "showIf": "<string>",
        "showOnPopup": true,
        "subType": "<string>",
        "supportArticle": "<string>",
        "tabName": "<string>",
        "type": "<string>"
      }
    ],
    "dataProperties": {},
    "groupTaxonTypeFeatures": {},
    "options": [
      {
        "aliases": [
          "<string>"
        ],
        "default": {},
        "description": "Automated invoice processing pipeline.",
        "developerOnly": true,
        "displayProperties": {},
        "falseLabel": "<string>",
        "featureFlag": "<string>",
        "groupOptions": [
          {}
        ],
        "hint": "<string>",
        "label": "<string>",
        "listDescription": "<string>",
        "listLabel": "<string>",
        "listType": "<string>",
        "name": "Invoice Processing",
        "overviewMarkdown": "<string>",
        "possibleValues": [
          {
            "description": "Automated invoice processing pipeline.",
            "label": "<string>",
            "value": {}
          }
        ],
        "properties": {},
        "required": true,
        "showIf": "<string>",
        "showOnPopup": true,
        "subType": "<string>",
        "supportArticle": "<string>",
        "tabName": "<string>",
        "type": "<string>"
      }
    ],
    "properties": {},
    "taskOptions": {
      "showNewTask": true,
      "showTakeNext": true
    },
    "taxonTypeFeatures": {}
  },
  "organization": {
    "authGroupLink": {
      "authGroup": "<string>"
    },
    "changeSequence": 123,
    "createdOn": "2023-11-07T05:31:56Z",
    "defaultToPrivateTemplates": true,
    "description": "Automated invoice processing pipeline.",
    "enterpriseOrganization": true,
    "features": {},
    "hasImage": true,
    "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
    "memory": {
      "orderedDashboards": [
        "<string>"
      ]
    },
    "name": "Invoice Processing",
    "organizationStatus": "<string>",
    "properties": {},
    "publicAccess": true,
    "searchText": "<string>",
    "slug": "invoice-processing",
    "stripeCustomerId": "<string>",
    "supportAccess": true,
    "supportAccessExpiresAt": "2023-11-07T05:31:56Z",
    "updatedOn": "2023-11-07T05:31:56Z",
    "uuid": "7c9e667974254de944be07fc1f90ae7"
  },
  "organizationId": "<string>",
  "owner": {
    "active": true,
    "bio": "<string>",
    "businessGroup": "<string>",
    "changeSequence": 123,
    "createdOn": "2023-11-07T05:31:56Z",
    "email": "<string>",
    "firstName": "<string>",
    "groupsJson": "<string>",
    "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
    "image": "<string>",
    "isExternallyManaged": true,
    "lastName": "<string>",
    "preferences": {
      "showOnboarding": true,
      "showScrollbars": true,
      "showWelcomeMessage": true
    },
    "roles": {
      "roles": [
        "<string>"
      ]
    },
    "rolesJson": "<string>",
    "searchText": "<string>",
    "showDeveloperTools": true,
    "title": "<string>",
    "updatedOn": "2023-11-07T05:31:56Z",
    "userStorage": {
      "favoriteLinks": [
        {
          "link": "<string>"
        }
      ]
    },
    "userType": "<string>",
    "uuid": "7c9e667974254de944be07fc1f90ae7"
  },
  "ownerId": "<string>",
  "projectTemplateRef": "<string>",
  "searchText": "<string>",
  "slug": "invoice-processing",
  "status": {
    "changeSequence": 123,
    "color": "#4A90D9",
    "createdOn": "2023-11-07T05:31:56Z",
    "icon": "<string>",
    "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
    "organization": {
      "authGroupLink": {
        "authGroup": "<string>"
      },
      "changeSequence": 123,
      "createdOn": "2023-11-07T05:31:56Z",
      "defaultToPrivateTemplates": true,
      "description": "Automated invoice processing pipeline.",
      "enterpriseOrganization": true,
      "features": {},
      "hasImage": true,
      "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
      "memory": {
        "orderedDashboards": [
          "<string>"
        ]
      },
      "name": "Invoice Processing",
      "organizationStatus": "<string>",
      "properties": {},
      "publicAccess": true,
      "searchText": "<string>",
      "slug": "invoice-processing",
      "stripeCustomerId": "<string>",
      "supportAccess": true,
      "supportAccessExpiresAt": "2023-11-07T05:31:56Z",
      "updatedOn": "2023-11-07T05:31:56Z",
      "uuid": "7c9e667974254de944be07fc1f90ae7"
    },
    "organizationId": "<string>",
    "production": true,
    "status": "<string>",
    "updatedOn": "2023-11-07T05:31:56Z",
    "uuid": "7c9e667974254de944be07fc1f90ae7"
  },
  "statusId": "<string>",
  "statusType": "ACTIVE",
  "templateArticleId": "<string>",
  "updatedOn": "2023-11-07T05:31:56Z",
  "uuid": "7c9e667974254de944be07fc1f90ae7"
}
'
{
  "changeSequence": 123,
  "color": "#4A90D9",
  "createdOn": "2023-11-07T05:31:56Z",
  "dataFlow": {
    "edges": [
      {
        "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
        "properties": {},
        "source": "<string>",
        "target": "<string>"
      }
    ],
    "nodes": [
      {
        "dimensions": {
          "height": 123,
          "width": 123
        },
        "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
        "parentId": "<string>",
        "position": {
          "x": 123,
          "y": 123
        },
        "properties": {},
        "type": "<string>"
      }
    ],
    "viewPort": {
      "x": 123,
      "y": 123,
      "zoom": 123
    }
  },
  "description": "Automated invoice processing pipeline.",
  "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "memory": {
    "changeSequence": 123,
    "orderedDashboards": [
      "<string>"
    ],
    "recentFilters": {},
    "recentQueries": {}
  },
  "name": "Invoice Processing",
  "notes": "<string>",
  "options": {
    "dataOptions": [
      {
        "aliases": [
          "<string>"
        ],
        "default": {},
        "description": "Automated invoice processing pipeline.",
        "developerOnly": true,
        "displayProperties": {},
        "falseLabel": "<string>",
        "featureFlag": "<string>",
        "groupOptions": [
          {}
        ],
        "hint": "<string>",
        "label": "<string>",
        "listDescription": "<string>",
        "listLabel": "<string>",
        "listType": "<string>",
        "name": "Invoice Processing",
        "overviewMarkdown": "<string>",
        "possibleValues": [
          {
            "description": "Automated invoice processing pipeline.",
            "label": "<string>",
            "value": {}
          }
        ],
        "properties": {},
        "required": true,
        "showIf": "<string>",
        "showOnPopup": true,
        "subType": "<string>",
        "supportArticle": "<string>",
        "tabName": "<string>",
        "type": "<string>"
      }
    ],
    "dataProperties": {},
    "groupTaxonTypeFeatures": {},
    "options": [
      {
        "aliases": [
          "<string>"
        ],
        "default": {},
        "description": "Automated invoice processing pipeline.",
        "developerOnly": true,
        "displayProperties": {},
        "falseLabel": "<string>",
        "featureFlag": "<string>",
        "groupOptions": [
          {}
        ],
        "hint": "<string>",
        "label": "<string>",
        "listDescription": "<string>",
        "listLabel": "<string>",
        "listType": "<string>",
        "name": "Invoice Processing",
        "overviewMarkdown": "<string>",
        "possibleValues": [
          {
            "description": "Automated invoice processing pipeline.",
            "label": "<string>",
            "value": {}
          }
        ],
        "properties": {},
        "required": true,
        "showIf": "<string>",
        "showOnPopup": true,
        "subType": "<string>",
        "supportArticle": "<string>",
        "tabName": "<string>",
        "type": "<string>"
      }
    ],
    "properties": {},
    "taskOptions": {
      "showNewTask": true,
      "showTakeNext": true
    },
    "taxonTypeFeatures": {}
  },
  "organization": {
    "authGroupLink": {
      "authGroup": "<string>"
    },
    "changeSequence": 123,
    "createdOn": "2023-11-07T05:31:56Z",
    "defaultToPrivateTemplates": true,
    "description": "Automated invoice processing pipeline.",
    "enterpriseOrganization": true,
    "features": {},
    "hasImage": true,
    "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
    "memory": {
      "orderedDashboards": [
        "<string>"
      ]
    },
    "name": "Invoice Processing",
    "organizationStatus": "<string>",
    "properties": {},
    "publicAccess": true,
    "searchText": "<string>",
    "slug": "invoice-processing",
    "stripeCustomerId": "<string>",
    "supportAccess": true,
    "supportAccessExpiresAt": "2023-11-07T05:31:56Z",
    "updatedOn": "2023-11-07T05:31:56Z",
    "uuid": "7c9e667974254de944be07fc1f90ae7"
  },
  "organizationId": "<string>",
  "owner": {
    "active": true,
    "bio": "<string>",
    "businessGroup": "<string>",
    "changeSequence": 123,
    "createdOn": "2023-11-07T05:31:56Z",
    "email": "<string>",
    "firstName": "<string>",
    "groupsJson": "<string>",
    "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
    "image": "<string>",
    "isExternallyManaged": true,
    "lastName": "<string>",
    "preferences": {
      "showOnboarding": true,
      "showScrollbars": true,
      "showWelcomeMessage": true
    },
    "roles": {
      "roles": [
        "<string>"
      ]
    },
    "rolesJson": "<string>",
    "searchText": "<string>",
    "showDeveloperTools": true,
    "title": "<string>",
    "updatedOn": "2023-11-07T05:31:56Z",
    "userStorage": {
      "favoriteLinks": [
        {
          "link": "<string>"
        }
      ]
    },
    "userType": "<string>",
    "uuid": "7c9e667974254de944be07fc1f90ae7"
  },
  "ownerId": "<string>",
  "projectTemplateRef": "<string>",
  "searchText": "<string>",
  "slug": "invoice-processing",
  "status": {
    "changeSequence": 123,
    "color": "#4A90D9",
    "createdOn": "2023-11-07T05:31:56Z",
    "icon": "<string>",
    "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
    "organization": {
      "authGroupLink": {
        "authGroup": "<string>"
      },
      "changeSequence": 123,
      "createdOn": "2023-11-07T05:31:56Z",
      "defaultToPrivateTemplates": true,
      "description": "Automated invoice processing pipeline.",
      "enterpriseOrganization": true,
      "features": {},
      "hasImage": true,
      "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
      "memory": {
        "orderedDashboards": [
          "<string>"
        ]
      },
      "name": "Invoice Processing",
      "organizationStatus": "<string>",
      "properties": {},
      "publicAccess": true,
      "searchText": "<string>",
      "slug": "invoice-processing",
      "stripeCustomerId": "<string>",
      "supportAccess": true,
      "supportAccessExpiresAt": "2023-11-07T05:31:56Z",
      "updatedOn": "2023-11-07T05:31:56Z",
      "uuid": "7c9e667974254de944be07fc1f90ae7"
    },
    "organizationId": "<string>",
    "production": true,
    "status": "<string>",
    "updatedOn": "2023-11-07T05:31:56Z",
    "uuid": "7c9e667974254de944be07fc1f90ae7"
  },
  "statusId": "<string>",
  "statusType": "ACTIVE",
  "templateArticleId": "<string>",
  "updatedOn": "2023-11-07T05:31:56Z",
  "uuid": "7c9e667974254de944be07fc1f90ae7"
}

Authorizations

​
x-api-key
string
header
required

API key for authentication. Create one from the Kodexa platform UI under Settings > Access Tokens.

Path Parameters

​
id
string<uuid>
required

Unique identifier (UUID) of the resource.

Body

application/json

A project groups related document stores, assistants, tasks, and processing pipelines within an organization.

​
changeSequence
integer<int32>

Optimistic locking version number.

​
color
string

Display color for the project (max 25 characters).

Example:

"#4A90D9"

​
createdOn
string<date-time>

Timestamp when the project was created.

​
dataFlow
object

Project data flow configuration.

​
description
string

Human-readable description of the project.

Example:

"Automated invoice processing pipeline."

​
id
string

Unique identifier (UUID) for the project.

Example:

"7c9e6679-7425-40de-944b-e07fc1f90ae7"

​
memory
object

Project-level memory and configuration.

​
name
string

Display name of the project.

Example:

"Invoice Processing"

​
notes
string

Free-form notes about the project.

​
options
object

Project options and settings.

​
organization
object
​
organizationId
string | null

ID of the organization this project belongs to.

​
owner
object
​
ownerId
string | null

ID of the user who owns this project.

​
projectTemplateRef
string

Reference to the project template used to create this project.

​
searchText
string
​
slug
string

URL-friendly identifier. Pattern: ^[a-zA-Z0-9_-]+$

Example:

"invoice-processing"

​
status
object
​
statusId
string | null

ID of the current project status.

​
statusType
string

Project lifecycle state: ACTIVE, ARCHIVED, or PENDING_DELETE.

Example:

"ACTIVE"

​
templateArticleId
string
​
updatedOn
string<date-time>

Timestamp when the project was last updated.

​
uuid
string

Secondary UUID identifier.

Example:

"7c9e667974254de944be07fc1f90ae7"

Response

Updated Project

A project groups related document stores, assistants, tasks, and processing pipelines within an organization.

​
changeSequence
integer<int32>

Optimistic locking version number.

​
color
string

Display color for the project (max 25 characters).

Example:

"#4A90D9"

​
createdOn
string<date-time>

Timestamp when the project was created.

​
dataFlow
object

Project data flow configuration.

​
description
string

Human-readable description of the project.

Example:

"Automated invoice processing pipeline."

​
id
string

Unique identifier (UUID) for the project.

Example:

"7c9e6679-7425-40de-944b-e07fc1f90ae7"

​
memory
object

Project-level memory and configuration.

​
name
string

Display name of the project.

Example:

"Invoice Processing"

​
notes
string

Free-form notes about the project.

​
options
object

Project options and settings.

​
organization
object
​
organizationId
string | null

ID of the organization this project belongs to.

​
owner
object
​
ownerId
string | null

ID of the user who owns this project.

​
projectTemplateRef
string

Reference to the project template used to create this project.

​
searchText
string
​
slug
string

URL-friendly identifier. Pattern: ^[a-zA-Z0-9_-]+$

Example:

"invoice-processing"

​
status
object
​
statusId
string | null

ID of the current project status.

​
statusType
string

Project lifecycle state: ACTIVE, ARCHIVED, or PENDING_DELETE.

Example:

"ACTIVE"

​
templateArticleId
string
​
updatedOn
string<date-time>

Timestamp when the project was last updated.

​
uuid
string

Secondary UUID identifier.

Example:

"7c9e667974254de944be07fc1f90ae7"