How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

BlueOcean Spark Platform API

The application backend for BlueOcean's Spark agentic marketing assistant — saved prompts and prompt analytics, "Siren" recurring schedules, session document upload, persistent user memory, conversation history and widget state, and the brokering of a user's third-party MCP server connections through Pipedream Connect. 63 paths, 72 operations. THIS IS NOT A PUBLISHED DEVELOPER API. BlueOcean documents no developer program, no authentication, no pricing and no rate limits. The contract below is FastAPI's auto-generated description of the backend that app.blueocean.ai calls, served publicly and anonymously at https://poseidon.blueocean.ai/api/openapi.json alongside a live Swagger UI. It is profiled here as an observed public artifact, not as an integration surface API Evangelist recommends calling.

This API exposes 73 operations across 63 paths, organized into 13 resource areas, and defines 21 schemas. It is described by OpenAPI 3.1.0, at version 0.1.0.

Requests are made against a single base URL, /api.

73 operations 63 paths 21 schemas 9 DELETE35 GET1 HEAD4 PATCH19 POST5 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
0.1.0
Base URL
https://poseidon.blueocean.ai/api
Resource Areas
13

Paths & Operations 73

Across 63 paths, the API surfaces 73 operations — 9 DELETE, 35 GET, 1 HEAD, 4 PATCH, 19 POST, 5 PUT. They span 13 resource areas, including pinecone_api, langsmith_api, prompts, siren, siren-internal, images, session_documents, mcp, and 5 more. Each is listed below with its method, path, parameters, and response codes.

