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)

files[]
labels[]
array of strings | null

Optional source-label filter (IDs or names) to scope which indexed content the agent uses for this message. Flat array only — e.g. labels[]=A&labels[]=B (OR semantics). Max 500 labels, 20 characters each. Unknown labels are dropped.

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 7 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 7 days ago