assistant

Ask the AI Assistant

Run one turn and answer when it is done: the fallback for a client that cannot open the streaming route. The AI Assistant answers questions about the workspace and the product, and takes the eight workspace actions when asked: each lands as a card under the reply, applied when the workspace's rules allow it and proposed for approval otherwise. A request that needs a table's rows or a search it cannot run is answered with where to ask it.

A turn that breaks still answers 201, with the reply's status set to failed: an error status would roll back the row that records it. A refused turn (the workspace's allowance is spent, or the AI Assistant is paused) answers 429 and writes nothing. A message naming a file that is not yours, or was already sent, answers 422 and writes nothing.

post/assistant/chat/conversations/{conversation_id}/messages/

Request

  • Base URL: https://api.getoneprofile.ai (the document declares no server; this is the origin it was published from)
  • URL: https://api.getoneprofile.ai/assistant/chat/conversations/{conversation_id}/messages/
  • Auth: one of:
    • API key in header X-API-Key
    • HTTP bearer

Path parameters

conversation_idstring uuid required

Request body

attachment_idsstring[]

The files sent with this message, as the attachments route returned them when they were uploaded: CSV, Excel or PDF, each of them yours and not yet sent with another message. The assistant reads a spreadsheet's columns and rows and a PDF's pages. Optional.

pastedstring[] nullable

A list you pasted rather than typed: domains, emails, names, one per entry. Sent as data instead of prose, so the assistant reads it as a list and the conversation shows it as a count rather than a wall of text. Optional.

promptstring required
quotestring nullable

Part of an earlier reply you selected, sent with your words so the assistant knows what they refer to. Kept with the message and shown above it in the conversation. Optional.

Response

Successful Response

Changes

No recorded changes to this operation across all 1 revision of this API.