pinecone_api 1
GET
/pinecone_api/pinecone
Get Pinecone
get_pinecone_pinecone_api_pinecone_get 6 params → 200422
langsmith_api 1
POST
/langsmith_api/feedback
Submit Feedback
submit_feedback_langsmith_api_feedback_post body → 200422
prompts 9
POST
/prompts
Create Prompt
create_prompt_prompts_post body → 200422
GET
/prompts
List Prompts
list_prompts_prompts_get 4 params → 200422
GET
/prompts/analytics/popular
Get Popular Prompts
get_popular_prompts_prompts_analytics_popular_get 5 params → 200422
GET
/prompts/{prompt_id}/analytics
Get Prompt Metrics
get_prompt_metrics_prompts__prompt_id__analytics_get 3 params → 200422
POST
/prompts/{prompt_id}/events
Track Prompt Event
track_prompt_event_prompts__prompt_id__events_post 1 param body → 200422
POST
/prompts/{prompt_id}/clone
Clone Prompt
clone_prompt_prompts__prompt_id__clone_post 3 params → 200422
PUT
/prompts/{prompt_id}
Update Prompt
update_prompt_prompts__prompt_id__put 1 param body → 200422
GET
/prompts/{prompt_id}
Get Prompt
get_prompt_prompts__prompt_id__get 1 param → 200422
DELETE
/prompts/{prompt_id}
Delete Prompt
delete_prompt_prompts__prompt_id__delete 2 params → 200422
siren 7
POST
/siren/schedules
Create Schedule
create_schedule_siren_schedules_post 1 param body → 200422
GET
/siren/schedules
List Schedules
list_schedules_siren_schedules_get 5 params → 200422
GET
/siren/schedules/{schedule_id}
Get Schedule
get_schedule_siren_schedules__schedule_id__get 3 params → 200422
PATCH
/siren/schedules/{schedule_id}
Patch Schedule
patch_schedule_siren_schedules__schedule_id__patch 2 params body → 200422
DELETE
/siren/schedules/{schedule_id}
Delete Schedule
delete_schedule_siren_schedules__schedule_id__delete 3 params → 200422
POST
/siren/schedules/{schedule_id}/run-next
Run Next
run_next_siren_schedules__schedule_id__run_next_post 3 params → 200422
GET
/siren/schedules/{schedule_id}/runs
List Runs
list_runs_siren_schedules__schedule_id__runs_get 5 params → 200422
siren-internal 1
POST
/internal/siren/run-due
Run Due
run_due_internal_siren_run_due_post 1 param body → 200422
images 2
HEAD
/images/{asset_id}
Get Generated Image
get_generated_image_images__asset_id__head 1 param → 200422
GET
/images/{asset_id}
Get Generated Image
get_generated_image_images__asset_id__head 1 param → 200422
session_documents 5
POST
/session-documents/upload
Upload Session Documents
upload_session_documents_session_documents_upload_post 1 param body → 200422
GET
/session-documents
List Session Documents
list_session_documents_session_documents_get 4 params → 200422
GET
/session-documents/sessions/{session_token}
Get Session Documents
get_session_documents_session_documents_sessions__session_token__get 4 params → 200422
GET
/session-documents/{doc_id}/status
Get Session Document Status
get_session_document_status_session_documents__doc_id__status_get 4 params → 200422
DELETE
/session-documents/{doc_id}
Delete Uploaded Session Document
delete_uploaded_session_document_session_documents__doc_id__delete 4 params → 200422
mcp 3
POST
/mcp/oauth/google/start
Oauth Start Google
oauth_start_google_mcp_oauth_google_start_post body → 200422
GET
/mcp/oauth/google/callback
Oauth Callback Google
oauth_callback_google_mcp_oauth_google_callback_get 2 params → 200422
POST
/mcp/connect
Connect Mcp
connect_mcp_mcp_connect_post body → 200422
pipedream 7
GET
/pipedream/mcp_accounts
Get Mcp Accounts
get_mcp_accounts_pipedream_mcp_accounts_get → 200
GET
/pipedream/accounts
List Accounts
list_accounts_pipedream_accounts_get 2 params → 200422
GET
/pipedream/accounts/all
List All Accounts
list_all_accounts_pipedream_accounts_all_get → 200
POST
/pipedream/connect_token
Create Connect Token
create_connect_token_pipedream_connect_token_post 2 params body → 200422
GET
/pipedream/servers
List User Servers
list_user_servers_pipedream_servers_get 2 params → 200422
DELETE
/pipedream/servers/{server_name}/{app_name}
Unregister Mcp Server
unregister_mcp_server_pipedream_servers__server_name___app_name__delete 4 params → 200422
POST
/pipedream/register_mcp
Register Mcp Server
register_mcp_server_pipedream_register_mcp_post 2 params body → 200422
oauth_providers 16
GET
/auth/providers
List Providers
list_providers_auth_providers_get → 200
POST
/auth/providers/{provider}/authorize
Authorize Provider
authorize_provider_auth_providers__provider__authorize_post 1 param body → 200422
GET
/auth/providers/{provider}/callback
Oauth Callback
oauth_callback_auth_providers__provider__callback_get 5 params → 200422
GET
/auth/providers/{provider}/status
Check Oauth Status
check_oauth_status_auth_providers__provider__status_get 2 params → 200422
DELETE
/auth/providers/{provider}/disconnect
Disconnect Provider
disconnect_provider_auth_providers__provider__disconnect_delete 3 params → 200422
GET
/auth/providers/status/all
Get All Provider Status
get_all_provider_status_auth_providers_status_all_get 1 param → 200422
GET
/auth/providers/servers
List Provider Servers
list_provider_servers_auth_providers_servers_get 2 params → 200422
GET
/auth/providers/{provider}/servers/{service}
Get Provider Server
get_provider_server_auth_providers__provider__servers__service__get 3 params → 200422
POST
/auth/providers/{provider}/register
Register Mcp Server
register_mcp_server_auth_providers__provider__register_post 1 param body → 200422
PUT
/auth/providers/{provider}/servers/{service}/disable
Disable Mcp Service
disable_mcp_service_auth_providers__provider__servers__service__disable_put 4 params → 200422
PUT
/auth/providers/{provider}/servers/{service}/enable
Enable Mcp Service
enable_mcp_service_auth_providers__provider__servers__service__enable_put 4 params → 200422
GET
/auth/providers/mcp/servers
List Mcp Servers
list_mcp_servers_auth_providers_mcp_servers_get 1 param → 200422
GET
/auth/providers/mcp/servers/{server_name}
Get Mcp Server
get_mcp_server_auth_providers_mcp_servers__server_name__get 2 params → 200422
DELETE
/auth/providers/mcp/servers/{server_name}
Remove Mcp Server
remove_mcp_server_auth_providers_mcp_servers__server_name__delete 2 params → 200422
POST
/auth/providers/mcp/servers/{server_name}/refresh
Refresh Mcp Server
refresh_mcp_server_auth_providers_mcp_servers__server_name__refresh_post 2 params → 200422
GET
/auth/providers/mcp/stats
Get Mcp Stats
get_mcp_stats_auth_providers_mcp_stats_get 1 param → 200422
mock_mcp 4
POST
/mcp/{provider}/{app}/messages
Mcp Messages Endpoint
mcp_messages_endpoint_mcp__provider___app__messages_post 5 params → 200422
GET
/mcp/{provider}/{app}/tools
List Tools
list_tools_mcp__provider___app__tools_get 3 params → 200422
POST
/mcp/{provider}/{app}/tools/call
Call Tool
call_tool_mcp__provider___app__tools_call_post 3 params body → 200422
GET
/mcp/health
Health Check
health_check_mcp_health_get → 200
user_memory 10
GET
/user_memory
Get User Memory
get_user_memory_user_memory_get 1 param → 200422
POST
/user_memory
Remember User Memory
remember_user_memory_user_memory_post body → 200422
DELETE
/user_memory
Delete User Memory
delete_user_memory_user_memory_delete 1 param body → 200422
GET
/user_memory/saved_items
List Saved Memory Items
list_saved_memory_items_user_memory_saved_items_get 2 params → 200422
POST
/user_memory/forget
Forget User Memory
forget_user_memory_user_memory_forget_post body → 200422
PATCH
/user_memory/profile
Patch Profile
patch_profile_user_memory_profile_patch 1 param body → 200422
PATCH
/user_memory/{kind}/{key}/strength
Patch Memory Strength
patch_memory_strength_user_memory__kind___key__strength_patch 3 params body → 200422
PATCH
/user_memory/{kind}/{key}/disabled
Patch Memory Disabled
patch_memory_disabled_user_memory__kind___key__disabled_patch 3 params body → 200422
DELETE
/user_memory/{kind}/{key}
Delete Memory Entry
delete_memory_entry_user_memory__kind___key__delete 3 params → 200422
GET
/user_memory/admin/by_bucket
Admin Memories By Bucket
admin_memories_by_bucket_user_memory_admin_by_bucket_get 10 params → 200422
Operations 7
GET
/get_message_history
Get Message History
get_message_history_get_message_history_get 1 param → 200422
GET
/get_message_history_v2
Get Normalized Message History
get_normalized_message_history_get_message_history_v2_get 1 param → 200422
GET
/get_all_conversation_history
Get All Conversation History
get_all_conversation_history_get_all_conversation_history_get 2 params → 200422
GET
/get_conversation_history_summary
Get Conversation History Summary
get_conversation_history_summary_get_conversation_history_summary_get 4 params → 200422
PUT
/upsert_widget_data
Update Widget Data
update_widget_data_upsert_widget_data_put body → 200422
DELETE
/delete_conversation
Delete Conversation
delete_conversation_delete_conversation_delete 3 params → 200422
PUT
/rename_conversation
Rename Conversation
rename_conversation_rename_conversation_put 4 params → 200422

