Enterprise Search APIs

Enterprise Search APIs for chat sessions, messaging, connector administration, and project file uploads.

Overview

The workflow includes:

Chat sessions – Create, list, rename, and send messages in chat sessions
Connectors – List connector status, create connectors, associate credentials, run indexing, update CC pair status, and delete connectors
Project files – Upload files and poll upload/indexing status

Base URL: https://chordian-core.chordian.ai

Authentication: Bearer token (HTTPBearer) or API key cookie (APIKeyCookie) required on every request. Send your API key in the Authorization header: Authorization: Bearer <api-key>.

Send Chat Message

Send a new chat message. When stream is true (default), the API returns a Server-Sent Events (text/event-stream) stream of NDJSON AnswerStreamPart objects. When stream is false, the API returns a complete ChatFullResponse as JSON.

POST /chat/send-chat-message

Authentication: Authorization: Bearer <api-key>

Request Body

{
  "message": "string",
  "chat_session_id": "string",
  "stream": false,
  "include_citations": true,
  "allowed_tool_ids": [0],
  "forced_tool_id": 0,
  "internal_search_filters": {
    "source_type": ["string"]
  }
}

Field	Type	Required	Description
`message`	string	✅	User message text to send.
`chat_session_id`	string	✅	UUID of the chat session (from Create Chat Session).
`stream`	boolean	❌	When `true`, stream SSE responses; when `false`, return full JSON.
`include_citations`	boolean	❌	Include citation metadata in the response.
`allowed_tool_ids`	array<integer>	❌	Tool IDs the agent may use.
`forced_tool_id`	integer	❌	Force a specific tool for this message.
`internal_search_filters`	object	❌	Filters for internal search (e.g. `source_type`).

Successful Response (200 OK)

When stream=true — Content-Type: text/event-stream

A stream of NDJSON AnswerStreamPart objects (SSE).

string

When stream=false — Content-Type: application/json

{
  "answer": "string",
  "answer_citationless": "string",
  "pre_answer_reasoning": null,
  "tool_calls": [
    {
      "tool_name": "string",
      "tool_arguments": {
        "queries": ["string"]
      },
      "tool_result": "string",
      "search_docs": [
        {
          "document_id": "string",
          "chunk_ind": 0,
          "semantic_identifier": "string",
          "link": "string",
          "blurb": "string",
          "source_type": "string",
          "boost": 0,
          "hidden": false,
          "metadata": {},
          "score": 0,
          "is_relevant": null,
          "relevance_explanation": null,
          "match_highlights": ["string"],
          "updated_at": "string",
          "primary_owners": null,
          "secondary_owners": null,
          "is_internet": false
        }
      ],
      "generated_images": null,
      "pre_reasoning": null
    }
  ],
  "top_documents": [
    {
      "document_id": "string",
      "chunk_ind": 0,
      "semantic_identifier": "string",
      "link": "string",
      "blurb": "string",
      "source_type": "string",
      "boost": 0,
      "hidden": false,
      "metadata": {},
      "score": 0,
      "is_relevant": null,
      "relevance_explanation": null,
      "match_highlights": ["string"],
      "updated_at": "string",
      "primary_owners": null,
      "secondary_owners": null,
      "is_internet": false
    }
  ],
  "citation_info": [],
  "message_id": 0,
  "chat_session_id": null,
  "error_msg": null
}

Field	Type	Description
`answer`	string	Final assistant reply (may include citations).
`answer_citationless`	string	Reply text without citation markup.
`pre_answer_reasoning`	string \| null	Reasoning emitted before the answer, if any.
`tool_calls`	array<object>	Tools invoked during the turn (see ToolCall).
`top_documents`	array<object>	Ranked source documents used for the answer (same shape as `search_docs` items).
`citation_info`	array	Citation metadata for the response.
`message_id`	integer	Identifier for this message in the session.
`chat_session_id`	string \| null	Chat session UUID when returned.
`error_msg`	string \| null	Error detail when the turn failed; `null` on success.

ToolCall (item of `tool_calls[]`)

