Skip to main content
GET
/
api
/
projects
/
{id}
Get Project by ID
curl --request GET \
  --url https://platform.kodexa.ai/api/projects/{id} \
  --header 'x-api-key: <api-key>'
import requests

url = "https://platform.kodexa.ai/api/projects/{id}"

headers = {"x-api-key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)
const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://platform.kodexa.ai/api/projects/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://platform.kodexa.ai/api/projects/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://platform.kodexa.ai/api/projects/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
HttpResponse<String> response = Unirest.get("https://platform.kodexa.ai/api/projects/{id}")
  .header("x-api-key", "<api-key>")
  .asString();
require 'uri'
require 'net/http'

url = URI("https://platform.kodexa.ai/api/projects/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body
{
  "changeSequence": 123,
  "color": "#4A90D9",
  "createdOn": "2023-11-07T05:31:56Z",
  "dataFlow": {
    "edges": [
      {
        "id": "<string>",
        "properties": {},
        "source": "<string>",
        "target": "<string>"
      }
    ],
    "nodes": [
      {
        "dimensions": {
          "height": 123,
          "width": 123
        },
        "id": "<string>",
        "parentId": "<string>",
        "position": {
          "x": 123,
          "y": 123
        },
        "properties": {},
        "type": "<string>"
      }
    ],
    "viewPort": {
      "x": 123,
      "y": 123,
      "zoom": 123
    }
  },
  "description": "Automated invoice processing pipeline.",
  "documentStatuses": [
    {
      "changeSequence": 123,
      "color": "<string>",
      "createdOn": "2023-11-07T05:31:56Z",
      "icon": "<string>",
      "id": "<string>",
      "project": "<unknown>",
      "projectId": "<string>",
      "slug": "<string>",
      "status": "<string>",
      "updatedOn": "2023-11-07T05:31:56Z",
      "uuid": "<string>"
    }
  ],
  "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "memory": {
    "changeSequence": 123,
    "orderedDashboards": [
      "<string>"
    ],
    "recentFilters": {},
    "recentQueries": {}
  },
  "name": "Invoice Processing",
  "notes": "<string>",
  "options": {
    "companion": {
      "agentRuntimeRef": "<string>",
      "moduleRefs": [
        "<string>"
      ],
      "prompt": "<string>"
    },
    "dataOptions": [
      {
        "aliases": [
          "<string>"
        ],
        "default": "<unknown>",
        "description": "<string>",
        "developerOnly": true,
        "displayProperties": {},
        "falseLabel": "<string>",
        "featureFlag": "<string>",
        "groupOptions": "<array>",
        "hint": "<string>",
        "label": "<string>",
        "listDescription": "<string>",
        "listLabel": "<string>",
        "listType": "<string>",
        "name": "<string>",
        "overviewMarkdown": "<string>",
        "possibleValues": [
          {
            "description": "<string>",
            "label": "<string>",
            "value": "<unknown>"
          }
        ],
        "properties": {},
        "required": true,
        "showIf": "<string>",
        "showOnPopup": true,
        "subType": "<string>",
        "supportArticle": "<string>",
        "tabName": "<string>",
        "type": "<string>"
      }
    ],
    "dataProperties": {},
    "executionPolicy": {
      "backoffBaseSeconds": 123,
      "backoffStrategy": "<string>",
      "maxAttempts": 123,
      "onExhausted": "<string>",
      "timeoutSeconds": 123
    },
    "groupTaxonTypeFeatures": {},
    "options": [
      {
        "aliases": [
          "<string>"
        ],
        "default": "<unknown>",
        "description": "<string>",
        "developerOnly": true,
        "displayProperties": {},
        "falseLabel": "<string>",
        "featureFlag": "<string>",
        "groupOptions": "<array>",
        "hint": "<string>",
        "label": "<string>",
        "listDescription": "<string>",
        "listLabel": "<string>",
        "listType": "<string>",
        "name": "<string>",
        "overviewMarkdown": "<string>",
        "possibleValues": [
          {
            "description": "<string>",
            "label": "<string>",
            "value": "<unknown>"
          }
        ],
        "properties": {},
        "required": true,
        "showIf": "<string>",
        "showOnPopup": true,
        "subType": "<string>",
        "supportArticle": "<string>",
        "tabName": "<string>",
        "type": "<string>"
      }
    ],
    "properties": {},
    "taskOptions": {
      "showNewTask": true
    },
    "taxonTypeFeatures": {}
  },
  "organization": {
    "archived": true,
    "authGroupLink": {
      "authGroup": "<string>"
    },
    "changeSequence": 123,
    "createdOn": "2023-11-07T05:31:56Z",
    "defaultToPrivateTemplates": true,
    "description": "Document processing organization for Acme Corp.",
    "enterpriseOrganization": true,
    "features": {},
    "hasImage": true,
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "memory": {
      "orderedDashboards": [
        "<string>"
      ]
    },
    "name": "Acme Corp",
    "organizationStatus": "ACTIVE",
    "properties": {},
    "publicAccess": true,
    "searchText": "<string>",
    "slug": "acme-corp",
    "stripeCustomerId": "<string>",
    "supportAccess": true,
    "supportAccessExpiresAt": "2023-11-07T05:31:56Z",
    "updatedOn": "2023-11-07T05:31:56Z",
    "uuid": "550e8400e29b41d4a716446655440000"
  },
  "organizationId": "<string>",
  "owner": {
    "active": true,
    "bio": "<string>",
    "businessGroup": "<string>",
    "changeSequence": 123,
    "createdOn": "2023-11-07T05:31:56Z",
    "email": "<string>",
    "firstName": "<string>",
    "groupsJson": "<string>",
    "id": "<string>",
    "image": "<string>",
    "isExternallyManaged": true,
    "lastName": "<string>",
    "preferences": {
      "showOnboarding": true,
      "showScrollbars": true,
      "showWelcomeMessage": true
    },
    "rolesJson": "<string>",
    "searchText": "<string>",
    "security": {
      "roles": [
        "<string>"
      ]
    },
    "showDeveloperTools": true,
    "title": "<string>",
    "updatedOn": "2023-11-07T05:31:56Z",
    "userStorage": {
      "favoriteLinks": [
        {
          "link": "<string>"
        }
      ]
    },
    "userType": "<string>",
    "uuid": "<string>"
  },
  "ownerId": "<string>",
  "projectTemplateRef": "<string>",
  "searchText": "<string>",
  "slug": "invoice-processing",
  "status": {
    "changeSequence": 123,
    "color": "<string>",
    "createdOn": "2023-11-07T05:31:56Z",
    "icon": "<string>",
    "id": "<string>",
    "organization": {
      "archived": true,
      "authGroupLink": {
        "authGroup": "<string>"
      },
      "changeSequence": 123,
      "createdOn": "2023-11-07T05:31:56Z",
      "defaultToPrivateTemplates": true,
      "description": "Document processing organization for Acme Corp.",
      "enterpriseOrganization": true,
      "features": {},
      "hasImage": true,
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "memory": {
        "orderedDashboards": [
          "<string>"
        ]
      },
      "name": "Acme Corp",
      "organizationStatus": "ACTIVE",
      "properties": {},
      "publicAccess": true,
      "searchText": "<string>",
      "slug": "acme-corp",
      "stripeCustomerId": "<string>",
      "supportAccess": true,
      "supportAccessExpiresAt": "2023-11-07T05:31:56Z",
      "updatedOn": "2023-11-07T05:31:56Z",
      "uuid": "550e8400e29b41d4a716446655440000"
    },
    "organizationId": "<string>",
    "production": true,
    "status": "<string>",
    "updatedOn": "2023-11-07T05:31:56Z",
    "uuid": "<string>"
  },
  "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.

Response

The 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."

​
documentStatuses
object[]
​
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 | null

An organization is the top-level tenant in Kodexa. All projects, stores, and resources belong to an organization.

​
organizationId
string | null

ID of the organization this project belongs to.

​
owner
object | null

A platform user represents a user account in the Kodexa platform.

​
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. Automatically lowercased. Pattern: ^[a-z0-9-]+$

Example:

"invoice-processing"

​
status
object | null

A project status defines a named state for tracking project lifecycle.

​
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"