Platform for stateful agents: AI with advanced memory that can learn and self-improve over time.
chore: add scheduled message api to docs (#8348)
Shubham Naik6e64b59d8a12
diff --git a/fern/openapi.json b/fern/openapi.jsonindex ac17d496c..35def53dd 100644--- a/fern/openapi.json+++ b/fern/openapi.json@@ -16944,198 +16944,6 @@}}},- "/v1/agents/{agent_id}/messages/scheduled": {- "post": {- "description": "Schedule a message to be sent by the agent at a specified time or on a recurring basis.",- "summary": "Schedule Agent Message",- "tags": ["agents"],- "parameters": [- {- "name": "agent_id",- "in": "path",- "required": true,- "schema": {- "type": "string"- }- }- ],- "operationId": "agents.scheduleAgentMessage",- "requestBody": {- "description": "Body",- "content": {- "application/json": {- "schema": {- "type": "object",- "properties": {- "messages": {- "type": "array",- "items": {- "type": "object",- "properties": {- "content": {- "oneOf": [- {- "type": "array",- "items": {- "oneOf": [- {- "type": "object",- "properties": {- "text": {- "type": "string"- },- "signature": {- "type": "string",- "nullable": true- },- "type": {- "type": "string",- "enum": ["text"]- }- },- "required": ["text"]- },- {- "type": "object",- "properties": {- "source": {- "type": "object",- "properties": {- "data": {- "type": "string"- },- "media_type": {- "type": "string"- },- "detail": {- "type": "string"- },- "type": {- "type": "string",- "enum": ["base64"]- }- },- "required": ["data", "media_type"]- },- "type": {- "type": "string",- "enum": ["image"]- }- },- "required": ["source", "type"]- }- ]- }- },- {- "type": "string"- }- ]- },- "role": {- "type": "string",- "enum": ["user", "assistant", "system"]- },- "name": {- "type": "string"- },- "otid": {- "type": "string"- },- "sender_id": {- "type": "string"- },- "type": {- "type": "string",- "enum": ["message"]- }- },- "required": ["content", "role"]- }- },- "max_steps": {- "type": "number"- },- "callback_url": {- "type": "string",- "format": "uri"- },- "include_return_message_types": {- "type": "array",- "items": {- "type": "string",- "enum": [- "system_message",- "user_message",- "assistant_message",- "reasoning_message",- "hidden_reasoning_message",- "tool_call_message",- "tool_return_message",- "approval_request_message",- "approval_response_message"- ]- }- },- "schedule": {- "oneOf": [- {- "type": "object",- "properties": {- "type": {- "type": "string",- "enum": ["one-time"]- },- "scheduled_at": {- "type": "number"- }- },- "required": ["scheduled_at"]- },- {- "type": "object",- "properties": {- "type": {- "type": "string",- "enum": ["recurring"]- },- "cron_expression": {- "type": "string"- }- },- "required": ["type", "cron_expression"]- }- ]- }- },- "required": ["messages", "schedule"]- }- }- }- },- "responses": {- "200": {- "description": "200",- "content": {- "application/json": {- "schema": {- "type": "object",- "properties": {- "id": {- "type": "string"- },- "next_scheduled_at": {- "type": "string"- }- },- "required": ["id"]- }- }- }- }- }- }- },"/v1/agents/{agent_id}/core-memory/variables": {"get": {"description": "Get the variables associated with an agent",@@ -20782,14 +20590,14 @@}}},- "/v1/scheduled-messages/{scheduled_message_id}": {- "delete": {- "description": "Delete a scheduled message by its ID for a specific agent.",- "summary": "Delete Scheduled Agent Message",+ "/v1/agents/{agent_id}/schedule": {+ "post": {+ "description": "Schedule a message to be sent by the agent at a specified time or on a recurring basis.",+ "summary": "Schedule Agent Message","tags": ["scheduledMessages"],"parameters": [{- "name": "scheduled_message_id",+ "name": "agent_id","in": "path","required": true,"schema": {@@ -20797,70 +20605,500 @@}}],- "operationId": "scheduledMessages.deleteScheduledMessage",+ "operationId": "scheduledMessages.scheduleAgentMessage","requestBody": {"description": "Body","content": {"application/json": {"schema": {"type": "object",- "properties": {},- "nullable": true- }- }- }- },- "responses": {- "200": {- "description": "200",- "content": {- "application/json": {- "schema": {- "type": "object",- "properties": {- "success": {- "type": "boolean",- "enum": [true]- }- },- "required": ["success"]- }- }- }- }- }- },- "get": {- "description": "Retrieve a scheduled message by its ID for a specific agent.",- "summary": "Retrieve Scheduled Agent Message",- "tags": ["scheduledMessages"],- "parameters": [- {- "name": "scheduled_message_id",- "in": "path",- "required": true,- "schema": {- "type": "string"- }- }- ],- "operationId": "scheduledMessages.retrieveScheduledMessage",- "responses": {- "200": {- "description": "200",- "content": {- "application/json": {- "schema": {- "type": "object",- "properties": {- "id": {- "type": "string"- },- "agent_id": {- "type": "string"- },- "message": {- "type": "object",+ "properties": {+ "messages": {+ "type": "array",+ "items": {+ "type": "object",+ "properties": {+ "content": {+ "oneOf": [+ {+ "type": "array",+ "items": {+ "oneOf": [+ {+ "type": "object",+ "properties": {+ "text": {+ "type": "string"+ },+ "signature": {+ "type": "string",+ "nullable": true+ },+ "type": {+ "type": "string",+ "enum": ["text"]+ }+ },+ "required": ["text"]+ },+ {+ "type": "object",+ "properties": {+ "source": {+ "type": "object",+ "properties": {+ "data": {+ "type": "string"+ },+ "media_type": {+ "type": "string"+ },+ "detail": {+ "type": "string"+ },+ "type": {+ "type": "string",+ "enum": ["base64"]+ }+ },+ "required": ["data", "media_type"]+ },+ "type": {+ "type": "string",+ "enum": ["image"]+ }+ },+ "required": ["source", "type"]+ }+ ]+ }+ },+ {+ "type": "string"+ }+ ]+ },+ "role": {+ "type": "string",+ "enum": ["user", "assistant", "system"]+ },+ "name": {+ "type": "string"+ },+ "otid": {+ "type": "string"+ },+ "sender_id": {+ "type": "string"+ },+ "type": {+ "type": "string",+ "enum": ["message"]+ }+ },+ "required": ["content", "role"]+ }+ },+ "max_steps": {+ "type": "number"+ },+ "callback_url": {+ "type": "string",+ "format": "uri"+ },+ "include_return_message_types": {+ "type": "array",+ "items": {+ "type": "string",+ "enum": [+ "system_message",+ "user_message",+ "assistant_message",+ "reasoning_message",+ "hidden_reasoning_message",+ "tool_call_message",+ "tool_return_message",+ "approval_request_message",+ "approval_response_message"+ ]+ }+ },+ "schedule": {+ "oneOf": [+ {+ "type": "object",+ "properties": {+ "type": {+ "type": "string",+ "enum": ["one-time"]+ },+ "scheduled_at": {+ "type": "number"+ }+ },+ "required": ["scheduled_at"]+ },+ {+ "type": "object",+ "properties": {+ "type": {+ "type": "string",+ "enum": ["recurring"]+ },+ "cron_expression": {+ "type": "string"+ }+ },+ "required": ["type", "cron_expression"]+ }+ ]+ }+ },+ "required": ["messages", "schedule"]+ }+ }+ }+ },+ "responses": {+ "201": {+ "description": "201",+ "content": {+ "application/json": {+ "schema": {+ "type": "object",+ "properties": {+ "id": {+ "type": "string"+ },+ "next_scheduled_at": {+ "type": "string"+ }+ },+ "required": ["id"]+ }+ }+ }+ }+ }+ },+ "get": {+ "description": "List all scheduled messages for a specific agent.",+ "summary": "List Scheduled Agent Messages",+ "tags": ["scheduledMessages"],+ "parameters": [+ {+ "name": "agent_id",+ "in": "path",+ "required": true,+ "schema": {+ "type": "string"+ }+ },+ {+ "name": "limit",+ "in": "query",+ "schema": {+ "type": "string"+ }+ },+ {+ "name": "after",+ "in": "query",+ "schema": {+ "type": "string"+ }+ }+ ],+ "operationId": "scheduledMessages.listScheduledMessages",+ "responses": {+ "200": {+ "description": "200",+ "content": {+ "application/json": {+ "schema": {+ "type": "object",+ "properties": {+ "scheduled_messages": {+ "type": "array",+ "items": {+ "type": "object",+ "properties": {+ "id": {+ "type": "string"+ },+ "agent_id": {+ "type": "string"+ },+ "message": {+ "type": "object",+ "properties": {+ "messages": {+ "type": "array",+ "items": {+ "type": "object",+ "properties": {+ "content": {+ "oneOf": [+ {+ "type": "array",+ "items": {+ "oneOf": [+ {+ "type": "object",+ "properties": {+ "text": {+ "type": "string"+ },+ "signature": {+ "type": "string",+ "nullable": true+ },+ "type": {+ "type": "string",+ "enum": ["text"]+ }+ },+ "required": ["text"]+ },+ {+ "type": "object",+ "properties": {+ "source": {+ "type": "object",+ "properties": {+ "data": {+ "type": "string"+ },+ "media_type": {+ "type": "string"+ },+ "detail": {+ "type": "string"+ },+ "type": {+ "type": "string",+ "enum": ["base64"]+ }+ },+ "required": [+ "data",+ "media_type"+ ]+ },+ "type": {+ "type": "string",+ "enum": ["image"]+ }+ },+ "required": ["source", "type"]+ }+ ]+ }+ },+ {+ "type": "string"+ }+ ]+ },+ "role": {+ "type": "string",+ "enum": ["user", "assistant", "system"]+ },+ "name": {+ "type": "string"+ },+ "otid": {+ "type": "string"+ },+ "sender_id": {+ "type": "string"+ },+ "type": {+ "type": "string",+ "enum": ["message"]+ }+ },+ "required": ["content", "role"]+ }+ },+ "max_steps": {+ "type": "number"+ },+ "callback_url": {+ "type": "string",+ "format": "uri"+ },+ "include_return_message_types": {+ "type": "array",+ "items": {+ "type": "string",+ "enum": [+ "system_message",+ "user_message",+ "assistant_message",+ "reasoning_message",+ "hidden_reasoning_message",+ "tool_call_message",+ "tool_return_message",+ "approval_request_message",+ "approval_response_message"+ ]+ }+ }+ },+ "required": ["messages"]+ },+ "schedule": {+ "oneOf": [+ {+ "type": "object",+ "properties": {+ "type": {+ "type": "string",+ "enum": ["one-time"]+ },+ "scheduled_at": {+ "type": "number"+ }+ },+ "required": ["scheduled_at"]+ },+ {+ "type": "object",+ "properties": {+ "type": {+ "type": "string",+ "enum": ["recurring"]+ },+ "cron_expression": {+ "type": "string"+ }+ },+ "required": ["type", "cron_expression"]+ }+ ]+ },+ "next_scheduled_time": {+ "type": "string",+ "nullable": true+ }+ },+ "required": [+ "id",+ "agent_id",+ "message",+ "schedule",+ "next_scheduled_time"+ ]+ }+ },+ "has_next_page": {+ "type": "boolean"+ }+ },+ "required": ["scheduled_messages", "has_next_page"]+ }+ }+ }+ }+ }+ }+ },+ "/v1/agents/{agent_id}/schedule/{scheduled_message_id}": {+ "delete": {+ "description": "Delete a scheduled message by its ID for a specific agent.",+ "summary": "Delete Scheduled Agent Message",+ "tags": ["scheduledMessages"],+ "parameters": [+ {+ "name": "agent_id",+ "in": "path",+ "required": true,+ "schema": {+ "type": "string"+ }+ },+ {+ "name": "scheduled_message_id",+ "in": "path",+ "required": true,+ "schema": {+ "type": "string"+ }+ }+ ],+ "operationId": "scheduledMessages.deleteScheduledMessage",+ "requestBody": {+ "description": "Body",+ "content": {+ "application/json": {+ "schema": {+ "type": "object",+ "properties": {},+ "nullable": true+ }+ }+ }+ },+ "responses": {+ "200": {+ "description": "200",+ "content": {+ "application/json": {+ "schema": {+ "type": "object",+ "properties": {+ "success": {+ "type": "boolean",+ "enum": [true]+ }+ },+ "required": ["success"]+ }+ }+ }+ }+ }+ },+ "get": {+ "description": "Retrieve a scheduled message by its ID for a specific agent.",+ "summary": "Retrieve Scheduled Agent Message",+ "tags": ["scheduledMessages"],+ "parameters": [+ {+ "name": "agent_id",+ "in": "path",+ "required": true,+ "schema": {+ "type": "string"+ }+ },+ {+ "name": "scheduled_message_id",+ "in": "path",+ "required": true,+ "schema": {+ "type": "string"+ }+ }+ ],+ "operationId": "scheduledMessages.retrieveScheduledMessage",+ "responses": {+ "200": {+ "description": "200",+ "content": {+ "application/json": {+ "schema": {+ "type": "object",+ "properties": {+ "id": {+ "type": "string"+ },+ "agent_id": {+ "type": "string"+ },+ "message": {+ "type": "object","properties": {"messages": {"type": "array",@@ -21024,236 +21262,6 @@}}},- "/v1/scheduled-messages": {- "get": {- "description": "List all scheduled messages for a specific agent.",- "summary": "List Scheduled Agent Messages",- "tags": ["scheduledMessages"],- "parameters": [- {- "name": "limit",- "in": "query",- "schema": {- "type": "string"- }- },- {- "name": "agent_id",- "in": "query",- "schema": {- "type": "string"- }- },- {- "name": "project_id",- "in": "query",- "schema": {- "type": "string"- }- },- {- "name": "after",- "in": "query",- "schema": {- "type": "string"- }- }- ],- "operationId": "scheduledMessages.listScheduledMessages",- "responses": {- "200": {- "description": "200",- "content": {- "application/json": {- "schema": {- "type": "object",- "properties": {- "scheduled_messages": {- "type": "array",- "items": {- "type": "object",- "properties": {- "id": {- "type": "string"- },- "agent_id": {- "type": "string"- },- "message": {- "type": "object",- "properties": {- "messages": {- "type": "array",- "items": {- "type": "object",- "properties": {- "content": {- "oneOf": [- {- "type": "array",- "items": {- "oneOf": [- {- "type": "object",- "properties": {- "text": {- "type": "string"- },- "signature": {- "type": "string",- "nullable": true- },- "type": {- "type": "string",- "enum": ["text"]- }- },- "required": ["text"]- },- {- "type": "object",- "properties": {- "source": {- "type": "object",- "properties": {- "data": {- "type": "string"- },- "media_type": {- "type": "string"- },- "detail": {- "type": "string"- },- "type": {- "type": "string",- "enum": ["base64"]- }- },- "required": [- "data",- "media_type"- ]- },- "type": {- "type": "string",- "enum": ["image"]- }- },- "required": ["source", "type"]- }- ]- }- },- {- "type": "string"- }- ]- },- "role": {- "type": "string",- "enum": ["user", "assistant", "system"]- },- "name": {- "type": "string"- },- "otid": {- "type": "string"- },- "sender_id": {- "type": "string"- },- "type": {- "type": "string",- "enum": ["message"]- }- },- "required": ["content", "role"]- }- },- "max_steps": {- "type": "number"- },- "callback_url": {- "type": "string",- "format": "uri"- },- "include_return_message_types": {- "type": "array",- "items": {- "type": "string",- "enum": [- "system_message",- "user_message",- "assistant_message",- "reasoning_message",- "hidden_reasoning_message",- "tool_call_message",- "tool_return_message",- "approval_request_message",- "approval_response_message"- ]- }- }- },- "required": ["messages"]- },- "schedule": {- "oneOf": [- {- "type": "object",- "properties": {- "type": {- "type": "string",- "enum": ["one-time"]- },- "scheduled_at": {- "type": "number"- }- },- "required": ["scheduled_at"]- },- {- "type": "object",- "properties": {- "type": {- "type": "string",- "enum": ["recurring"]- },- "cron_expression": {- "type": "string"- }- },- "required": ["type", "cron_expression"]- }- ]- },- "next_scheduled_time": {- "type": "string",- "nullable": true- }- },- "required": [- "id",- "agent_id",- "message",- "schedule",- "next_scheduled_time"- ]- }- },- "has_next_page": {- "type": "boolean"- }- },- "required": ["scheduled_messages", "has_next_page"]- }- }- }- }- }- }- },"/v1/feeds": {"post": {"description": "Create a new feed in a project",