Field	Type	Description
`tool_name`	string	Tool invoked (e.g. `internal_search`).
`tool_arguments`	object	Arguments passed to the tool (shape varies by tool).
`tool_result`	string	Serialized tool output (often JSON in a string).
`search_docs`	array<object>	Documents retrieved by search tools.
`generated_images`	null	Reserved for image-generation tools.
`pre_reasoning`	string \| null	Reasoning before tool execution.

Validation Error (422)

{
  "status_code": 422,
  "message": "string",
  "data": null
}

Example

curl -X POST "https://chordian-core.chordian.ai/chat/send-chat-message" \
  -H "Authorization: Bearer <api-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "string",
    "chat_session_id": "string",
    "stream": false,
    "include_citations": true,
    "allowed_tool_ids": [0],
    "forced_tool_id": 0,
    "internal_search_filters": {
      "source_type": ["string"]
    }
  }'

Get User Chat Sessions

List chat sessions for the current user.

GET /chat/get-user-chat-sessions

Authentication: Authorization: Bearer <api-key>

Successful Response (200 OK)

{
  "sessions": [
    {
      "id": "string",
      "name": "string",
      "persona_id": 0,
      "global_persona_id": null,
      "is_global_persona": false,
      "time_created": "string",
      "time_updated": "string",
      "shared_status": "string",
      "current_alternate_model": null,
      "current_temperature_override": null
    }
  ]
}

Field	Type	Description
`sessions`	array<object>	Chat sessions for the current user (see ChatSession).

ChatSession (item of `sessions[]`)

Field	Type	Description
`id`	string	Chat session UUID.
`name`	string	Display name of the session.
`persona_id`	integer	Persona bound to this session.
`global_persona_id`	integer \| null	Global persona override, if set.
`is_global_persona`	boolean	Whether a global persona is active.
`time_created`	string	ISO timestamp when the session was created.
`time_updated`	string	ISO timestamp when the session was last updated.
`shared_status`	string	Sharing state (e.g. `private`).
`current_alternate_model`	string \| null	Alternate model override.
`current_temperature_override`	number \| null	Temperature override for this session.

Validation Error (422)

{
  "status_code": 422,
  "message": "string",
  "data": null
}

Example

curl "https://chordian-core.chordian.ai/chat/get-user-chat-sessions" \
  -H "Authorization: Bearer <api-key>"

Create Chat Session

Create a new chat session.

POST /chat/create-chat-session

Authentication: Authorization: Bearer <api-key>

Request Body

{
  "persona_id": 0
}

Field	Type	Required	Description
`persona_id`	integer	✅	Persona identifier for the new session.

Successful Response (200 OK)

{
  "chat_session_id": "string"
}

Field	Type	Description
`chat_session_id`	string	UUID of the newly created chat session.

Bad Request (400)

{
  "detail": "string"
}

Field	Type	Description
`detail`	string	Error message (e.g. `Invalid Persona provided.` when `persona_id` is not valid).

Validation Error (422)

{
  "status_code": 422,
  "message": "string",
  "data": null
}

Example

curl -X POST "https://chordian-core.chordian.ai/chat/create-chat-session" \
  -H "Authorization: Bearer <api-key>" \
  -H "Content-Type: application/json" \
  -d '{"persona_id": 0}'

Rename Chat Session

Rename an existing chat session.

PUT /chat/rename-chat-session

Authentication: Authorization: Bearer <api-key>

Request Body

{
  "chat_session_id": "string",
  "name": "string"
}

Field	Type	Required	Description
`chat_session_id`	string	✅	UUID of the chat session to rename.
`name`	string	✅	New display name for the session.

Successful Response (200 OK)

{
  "new_name": "string"
}

Field	Type	Description
`new_name`	string	Updated session display name.

Validation Error (422)

{
  "status_code": 422,
  "message": "string",
  "data": null
}

Example

curl -X PUT "https://chordian-core.chordian.ai/chat/rename-chat-session" \
  -H "Authorization: Bearer <api-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "chat_session_id": "string",
    "name": "string"
  }'

Get Connector Status

Get status for all connectors.

