POST
/
v1
/
app
/
project
/
{projectId}
/
artifact
{
  "id": "<string>",
  "parent_id": "<string>",
  "child_count": 123,
  "project_id": "<string>",
  "project": {
    "id": "<string>",
    "name": "<string>",
    "goal": "<string>",
    "default_member_role": "Viewer",
    "default_role_enabled": true,
    "deadline": "<string>",
    "visibility": "Public",
    "member_count": 123,
    "members": [
      {
        "id": "<string>",
        "role": "Viewer",
        "user": {
          "id": "<string>",
          "org_id": "<string>",
          "account_id": "<string>",
          "profile_picture": "<string>",
          "name": "<string>",
          "email": "<string>",
          "job_position_name": "<string>",
          "job_position_description": "<string>",
          "state": "Active",
          "roles": [
            "<any>"
          ],
          "created_at": "<string>"
        },
        "is_project_member": true
      }
    ],
    "project_context": "<string>",
    "answer_context": "<string>",
    "is_pinned": true
  },
  "name": "<string>",
  "description": "<string>",
  "type": "InlineText",
  "source": "User",
  "state": "Initializing",
  "error": "Unknown",
  "ingest_status": "NotApplicable",
  "ingest_warnings": [
    "Unknown"
  ],
  "ingest_progress": 123,
  "has_content": true,
  "content": "<string>",
  "raw_content": "<string>",
  "integration_id": "<string>",
  "external_url": "<string>",
  "config": {
    "entity": {
      "id": "<string>",
      "name": "<string>",
      "goal": "<string>",
      "default_member_role": "Viewer",
      "default_role_enabled": true,
      "deadline": "<string>",
      "visibility": "Public",
      "member_count": 123,
      "members": [
        {
          "id": "<string>",
          "role": "Viewer",
          "user": {
            "id": "<string>",
            "org_id": "<string>",
            "account_id": "<string>",
            "profile_picture": "<string>",
            "name": "<string>",
            "email": "<string>",
            "job_position_name": "<string>",
            "job_position_description": "<string>",
            "state": "Active",
            "roles": [
              "<any>"
            ],
            "created_at": "<string>"
          },
          "is_project_member": true
        }
      ],
      "project_context": "<string>",
      "answer_context": "<string>",
      "is_pinned": true
    }
  },
  "file_uri": "<string>",
  "artifact_references": [
    {}
  ],
  "keep_file_after_ingestion": true,
  "created_by": {
    "id": "<string>",
    "org_id": "<string>",
    "account_id": "<string>",
    "profile_picture": "<string>",
    "name": "<string>",
    "email": "<string>",
    "job_position_name": "<string>",
    "job_position_description": "<string>",
    "state": "Active",
    "roles": [
      "<any>"
    ],
    "created_at": "<string>"
  },
  "created_at": "<string>",
  "updated_at": "<string>"
}

Path Parameters

​
projectId
string
required

The ID of the project

Body

application/json

The artifact to be created. This body can be submitted as either multipart/form-data (when including a file) or as JSON. Required fields include 'type' (artifact type) and 'name'. The 'config' field must contain a type-specific configuration object, matching the structure expected for the given artifact type. When uploading a file, include the file binary in 'fileData' (multipart only). Other optional fields allow setting metadata, description, parent relationships, external URLs, and ingestion behavior. Extra metadata (in 'metadata') is used internally and not stored persistently.

​
type
enum<string>
required
Available options:
InlineText,
Document,
Folder,
Summary,
Composition,
SmartDoc,
Link,
BulkQA,
ReadAndExtract
​
name
string
required
​
config
object
required
​
source
enum<string>
Available options:
User,
SharePoint,
Confluence,
Claromentis,
FileSystem,
Mock
​
parent_id
string
​
integration_id
string
​
external_url
string
​
description
string
​
raw_content
string
​
plain_text_content
string
​
keep_file_after_ingestion
boolean

Response

200 - application/json

Returns the created artifact details

​
id
string
required
​
project_id
string
required
​
name
string
required
​
type
enum<string>
required
Available options:
InlineText,
Document,
Folder,
Summary,
Composition,
SmartDoc,
Link,
BulkQA,
ReadAndExtract
​
source
enum<string>
required
Available options:
User,
SharePoint,
Confluence,
Claromentis,
FileSystem,
Mock
​
state
enum<string>
required
Available options:
Initializing,
Processing,
Draft,
Deleted,
Published,
Unavailable,
Error
​
ingest_status
enum<string>
required
Available options:
NotApplicable,
NotStarted,
Processing,
Parsing,
Storing,
Done,
Error
​
has_content
boolean
required
​
config
object
required
​
keep_file_after_ingestion
boolean
required
​
created_at
string
required
​
updated_at
string
required
​
parent_id
string
​
child_count
number
​
project
object
​
description
string
​
error
enum<string>
Available options:
Unknown,
InternalError,
MismatchedType,
InvalidExtension,
MaxNodes,
Malformed,
Encrypted,
NoValidFile,
NoValidNodes
​
ingest_warnings
enum<string>[]
​
ingest_progress
number
​
content
string
​
raw_content
string
​
integration_id
string
​
external_url
string
​
file_uri
string
​
artifact_references
object[]
​
created_by
object