Ai API

GET /ai/batch/{job_id}

Get AI Batch Job Status

Get batch job status and results.

Parameters

Responses

Example

curl -X GET http://localhost:8000/ai/batch/:job_id \
  -H "Authorization: Bearer $TOKEN"

GET /ai/conversations

List AI Conversations

List conversations, newest first, each with its count of open proposals.

Parameters

Responses

Example

curl -X GET http://localhost:8000/ai/conversations \
  -H "Authorization: Bearer $TOKEN"

POST /ai/conversations

Create AI Conversation

Create a new conversation.

Request body

Responses

Example

curl -X POST http://localhost:8000/ai/conversations \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ ... }'

GET /ai/conversations/{conversation_id}

Get AI Conversation

Get a conversation with its messages and the reading jobs started from it.

Parameters

Responses

Example

curl -X GET http://localhost:8000/ai/conversations/:conversation_id \
  -H "Authorization: Bearer $TOKEN"

PATCH /ai/conversations/{conversation_id}

Rename AI Conversation

Rename a conversation.

Parameters

Request body

Responses

Example

curl -X PATCH http://localhost:8000/ai/conversations/:conversation_id \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ ... }'

DELETE /ai/conversations/{conversation_id}

Delete AI Conversation

Delete a conversation and all its messages.

Parameters

Responses

Example

curl -X DELETE http://localhost:8000/ai/conversations/:conversation_id \
  -H "Authorization: Bearer $TOKEN"

POST /ai/conversations/{conversation_id}/confirm

Confirm AI-Proposed Action

Execute one pending AI-proposed business action that the user has explicitly confirmed.

Parameters

Request body

Responses

Example

curl -X POST http://localhost:8000/ai/conversations/:conversation_id/confirm \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ ... }'

POST /ai/conversations/{conversation_id}/confirm-all

Confirm Multiple AI-Proposed Actions

Execute the selected pending AI-proposed actions for a message.

Parameters

Request body

Responses

Example

curl -X POST http://localhost:8000/ai/conversations/:conversation_id/confirm-all \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ ... }'

POST /ai/conversations/{conversation_id}/dismiss

Dismiss AI-Proposed Action

Dismiss one pending AI-proposed action so it no longer appears as awaiting confirmation.

Parameters

Request body

Responses

Example

curl -X POST http://localhost:8000/ai/conversations/:conversation_id/dismiss \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ ... }'

POST /ai/conversations/{conversation_id}/dismiss-all

Dismiss Multiple AI-Proposed Actions

Dismiss the selected pending AI-proposed actions for a message.

Parameters

Request body

Responses

Example

curl -X POST http://localhost:8000/ai/conversations/:conversation_id/dismiss-all \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ ... }'

POST /ai/conversations/{conversation_id}/jobs/{job_id}/proposals

Create Bill Proposals from AI Job

Convert a completed AI document-reading job into bill-related proposals for user review and confirmation. No business record is created until the relevant proposal is confirmed.

Parameters

Responses

Example

curl -X POST http://localhost:8000/ai/conversations/:conversation_id/jobs/:job_id/proposals \
  -H "Authorization: Bearer $TOKEN"

POST /ai/conversations/{conversation_id}/query

Send Message to AI Conversation

Send a message or supported files to an AI conversation. Read operations can return answers directly, while proposed business changes are returned for user confirmation.

Parameters

Request body

Responses

Example

curl -X POST http://localhost:8000/ai/conversations/:conversation_id/query \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ ... }'

POST /ai/estimate-credits

Estimate AI Credit Usage

Estimate the current AI processing cost for the supplied files.

Request body

Responses

Example

curl -X POST http://localhost:8000/ai/estimate-credits \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ ... }'

GET /ai/file/{file_id}

Get AI Uploaded File

Retrieve a previously uploaded file.

Parameters

Responses

Example

curl -X GET http://localhost:8000/ai/file/:file_id \
  -H "Authorization: Bearer $TOKEN"

GET /ai/memory

Get AI Memory

Return the per-company AI memory (notes and key-value facts).

Responses

Example

curl -X GET http://localhost:8000/ai/memory \
  -H "Authorization: Bearer $TOKEN"

DELETE /ai/memory

Clear AI Memory

Wipe all AI memory for this company.

Responses

Example

curl -X DELETE http://localhost:8000/ai/memory \
  -H "Authorization: Bearer $TOKEN"

POST /ai/memory/kv

Set AI Memory Fact

Set a key-value fact in AI memory (max 100 keys).

Request body

Responses

Example

curl -X POST http://localhost:8000/ai/memory/kv \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ ... }'

POST /ai/memory/notes

Add AI Memory Note

Append a note to AI memory (max 50 notes, oldest trimmed).

Request body

Responses

Example

curl -X POST http://localhost:8000/ai/memory/notes \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ ... }'

POST /ai/query

Run Read-Only AI ERP Query

Run a one-off, read-only natural-language query against the company's current ERP data.

Request body

Responses

Example

curl -X POST http://localhost:8000/ai/query \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ ... }'

GET /ai/quota-status

Get AI Quota Status

Return the current AI usage allowance, consumption, and remaining capacity available to the company.

Responses

Example

curl -X GET http://localhost:8000/ai/quota-status \
  -H "Authorization: Bearer $TOKEN"

POST /ai/upload

Upload Files for AI Processing

Upload files for AI batch processing. Returns list of file IDs.

Responses

Example

curl -X POST http://localhost:8000/ai/upload \
  -H "Authorization: Bearer $TOKEN"

GET /ai/usage-stats

Get AI Usage Statistics

Return per-user AI usage statistics for the current calendar month.

Responses

Example

curl -X GET http://localhost:8000/ai/usage-stats \
  -H "Authorization: Bearer $TOKEN"