GET /manage/admin/connector/status

Authentication: Authorization: Bearer <api-key>

Successful Response (200 OK)

Array of connector status objects (one per connector–credential pair).

[
  {
    "cc_pair_id": 0,
    "name": "string",
    "connector": {
      "name": "string",
      "source": "string",
      "input_type": "string",
      "connector_specific_config": {
        "include_my_drives": true
      },
      "refresh_freq": 0,
      "prune_freq": 0,
      "indexing_start": null,
      "id": 0,
      "credential_ids": [0],
      "time_created": "string",
      "time_updated": "string"
    },
    "credential": {
      "credential_json": {
        "google_primary_admin": "string",
        "google_tokens": "string",
        "authentication_method": "string"
      },
      "admin_public": true,
      "source": "string",
      "name": "string",
      "curator_public": false,
      "groups": [],
      "id": 0,
      "user_id": "string",
      "user_email": "string",
      "time_created": "string",
      "time_updated": "string"
    },
    "access_type": "string",
    "groups": []
  }
]

Field	Type	Description
`cc_pair_id`	integer	Connector–credential pair identifier.
`name`	string	Display name for this pair.
`connector`	object	Connector configuration (see Connector).
`credential`	object	Credential bound to the connector (see Credential).
`access_type`	string	Access scope (e.g. `public`).
`groups`	array	Group IDs with access to this pair.

Connector (`connector`)

Field	Type	Description
`name`	string	Connector implementation name (e.g. `drive-connector`).
`source`	string	Source type used in `source_types` for ingest (e.g. `google_drive`).
`input_type`	string	Input mode (e.g. `poll`).
`connector_specific_config`	object	Source-specific settings (shape varies by `source`).
`refresh_freq`	integer	Refresh interval in seconds.
`prune_freq`	integer \| null	Prune interval in seconds.
`indexing_start`	string \| null	ISO timestamp when indexing started.
`id`	integer	Connector identifier.
`credential_ids`	array<integer>	Linked credential IDs.
`time_created`	string	ISO timestamp when the connector was created.
`time_updated`	string	ISO timestamp when the connector was last updated.

Credential (`credential`)

Field	Type	Description
`credential_json`	object	Redacted credential payload (keys vary by `source`).
`admin_public`	boolean	Whether the credential is public to admins.
`source`	string	Credential source type.
`name`	string	Credential display name.
`curator_public`	boolean	Whether curators can use this credential.
`groups`	array	Group IDs associated with the credential.
`id`	integer	Credential identifier.
`user_id`	string	Owner user UUID.
`user_email`	string	Owner email address.
`time_created`	string	ISO timestamp when the credential was created.
`time_updated`	string	ISO timestamp when the credential was last updated.

Validation Error (422)

{
  "status_code": 422,
  "message": "string",
  "data": null
}

Example

curl "https://chordian-core.chordian.ai/manage/admin/connector/status" \
  -H "Authorization: Bearer <api-key>"

Get Connectors By Credential

Get a list of connectors. Optionally filter by credential ID.

GET /manage/admin/connector

Authentication: Authorization: Bearer <api-key>

Query Parameters

Parameter	Type	Required	Description
`credential`	integer \| null	❌	Filter connectors by credential ID

Successful Response (200 OK)

Array of connector snapshot objects (same shape as Get Connector Status).

[
  {
    "cc_pair_id": 0,
    "name": "string",
    "connector": {
      "name": "string",
      "source": "string",
      "input_type": "string",
      "connector_specific_config": {
        "include_my_drives": true
      },
      "refresh_freq": 0,
      "prune_freq": 0,
      "indexing_start": null,
      "id": 0,
      "credential_ids": [0],
      "time_created": "string",
      "time_updated": "string"
    },
    "credential": {
      "credential_json": {
        "google_primary_admin": "string",
        "google_tokens": "string",
        "authentication_method": "string"
      },
      "admin_public": true,
      "source": "string",
      "name": "string",
      "curator_public": false,
      "groups": [],
      "id": 0,
      "user_id": "string",
      "user_email": "string",
      "time_created": "string",
      "time_updated": "string"
    },
    "access_type": "string",
    "groups": []
  }
]

