veryfront__create_conversation_messageAccess
No external-service connection is required. Use a Veryfront credential with access to the requested resources. Call type: Can change resources.Arguments
| Field | Type | Required | Description and constraints |
|---|---|---|---|
conversation_id | string | Yes | Conversation identifier that scopes the request. Format: uuid. |
composing_user_id | string | No | Provide the composing user id. Format: uuid. |
parent_id | string | No | Provide the parent id. Format: uuid. |
role | string | No | Provide the role. Default: "user". Value: "user". |
parts | object or object or object or object or object or object or object or object or object or object or object[] | Yes | Provide one or more part values. |
idempotency_key | string | No | Provide the idempotency key. Maximum length: 255. |
metadata | object | No | Additional structured metadata for the request. |
Example request
Send this JSON-RPC request through an initialized MCP client. Replace sample identifiers and values before calling the tool. See MCP client setup.request.json
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "veryfront__create_conversation_message",
"arguments": {
"conversation_id": "00000000-0000-4000-8000-000000000000",
"parts": [
{
"type": "text",
"text": "example"
}
]
}
}
}
Result
The published output shape is summarized below. Inspect both the MCP response content andisError when handling a call.
| Field | Type | Required | Description and constraints |
|---|---|---|---|
id | string | Yes | Message identifier. |
conversation_id | string | Yes | Conversation identifier that owns the message. |
parent_id | string or null | Yes | Parent message identifier when the message belongs to a branch or reply chain. |
seq | number | Yes | Monotonic sequence number within the conversation. |
role | string | Yes | Message role such as user, assistant, tool, or system. |
created_by | string or null | Yes | User or actor identifier that created the message. |
sender_type | string | Yes | Sender kind: user, webhook, service_account, integration, agent or system. |
sender_id | string or null | Yes | Sender identifier: the participant or agent for an agent message, otherwise the author. |
sender_display_name | string or null | Yes | Human-readable sender name when available. |
parts | value[] | Yes | Structured message parts, including text, tool invocations, or rich content blocks. |
model | string or null | Yes | Model identifier that generated the message, when applicable. |
run_usage | object or null | No | Token usage and cost of the whole run that produced an assistant message; absent when none is recorded. |
token_usage | value or null | No | Token accounting metadata associated with the message. |
finish_reason | string or null | Yes | Completion finish reason for model-generated messages. |
cost_credits | string or null | Yes | Credit cost attributed to the message, when tracked. |
status | string | Yes | Lifecycle status of the message. |
edited_at | string or null | Yes | Timestamp when the message was edited, or null when unedited. |
idempotency_key | string or null | Yes | Idempotency key used to deduplicate message creation requests. |
metadata | object or null | Yes | Additional machine-readable message metadata. |
created_at | string | Yes | Timestamp when the message was created. |
updated_at | string or null | Yes | Timestamp when the message was last updated. |
Full schemas
{
"type": "object",
"properties": {
"conversation_id": {
"type": "string",
"format": "uuid",
"description": "Conversation identifier that scopes the request."
},
"composing_user_id": {
"type": "string",
"format": "uuid",
"description": "Provide the composing user id."
},
"parent_id": {
"type": "string",
"format": "uuid",
"description": "Provide the parent id."
},
"role": {
"type": "string",
"const": "user",
"description": "Provide the role.",
"default": "user"
},
"parts": {
"type": "array",
"items": {
"anyOf": [
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "text",
"description": "Provide the type."
},
"text": {
"type": "string",
"maxLength": 100000,
"description": "Provide the text."
}
},
"required": [
"type",
"text"
],
"additionalProperties": false,
"description": "Structured option 1 details used by the tool."
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "image",
"description": "Provide the type."
},
"upload_id": {
"type": "string",
"format": "uuid",
"description": "Provide the upload id."
},
"media_type": {
"type": "string",
"description": "Provide the media type."
},
"url": {
"type": "string",
"description": "Provide the url."
}
},
"required": [
"type",
"upload_id",
"media_type"
],
"additionalProperties": false,
"description": "Structured option 2 details used by the tool."
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "file",
"description": "Provide the type."
},
"upload_id": {
"type": "string",
"format": "uuid",
"description": "Provide the upload id."
},
"media_type": {
"type": "string",
"description": "Provide the media type."
},
"filename": {
"type": "string",
"description": "Provide the filename."
},
"url": {
"type": "string",
"description": "Provide the url."
}
},
"required": [
"type",
"media_type"
],
"additionalProperties": false,
"description": "Structured option 3 details used by the tool."
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "tool_call",
"description": "Provide the type."
},
"id": {
"type": "string",
"description": "Unique identifier for the target record."
},
"name": {
"type": "string",
"description": "Human-readable name for the target record."
},
"input": {
"type": "object",
"additionalProperties": {
"description": "Additional structured values supplied to the tool."
},
"description": "Structured input details used by the tool."
},
"state": {
"type": "string",
"enum": [
"streaming",
"pending",
"completed",
"error"
],
"description": "Provide the state."
}
},
"required": [
"type",
"id",
"name",
"input",
"state"
],
"additionalProperties": false,
"description": "Structured option 4 details used by the tool."
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "tool_result",
"description": "Provide the type."
},
"tool_call_id": {
"type": "string",
"description": "Tool call identifier that links this request to a prior tool invocation."
},
"output": {
"description": "Provide the output."
},
"is_error": {
"type": "boolean",
"description": "Provide the is error."
}
},
"required": [
"type",
"tool_call_id"
],
"additionalProperties": false,
"description": "Structured option 5 details used by the tool."
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "reasoning",
"description": "Provide the type."
},
"text": {
"type": "string",
"maxLength": 100000,
"description": "Provide the text."
},
"signature": {
"type": "string",
"description": "Provide the signature."
}
},
"required": [
"type",
"text"
],
"additionalProperties": false,
"description": "Structured option 6 details used by the tool."
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "citation",
"description": "Provide the type."
},
"source_id": {
"type": "string",
"description": "Provide the source id."
},
"url": {
"type": "string",
"description": "Provide the url."
},
"title": {
"type": "string",
"description": "Short human-readable title for the record."
},
"quote": {
"type": "string",
"description": "Provide the quote."
}
},
"required": [
"type",
"source_id"
],
"additionalProperties": false,
"description": "Structured option 7 details used by the tool."
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "source_document",
"description": "Provide the type."
},
"source_id": {
"type": "string",
"description": "Provide the source id."
},
"media_type": {
"type": "string",
"description": "Provide the media type."
},
"title": {
"type": "string",
"description": "Short human-readable title for the record."
},
"filename": {
"type": "string",
"description": "Provide the filename."
}
},
"required": [
"type",
"source_id",
"media_type",
"title"
],
"additionalProperties": false,
"description": "Structured option 8 details used by the tool."
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "step_start",
"description": "Provide the type."
}
},
"required": [
"type"
],
"additionalProperties": false,
"description": "Structured option 9 details used by the tool."
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "error",
"description": "Provide the type."
},
"code": {
"type": "string",
"description": "Provide the code."
},
"message": {
"type": "string",
"description": "Provide the message."
}
},
"required": [
"type",
"code",
"message"
],
"additionalProperties": false,
"description": "Structured option 10 details used by the tool."
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "data",
"description": "Provide the type."
},
"name": {
"type": "string",
"description": "Human-readable name for the target record."
},
"value": {
"description": "Provide the value."
}
},
"required": [
"type",
"name"
],
"additionalProperties": false,
"description": "Structured option 11 details used by the tool."
}
],
"description": "One part item supplied to the tool."
},
"minItems": 1,
"maxItems": 200,
"description": "Provide one or more part values."
},
"idempotency_key": {
"type": "string",
"maxLength": 255,
"description": "Provide the idempotency key."
},
"metadata": {
"type": "object",
"additionalProperties": {
"description": "Additional structured values supplied to the tool."
},
"description": "Additional structured metadata for the request."
}
},
"required": [
"conversation_id",
"parts"
],
"additionalProperties": false,
"description": "Arguments for the create_conversation_message tool.",
"$schema": "http://json-schema.org/draft-07/schema#"
}
{
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Message identifier."
},
"conversation_id": {
"type": "string",
"description": "Conversation identifier that owns the message."
},
"parent_id": {
"type": [
"string",
"null"
],
"description": "Parent message identifier when the message belongs to a branch or reply chain."
},
"seq": {
"type": "number",
"description": "Monotonic sequence number within the conversation."
},
"role": {
"type": "string",
"description": "Message role such as user, assistant, tool, or system."
},
"created_by": {
"type": [
"string",
"null"
],
"description": "User or actor identifier that created the message."
},
"sender_type": {
"type": "string",
"description": "Sender kind: user, webhook, service_account, integration, agent or system."
},
"sender_id": {
"type": [
"string",
"null"
],
"description": "Sender identifier: the participant or agent for an agent message, otherwise the author."
},
"sender_display_name": {
"type": [
"string",
"null"
],
"description": "Human-readable sender name when available."
},
"parts": {
"type": "array",
"items": {
"description": "One part item associated with this record."
},
"description": "Structured message parts, including text, tool invocations, or rich content blocks."
},
"model": {
"type": [
"string",
"null"
],
"description": "Model identifier that generated the message, when applicable."
},
"run_usage": {
"anyOf": [
{
"type": "object",
"properties": {
"scope": {
"type": "string",
"const": "run",
"description": "The scope associated with this record."
},
"model": {
"type": [
"string",
"null"
],
"description": "AI model id or alias. Call list_models for the ids this deployment serves; never invent a version suffix."
},
"input_tokens": {
"type": "integer",
"minimum": 0,
"description": "The input tokens associated with this record."
},
"output_tokens": {
"type": "integer",
"minimum": 0,
"description": "The output tokens associated with this record."
},
"cache_creation_input_tokens": {
"type": "integer",
"minimum": 0,
"description": "The cache creation input tokens associated with this record."
},
"cache_read_input_tokens": {
"type": "integer",
"minimum": 0,
"description": "The cache read input tokens associated with this record."
},
"reasoning_tokens": {
"type": "integer",
"minimum": 0,
"description": "The reasoning tokens associated with this record."
},
"total_tokens": {
"type": "integer",
"minimum": 0,
"description": "The total tokens associated with this record."
},
"model_calls": {
"type": "integer",
"minimum": 0,
"description": "The model calls associated with this record."
},
"cost_credits": {
"type": [
"string",
"null"
],
"description": "The cost credits associated with this record."
}
},
"required": [
"scope",
"model",
"input_tokens",
"output_tokens",
"cache_creation_input_tokens",
"cache_read_input_tokens",
"reasoning_tokens",
"total_tokens",
"model_calls",
"cost_credits"
],
"additionalProperties": false,
"description": "Structured run usage details associated with this record."
},
{
"type": "null",
"description": "The run usage returned by the tool."
}
],
"description": "Token usage and cost of the whole run that produced an assistant message; absent when none is recorded."
},
"token_usage": {
"anyOf": [
{
"description": "The token usage associated with this record."
},
{
"type": "null",
"description": "The token usage returned by the tool."
}
],
"description": "Token accounting metadata associated with the message."
},
"finish_reason": {
"type": [
"string",
"null"
],
"description": "Completion finish reason for model-generated messages."
},
"cost_credits": {
"type": [
"string",
"null"
],
"description": "Credit cost attributed to the message, when tracked."
},
"status": {
"type": "string",
"description": "Lifecycle status of the message."
},
"edited_at": {
"type": [
"string",
"null"
],
"description": "Timestamp when the message was edited, or null when unedited."
},
"idempotency_key": {
"type": [
"string",
"null"
],
"description": "Idempotency key used to deduplicate message creation requests."
},
"metadata": {
"anyOf": [
{
"type": "object",
"additionalProperties": {
"description": "Additional structured values associated with this result."
},
"description": "Additional structured metadata for the record."
},
{
"type": "null",
"description": "Additional structured metadata returned by the tool."
}
],
"description": "Additional machine-readable message metadata."
},
"created_at": {
"type": "string",
"description": "Timestamp when the message was created."
},
"updated_at": {
"type": [
"string",
"null"
],
"description": "Timestamp when the message was last updated."
}
},
"required": [
"id",
"conversation_id",
"parent_id",
"seq",
"role",
"created_by",
"sender_type",
"sender_id",
"sender_display_name",
"parts",
"model",
"finish_reason",
"cost_credits",
"status",
"edited_at",
"idempotency_key",
"metadata",
"created_at",
"updated_at"
],
"additionalProperties": false,
"description": "Conversation message record returned by MCP conversation tools.",
"$schema": "http://json-schema.org/draft-07/schema#"
}