Skip to content
Full-Fill Docs

Send chat message

POST
/api/v2/chat/sessions/{id}/messages/
curl --request POST \
  --url https://api.full-fill.ai/api/v2/chat/sessions/1/messages/ \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <X-API-Key>' \
  --data '{ "message": "example", "file_id": 1, "context": "", "offering_ids": [ 1 ] }'

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
id
required
integer

A unique integer value identifying this chat session.

Request Bodyrequired

Section titled “Request Bodyrequired”

Input validation for chat message actions.

object
message
required
string
<= 4000 characters
file_id
integer
nullable
context
string
"" <= 8000 characters
offering_ids
Array<integer>

Responses

Section titled “Responses”

200

Section titled “200”

Serializer for session list (lightweight).

object
id
integer
title

Auto-generated from first message or user-customizable

string
default: New Chat <= 200 characters
created_at
string format: date-time
updated_at

For sorting by most recent activity

string format: date-time
is_archived

For soft deletion

boolean
message_count
integer
0
last_message
object
key
additional properties
messages
Array<object>
object
id
integer
sender
  • user - User
  • assistant - Assistant
string
Allowed values: user assistant
content

The message text

string
created_at
string format: date-time
is_edited
boolean
metadata

Store source info, confidence, etc.

nullable
sources
Array<object>
object
id
integer
type
string
relevance_score
required

Vector similarity score

number format: double
content
string
source_file
string
page_number
integer
context_header
string
source_url
string
Example
{
  "title": "New Chat",
  "message_count": 0,
  "messages": [
    {
      "sender": "user"
    }
  ]
}