Field	Type	Description
(array items)	object	Connector–credential pair snapshot. See Get Connector Status for field definitions.

Validation Error (422)

{
  "status_code": 422,
  "message": "string",
  "data": null
}

Example

curl "https://chordian-core.chordian.ai/manage/admin/connector?credential=0" \
  -H "Authorization: Bearer <api-key>"

Create Connector

Create a connector (e.g. web connector).

POST /manage/admin/connector

Authentication: Authorization: Bearer <api-key>

Request Body

{
  "name": "string",
  "source": "string",
  "input_type": "string",
  "connector_specific_config": {
    "base_url": "string",
    "web_connector_type": "string"
  },
  "refresh_freq": 0,
  "prune_freq": null,
  "indexing_start": null,
  "access_type": "string",
  "groups": []
}

Field	Type	Required	Description
`name`	string	✅	Connector display name.
`source`	string	✅	Connector source type (e.g. `web`).
`input_type`	string	✅	Input mode (e.g. `load_state`).
`connector_specific_config`	object	✅	Source-specific settings (e.g. `base_url`, `web_connector_type`).
`refresh_freq`	integer	❌	Refresh interval in seconds.
`prune_freq`	integer \| null	❌	Prune interval; `null` to disable.
`indexing_start`	string \| null	❌	When indexing should start.
`access_type`	string	❌	Access level (e.g. `public`).
`groups`	array	❌	Group IDs with access.

Successful Response (200 OK)

Schema: ObjectCreationIdResponse

{}

Field	Type	Description
(schema)	object	Created connector ID. Shape defined by `ObjectCreationIdResponse`.

Validation Error (422)

{
  "status_code": 422,
  "message": "string",
  "data": null
}

Example

curl -X POST "https://chordian-core.chordian.ai/manage/admin/connector" \
  -H "Authorization: Bearer <api-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "string",
    "source": "string",
    "input_type": "string",
    "connector_specific_config": {
      "base_url": "string",
      "web_connector_type": "string"
    },
    "refresh_freq": 0,
    "prune_freq": null,
    "indexing_start": null,
    "access_type": "string",
    "groups": []
  }'

Get CC Pair Full Info

Get full information for a connector–credential pair (CC pair).

GET /manage/admin/cc-pair/{cc_pair_id}

Authentication: Authorization: Bearer <api-key>

Path Parameters

Parameter	Type	Required	Description
`cc_pair_id`	integer	✅	Connector–credential pair identifier

Successful Response (200 OK)

{
  "id": 0,
  "name": "string",
  "status": "string",
  "in_repeated_error_state": false,
  "num_docs_indexed": 0,
  "connector": {
    "name": "string",
    "source": "string",
    "input_type": "string",
    "connector_specific_config": {
      "include_my_drives": true
    },
    "refresh_freq": 0,
    "prune_freq": 0,
    "indexing_start": null,
    "id": 0,
    "credential_ids": [0],
    "time_created": "string",
    "time_updated": "string"
  },
  "credential": {
    "credential_json": {
      "google_primary_admin": "string",
      "google_tokens": "string",
      "authentication_method": "string"
    },
    "admin_public": true,
    "source": "string",
    "name": "string",
    "curator_public": false,
    "groups": [],
    "id": 0,
    "user_id": "string",
    "user_email": "string",
    "time_created": "string",
    "time_updated": "string"
  },
  "number_of_index_attempts": 0,
  "last_index_attempt_status": "string",
  "latest_deletion_attempt": null,
  "access_type": "string",
  "is_editable_for_current_user": true,
  "deletion_failure_message": null,
  "indexing": false,
  "creator": "string",
  "creator_email": "string",
  "last_indexed": "string",
  "last_pruned": null,
  "last_full_permission_sync": null,
  "overall_indexing_speed": 0,
  "latest_checkpoint_description": null,
  "last_permission_sync_attempt_status": null,
  "permission_syncing": false,
  "last_permission_sync_attempt_finished": null,
  "last_permission_sync_attempt_error_message": null
}

