Skip to main content
POST
/
chats
/
{chat_id}
/
messages
/
{message_id}
/
approvals
/
{tool_call_id}
Decide Action Approval
curl --request POST \
  --url https://api.useinvent.com/chats/{chat_id}/messages/{message_id}/approvals/{tool_call_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "reason": "<string>",
  "background": true
}
'
{
  "id": "<string>",
  "model": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "messages": [
    {
      "parts": [
        {
          "text": "<string>",
          "audio": {
            "id": "<string>",
            "file_path": "<string>",
            "file_filename": "document.pdf",
            "file_size": 1024,
            "file_mimetype": "application/pdf",
            "file_url": "<string>",
            "created_at": "2023-11-07T05:31:56Z"
          },
          "start_timestamp": 123,
          "end_timestamp": 123
        }
      ]
    }
  ],
  "tools": [
    {
      "name": "<string>",
      "display_name": "<string>",
      "action_name": "<string>",
      "description": "<string>",
      "icon_url": "<string>",
      "parameters": {},
      "enabled_by_default": true,
      "callback": "<string>",
      "validation": "<string>"
    }
  ],
  "features": {
    "web_search": {},
    "reasoning": {}
  },
  "member": {
    "id": "<string>",
    "user": {
      "id": "<string>",
      "name": "<string>",
      "avatar": "<string>"
    },
    "session": {
      "id": "<string>"
    },
    "contact_channel": {
      "id": "<string>",
      "user_id": "<string>",
      "avatar": "<string>",
      "name": "<string>",
      "username": "<string>",
      "email": "jsmith@example.com",
      "phone": "<string>",
      "country": "<string>",
      "agent": "<string>",
      "ip": "<string>",
      "language": "<string>",
      "contact": {
        "id": "<string>",
        "name": "<string>",
        "blocked": true,
        "is_admin": true
      },
      "link": "<string>"
    }
  },
  "error": "<string>",
  "broadcast_id": "<string>",
  "is_broadcast_message": true,
  "usage": {
    "input_tokens": 123,
    "output_tokens": 123,
    "total_tokens": 123,
    "reasoning_tokens": 123,
    "input_tokens_cache_read": 123,
    "input_tokens_cache_write": 123,
    "turns": [
      {
        "input_tokens": 123,
        "output_tokens": 123,
        "total_tokens": 123,
        "reasoning_tokens": 123,
        "input_tokens_cache_read": 123,
        "input_tokens_cache_write": 123
      }
    ]
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.useinvent.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Bearer token authentication using your API key

Path Parameters

​
chat_id
string
required

Chat ID

​
message_id
string
required

Message ID

​
tool_call_id
string
required

The ID of the tool call to decide on.

Body

Accept or reject a pending approval on an assistant action

​
decision
enum<string>
required

How a pending approval was resolved

Available options:
accepted,
rejected
​
reason
string

Optional explanation for the decision. When rejecting, this is surfaced back to the assistant.

Maximum string length: 512
​
background
boolean

When true, the decision is recorded immediately and the approved tool runs in the background — the response returns the "running" state. Defaults to false, which blocks until the tool finishes executing and returns the final message.

Response

200 - application/json

The chat message schema

​
id
string
required
​
role
enum<string>
required

The role of the message

Available options:
user,
assistant,
system,
tool,
event,
note
​
model
string
required

The model used for the message

​
status
enum<string>
required

The chat status

Available options:
RUNNING,
COMPLETED,
FAILED,
CANCELED
​
created_at
string<date-time> | null
required
​
updated_at
string<date-time> | null
required
​
messages
object[]

The message content

System message

​
tools
object[]

The tools used in the message

Maximum array length: 10
​
features
object

Enabled features for the model

​
member
object

The member of the chat

​
error
string

Error message if the message failed

​
broadcast_id
string

ID of the broadcast this message originates from

​
is_broadcast_message
boolean

Whether this message was sent via a broadcast template

​
usage
object

The usage information for the message