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

Terminal Use Messages v2 API

The Messages v2 API from Terminal Use — 2 operation(s) for messages v2.

Terminal Use Messages v2 API is one of 28 APIs that Terminal Use publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Messages v2. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

This API exposes 2 operations across 2 paths, and defines 16 schemas. It is described by OpenAPI 3.1.0, at version 0.1.0.

Requests are made against the base URL https://api.terminaluse.com.

2 operations 2 paths 16 schemas 2 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
0.1.0
Base URL
https://api.terminaluse.com
Resource Areas
1

Paths & Operations 2

Across 2 paths, the API surfaces 2 operations — 2 GET. Each is listed below with its method, path, parameters, and response codes.

Messages v2 2
GET
/v2/messages
List Messages (v2 - UIMessage format)
messages_v2_list 5 params → 200422
GET
/v2/messages/{message_id}
Get Message (v2 - UIMessage format)
messages_v2_retrieve 2 params → 200422

Schemas 16

The contract defines 16 schemas that model the data the API accepts and returns. The most detailed are ToolPart (7 properties), UIMessageMetadata (5 properties), UIMessage (5 properties), SourceUrlPart (4 properties). Each schema is shown below with its type and property counts.

ToolPart
object
Tool invocation and result part.
7 properties 4 required
ListMessagesV2Response
object
Response for list messages v2 endpoint.
3 properties 1 required
HTTPValidationError
object
1 property
ValidationError
object
3 properties 3 required
Usage
object
Token usage statistics.
3 properties 2 required
TextPart
object
Text content part.
2 properties 1 required
SourceUrlPart
object
Source URL reference part.
4 properties 2 required
DataPart
object
Generic data part for unknown/passthrough content.
2 properties 1 required
UIMessageRole
string
Role of the message author.
ErrorPart
object
Error part for transformation failures.
3 properties 1 required
UIMessagePartWrapper
Wrapper for UIMessagePart union for proper serialization.
UIMessageMetadata
object
Metadata for a UIMessage.
5 properties
ReasoningPart
object
Reasoning/thinking content part (Claude's extended thinking).
3 properties 1 required
ToolPartState
string
State of a tool part.
FilePart
object
File attachment part.
3 properties 2 required
UIMessage
object
Vercel AI SDK compatible message format. Based on: https://ai-sdk.dev/docs/reference/ai-sdk-core/ui-message with extensions for our use case.
5 properties 3 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

terminal-use-messages-v2-api-openapi.yml Raw ↑

Other APIs Terminal Use publishes across the network.

Terminal Use Agent APIKeys API
Terminal Use Agent Task Tracker API
Terminal Use Agents API
Terminal Use API Keys API
Terminal Use Authentication API
Terminal Use Branch Events API
Terminal Use Branches API
Terminal Use Builds API
Terminal Use CLI Authentication API
Terminal Use Environments API
Terminal Use Events API
Terminal Use Filesystems API