Field	Type	Description
`id`	integer	Connector–credential pair identifier (`cc_pair_id`).
`name`	string	Display name for this pair.
`status`	string	Pair status (e.g. `PAUSED`, `SCHEDULED`, `ACTIVE`).
`in_repeated_error_state`	boolean	`true` when the pair is stuck in repeated errors.
`num_docs_indexed`	integer	Number of documents indexed for this pair.
`connector`	object	Connector configuration. See Get Connector Status → Connector.
`credential`	object	Credential details. See Get Connector Status → Credential.
`number_of_index_attempts`	integer	Total index attempts for this pair.
`last_index_attempt_status`	string	Status of the most recent index attempt (e.g. `failed`).
`latest_deletion_attempt`	object \| null	Latest deletion attempt metadata, if any.
`access_type`	string	Access scope (e.g. `public`).
`is_editable_for_current_user`	boolean	Whether the current user may edit this pair.
`deletion_failure_message`	string \| null	Error message when deletion failed.
`indexing`	boolean	`true` while an index job is running.
`creator`	string	Creator user UUID.
`creator_email`	string	Creator email address.
`last_indexed`	string \| null	ISO timestamp of the last successful index.
`last_pruned`	string \| null	ISO timestamp of the last prune run.
`last_full_permission_sync`	string \| null	ISO timestamp of the last full permission sync.
`overall_indexing_speed`	number	Average indexing speed metric.
`latest_checkpoint_description`	string \| null	Description of the latest checkpoint.
`last_permission_sync_attempt_status`	string \| null	Status of the last permission sync attempt.
`permission_syncing`	boolean	`true` while permission sync is in progress.
`last_permission_sync_attempt_finished`	string \| null	ISO timestamp when the last permission sync finished.
`last_permission_sync_attempt_error_message`	string \| null	Error from the last permission sync attempt.

Not Found (404)

{
  "detail": "string"
}

Field	Type	Description
`detail`	string	Error message (e.g. `CC Pair not found for current user permissions`).

Validation Error (422)

{
  "status_code": 422,
  "message": "string",
  "data": null
}

Example

curl "https://chordian-core.chordian.ai/manage/admin/cc-pair/0" \
  -H "Authorization: Bearer <api-key>"

Update CC Pair Status

Update the status of a connector–credential pair (e.g. pause or schedule). Returns nearly immediately; background processes handle cleanup.

PUT /manage/admin/cc-pair/{cc_pair_id}/status

Authentication: Authorization: Bearer <api-key>

Path Parameters

Parameter	Type	Required	Description
`cc_pair_id`	integer	✅	Connector–credential pair identifier

Request Body

{
  "status": "string"
}

Field	Type	Required	Description
`status`	string	✅	New status: `SCHEDULED`, `INITIAL_INDEXING`, `ACTIVE`, `PAUSED`, `DELETING`, or `INVALID`.

Successful Response (200 OK)

{
  "message": "string"
}

Field	Type	Description
`message`	string	Confirmation code (e.g. `"200"`).

Validation Error (422)

{
  "status_code": 422,
  "message": "string",
  "data": null
}

Example

curl -X PUT "https://chordian-core.chordian.ai/manage/admin/cc-pair/0/status" \
  -H "Authorization: Bearer <api-key>" \
  -H "Content-Type: application/json" \
  -d '{"status": "PAUSED"}'

Connector Run Once

Trigger a one-time reindex for a connector and its credentials.

POST /manage/admin/connector/run-once

Authentication: Authorization: Bearer <api-key>

Request Body

{
  "connector_id": 0,
  "credential_ids": [0],
  "from_beginning": false
}

Field	Type	Required	Description
`connector_id`	integer	✅	Connector to reindex.
`credential_ids`	array<integer>	✅	Credential IDs to include in the run.
`from_beginning`	boolean	❌	When `true`, reindex from the beginning; when `false`, incremental.

Successful Response (200 OK)

{
  "success": true,
  "message": "string",
  "data": 0
}

