Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

nexos.ai Messages API

Anthropic-native Messages API for prompt-cache-preserving passthrough.

nexos.ai Messages API is one of 16 APIs that nexos.ai publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Messages. The published artifact set on APIs.io includes an OpenAPI specification.

This API exposes 1 operation across 1 path, and defines 57 schemas. It is described by OpenAPI 3.0.0, at version 1.0.0.

Requests are made against a single base URL, https://api.nexos.ai.

1 operations 1 paths 57 schemas 1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.0
API Version
1.0.0
Base URL
https://api.nexos.ai
Authentication
HTTP Bearer, API Key
Resource Areas
1

Authentication & Security 2

nexos.ai Messages API declares 2 security schemes for authenticating requests. It accepts HTTP bearer tokens (bearerAuth). An API key is passed in the header as X-Api-Key (apiKeyHeader). By default, every request must be authenticated.

  • apiKeyHeader — Authenticate by sending your nexos API key in the X-Api-Key header (e.g. X-Api-Key: nexos-... for a user key or X-Api-Key: nexos-team-... for a team key). This…

Paths & Operations 1

Across 1 path, the API surfaces 1 operation — 1 POST. Each is listed below with its method, path, parameters, and response codes.

Messages 1

Anthropic-native Messages API for prompt-cache-preserving passthrough.

POST
/v1/messages
Create a message (Anthropic-native)
createMessage body → 200

Schemas 57

The contract defines 57 schemas that model the data the API accepts and returns. The most detailed are CreateMessageRequest (16 properties), MessagesResponse (9 properties), Usage (8 properties), SearchResultBlock (6 properties). Each schema is shown below with its type and property counts.

ContentBlockStartEvent
object
3 properties 3 required
ServerToolUsage
object
Usage counts for each server-side tool, present when those tools ran during the request.
1 property
CitationsDelta
object
2 properties 2 required
CitationsConfig
object
1 property 1 required
Tool
Tool definition. Either a custom tool (function with inputschema) or a built-in server tool (typed by versioned type).
ThinkingDelta
object
2 properties 2 required
MessageDelta
object
Top-level message delta carrying terminal stopreason / stopsequence.
2 properties
InputJsonDelta
object
2 properties 2 required
EnabledThinkingConfig
object
2 properties 2 required
ToolChoiceTool
object
3 properties 2 required
ImageSourceBase64
object
3 properties 3 required
ServerTool
object
A provider-hosted built-in tool, identified by its versioned type (for example websearch20250305, codeexecution20250825, bash20250124, texteditor20250124, or m…
3 properties 2 required
ImageSourceURL
object
2 properties 2 required
DisabledThinkingConfig
object
1 property 1 required
ContentBlockDelta
ToolChoice
Controls how the model selects tools.
InputMessage
object
A single input message in the messages array.
2 properties 2 required
ToolUseBlock
object
5 properties 4 required
MessagesResponse
object
Anthropic-native non-streaming Messages API response.
9 properties 6 required
ContentBlockStopEvent
object
2 properties 2 required
CacheControlEphemeral
object
Marks a caching breakpoint for prompt caching. Attach it to any cacheable element — system text blocks, message content blocks, tool definitions, tooluse, tool…
2 properties 1 required
ToolChoiceAny
object
2 properties 1 required
DocumentSourceText
object
3 properties 3 required
DocumentSource
MessagesStreamEvent
Anthropic-native Messages API SSE event. Discriminated by type. Forwarded byte-for-byte from the upstream provider — public-api does not transform individual e…
ImageBlock
object
3 properties 2 required
DocumentSourceURL
object
2 properties 2 required
CacheCreation
object
Breakdown of cache-write tokens split by cache lifetime tier.
2 properties
SearchResultBlock
object
6 properties 2 required
Metadata
object
Optional request metadata passed through to the provider. The userid field helps the provider associate the request with an end user.
1 property
ImageSource
ContentBlockDeltaEvent
object
3 properties 3 required
SystemBlock
object
A system prompt content block. Supports cachecontrol for caching the system prefix.
3 properties 2 required
CustomTool
object
A function tool that the client defines and implements.
5 properties 2 required
Container
object
Details of the execution container, included when the request used server-side code execution.
2 properties 2 required
Usage
object
Token counts reported for the request.
8 properties 2 required
RedactedThinkingBlock
object
2 properties 2 required
ToolChoiceNone
object
1 property 1 required
DocumentBlock
object
6 properties 2 required
WebSearchToolResultBlock
object
4 properties 3 required
MessageStartEvent
object
2 properties 2 required
ThinkingBlock
object
4 properties 3 required
SignatureDelta
object
2 properties 2 required
CreateMessageRequest
object
Anthropic-native Messages API request body. Forwarded byte-for-byte to the upstream provider — cachecontrol markers are preserved exactly where the client plac…
16 properties 3 required
ToolChoiceAuto
object
2 properties 1 required
ContentBlock
A content block within a message's content array. Discriminator is type. Strict-typed concrete subtypes cover the full Anthropic Messages API surface; cachecon…
DocumentSourceBase64
object
3 properties 3 required
TextBlock
object
4 properties 2 required
ErrorEvent
object
2 properties 2 required
ToolResultBlock
object
5 properties 2 required
ServerToolUseBlock
object
A built-in tool call (such as websearch or codeexecution) that the provider runs on its own side.
5 properties 4 required
MessageStopEvent
object
1 property 1 required
PingEvent
object
1 property 1 required
ThinkingConfig
Extended thinking configuration.
DocumentSourceContent
object
2 properties 2 required
TextDelta
object
2 properties 2 required
MessageDeltaEvent
object
3 properties 3 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

nexosai-messages-api-openapi.yml Raw ↑

Other APIs nexos.ai publishes across the network.

nexos.ai Agent Management API
nexos.ai Assistant Management API
nexos.ai Audio API
nexos.ai Batches API
nexos.ai Budget Limit Management API
nexos.ai Chat API
nexos.ai Company Management API
nexos.ai Embeddings API
nexos.ai Files API
nexos.ai Images API
nexos.ai Models API
nexos.ai Responses API