API Reference

Send follow-up message.

post
https://app.customgpt.ai/api/v1/projects//tasks//messages

Submits a follow-up prompt to an existing task. The task must not currently be processing a previous message. Returns 202 Accepted; poll the task for progress.

Returns 409 if the task is locked by an active session.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
integer
required

The unique identifier of the agent.

string
required

The task ID.

Body Params

Send a follow-up prompt to an existing task. Continues the conversation within the same task context.

string
required

Prompt to send to the agent

string | null
enum

Agent model to use for the task

string | null

Custom persona to use for the task

string | null
enum
Defaults to default

Controls which knowledge the agent draws from.

Values:

  • default / own_content — agent answers using only your indexed content (recommended).
  • openai_content — agent supplements your indexed content with general knowledge from the underlying model.
Allowed:
string | null

Custom context to use for the task

files[]
array of files | null

Multiple files to upload (Allowed types: pdf, docx, doc, odt, txt, jpg, jpeg, png, webp)

labels[]
array | null

Optional source-label filter (IDs or names).

  • Single group (OR): labels[0][]=A&labels[0][]=B
  • Multiple groups (AND-of-ORs, inner OR / outer AND): labels[0][]=A&labels[0][]=B&labels[1][]=C&labels[1][]=D → (A OR B) AND (C OR D)

Limits: max 20 groups, 50 per group, 500 total.

Unknown labels are dropped; a group emptied by dropping matches nothing.

labels[]
boolean
Defaults to false

If true, search only pages with provided labels. If false, search pages with provided labels plus unlabeled pages.

Responses

Updated 27 days ago

Language
Credentials
Bearer
JWT
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 27 days ago