Field	Type	Description
`success`	boolean	`true` when the reindex was queued successfully.
`message`	string	Human-readable status (e.g. `Marked 1 index attempts with indexing triggers.`).
`data`	integer	Number of index attempts triggered.

Not Found (404)

{
  "detail": "string"
}

Field	Type	Description
`detail`	string	Error message (e.g. `Connector by id 0 does not exist.`).

Validation Error (422)

{
  "status_code": 422,
  "message": "string",
  "data": null
}

Example

curl -X POST "https://chordian-core.chordian.ai/manage/admin/connector/run-once" \
  -H "Authorization: Bearer <api-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "connector_id": 0,
    "credential_ids": [0],
    "from_beginning": false
  }'

Create Deletion Attempt

Delete a connector and its associated credential.

POST /manage/admin/deletion-attempt

Authentication: Authorization: Bearer <api-key>

Request Body

{
  "connector_id": 0,
  "credential_id": 0
}

Field	Type	Required	Description
`connector_id`	integer	✅	Connector to delete.
`credential_id`	integer	✅	Credential paired with the connector.

Successful Response (200 OK)

Returns JSON null when the deletion attempt is accepted.

null

Not Found (404)

{
  "detail": "string"
}

Field	Type	Description
`detail`	string	Error message (e.g. `Connector with ID '0' and credential ID '0' does not exist. Has it already been deleted?`).

Validation Error (422)

{
  "status_code": 422,
  "message": "string",
  "data": null
}

Example

curl -X POST "https://chordian-core.chordian.ai/manage/admin/deletion-attempt" \
  -H "Authorization: Bearer <api-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "connector_id": 0,
    "credential_id": 0
  }'

Associate Credential To Connector

Associate a credential with a connector and set pair metadata.

PUT /manage/connector/{connector_id}/credential/{credential_id}

Authentication: Authorization: Bearer <api-key>

Path Parameters

Parameter	Type	Required	Description
`connector_id`	integer	✅	Connector identifier
`credential_id`	integer	✅	Credential identifier

Request Body

{
  "name": "string",
  "access_type": "string",
  "groups": []
}

Field	Type	Required	Description
`name`	string	✅	Display name for the credential pair.
`access_type`	string	❌	Access level (e.g. `public`).
`groups`	array	❌	Group IDs with access.

Successful Response (200 OK)

Schema: StatusResponse_int_

{}

Field	Type	Description
(schema)	object	Status response with integer payload. Shape defined by `StatusResponse_int_`.

Validation Error (422)

{
  "status_code": 422,
  "message": "string",
  "data": null
}

Example

curl -X PUT "https://chordian-core.chordian.ai/manage/connector/0/credential/0" \
  -H "Authorization: Bearer <api-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "string",
    "access_type": "string",
    "groups": []
  }'

Upload Project File

Upload one or more files to a project.

POST /user/projects/file/upload

Authentication: Authorization: Bearer <api-key>

Request Body

multipart/form-data

Field	Type	Required	Description
`files`	file	✅	File(s) to upload. Repeat the field for multiple files.

Successful Response (200 OK)

{
  "user_files": [
    {
      "id": "string",
      "temp_id": null,
      "name": "string",
      "project_id": null,
      "user_id": "string",
      "file_id": "string",
      "created_at": "string",
      "status": "string",
      "last_accessed_at": "string",
      "file_type": "string",
      "chat_file_type": "string",
      "token_count": 0,
      "chunk_count": null
    }
  ],
  "rejected_files": [
    {
      "file_name": "string",
      "reason": "string"
    }
  ]
}

Field	Type	Description
`user_files`	array<object>	Files accepted for processing (see UserFile).
`rejected_files`	array<object>	Files rejected at upload time (see RejectedFile).

UserFile (item of `user_files[]`)