Schemas 21

The contract defines 21 schemas that model the data the API accepts and returns. The most detailed are SirenScheduleCreate (19 properties), SirenSchedulePatch (11 properties), Prompt (9 properties), ForgetRequest (6 properties). Each schema is shown below with its type and property counts.

AuthorizeRequest
object
Request to initiate OAuth authorization.
4 properties 1 required
Body_upload_session_documents_session_documents_upload_post
object
4 properties 4 required
ConnectRequest
object
5 properties 5 required
ConnectTokenRequest
object
3 properties 1 required
ForgetRequest
object
Natural-language memory delete payload. phrase is the preferred field; text/memory are accepted as aliases so clients can reuse the same command payload shape…
6 properties
HTTPValidationError
object
1 property
MCPCallToolRequest
object
MCP calltool request format.
2 properties 1 required
MemoryDisablePatch
object
Update payload for enabling/disabling one saved memory entry.
1 property 1 required
OAuthStartRequest
object
4 properties 2 required
ProfilePatch
object
Partial update payload for the stored profile document.
5 properties
Prompt
object
9 properties 7 required
PromptEvent
object
3 properties 3 required
RegisterMCPRequest
object
Request to register MCP server for a provider.
4 properties 2 required
RememberRequest
object
Natural-language memory write payload. memory matches the current UI client. text matches the explicit API handoff. Supporting both lets frontend and backend m…
4 properties 1 required
ServerConfig
object
4 properties 2 required
SirenRunDueRequest
object
1 property
SirenScheduleCreate
object
Create a Siren schedule, either for an existing library prompt (promptId) or by upgrading inline prompt text into the library first (promptText).
19 properties 2 required
SirenSchedulePatch
object
Partial update of schedule fields. Omitted fields are left untouched; consumers must use modeldump(excludeunset=True).
11 properties 2 required
StrengthPatch
object
Update payload for collection-memory strength.
1 property 1 required
ValidationError
object
3 properties 3 required
WidgetDataUpdate
object
4 properties 4 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

blueocean-spark-platform-openapi.json Raw ↑
Where this information came from

This is an independent, third-party profile of BlueOcean Spark Platform API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.