Field	Type	Description
`id`	string	User-file UUID (use in Get Project File Statuses).
`temp_id`	string \| null	Temporary client-side ID, if provided.
`name`	string	Original file name.
`project_id`	string \| null	Associated project ID.
`user_id`	string	Owner user UUID.
`file_id`	string	Internal file storage identifier.
`created_at`	string	ISO timestamp when the file was uploaded.
`status`	string	Processing status (e.g. `PROCESSING`, `COMPLETED`).
`last_accessed_at`	string	ISO timestamp of last access.
`file_type`	string	MIME type (e.g. `image/png`).
`chat_file_type`	string	Chat attachment type (e.g. `image`).
`token_count`	integer	Token count after processing.
`chunk_count`	integer \| null	Number of chunks indexed; `null` while processing.

RejectedFile (item of `rejected_files[]`)

Field	Type	Description
`file_name`	string	Name of the rejected file (may be `[unknown_file]`).
`reason`	string	Rejection reason (e.g. `Unsupported file type:` ).

Validation Error (422)

{
  "status_code": 422,
  "message": "string",
  "data": null
}

Example

curl -X POST "https://chordian-core.chordian.ai/user/projects/file/upload" \
  -H "Authorization: Bearer <api-key>" \
  -F "files=@/path/to/file"

Get Project File Statuses

Poll indexing or processing status for uploaded files.

POST /user/projects/file/statuses

Authentication: Authorization: Bearer <api-key>

Request Body

{
  "file_ids": ["string"]
}

Field	Type	Required	Description
`file_ids`	array<string>	✅	UUIDs returned from Upload Project File.

Successful Response (200 OK)

Array of file status objects (same shape as UserFile in Upload Project File).

[
  {
    "id": "string",
    "temp_id": null,
    "name": "string",
    "project_id": null,
    "user_id": "string",
    "file_id": "string",
    "created_at": "string",
    "status": "string",
    "last_accessed_at": "string",
    "file_type": "string",
    "chat_file_type": "string",
    "token_count": 0,
    "chunk_count": 0
  }
]

Field	Type	Description
(array items)	object	Current status for each requested file. See Upload Project File → UserFile.

Validation Error (422)

{
  "status_code": 422,
  "message": "string",
  "data": null
}

Example

curl -X POST "https://chordian-core.chordian.ai/user/projects/file/statuses" \
  -H "Authorization: Bearer <api-key>" \
  -H "Content-Type: application/json" \
  -d '{"file_ids": ["string"]}'

Deep Research APIs Memory APIs

Enterprise Search APIs

Overview

Send Chat Message

Request Body

Successful Response (200 OK)

ToolCall (item of tool_calls[])

Validation Error (422)

Example

Get User Chat Sessions

Successful Response (200 OK)

ChatSession (item of sessions[])

Validation Error (422)

Example

Create Chat Session

Request Body

Successful Response (200 OK)

Bad Request (400)

Validation Error (422)

Example

Rename Chat Session

Request Body

Successful Response (200 OK)

Validation Error (422)

Example

Get Connector Status

Successful Response (200 OK)

Connector (connector)

Credential (credential)

Validation Error (422)

Example

Get Connectors By Credential

Query Parameters

Successful Response (200 OK)

Validation Error (422)

Example

Create Connector

Request Body

Successful Response (200 OK)

Validation Error (422)

Example

Get CC Pair Full Info

Path Parameters

Successful Response (200 OK)

Not Found (404)

Validation Error (422)

Example

Update CC Pair Status

Path Parameters

Request Body

Successful Response (200 OK)

Validation Error (422)

Example

Connector Run Once

Request Body

Successful Response (200 OK)

Not Found (404)

Validation Error (422)

Example

Create Deletion Attempt

Request Body

Successful Response (200 OK)

Not Found (404)

Validation Error (422)

Example

Associate Credential To Connector

Path Parameters

Request Body

Successful Response (200 OK)

Validation Error (422)

Example

Upload Project File

Request Body

Successful Response (200 OK)

UserFile (item of user_files[])

RejectedFile (item of rejected_files[])

Validation Error (422)

Example

Get Project File Statuses

Request Body

Successful Response (200 OK)

ToolCall (item of `tool_calls[]`)

ChatSession (item of `sessions[]`)

Connector (`connector`)

Credential (`credential`)

UserFile (item of `user_files[]`)

RejectedFile (item of `rejected_files[]`)