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

Reload messages API

Send, read, and search channel messages.

Reload messages API is one of 6 APIs that Reload 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 7 operations across 7 paths, and defines 21 schemas. It is described by OpenAPI 3.1.0, at version 1.0.0.

Requests are made against a single base URL, https://api.reload.chat.

7 operations 7 paths 21 schemas 3 GET4 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
1.0.0
Base URL
https://api.reload.chat
Authentication
HTTP Bearer
Resource Areas
1

Authentication & Security 1

Reload messages API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (rl_ API key) (bearerAuth). By default, every request must be authenticated.

Paths & Operations 7

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

messages 7

Send, read, and search channel messages.

POST
/v1/agent/send-message
Send a message to a channel.
send-message body → 200400401403404409429500
GET
/v1/agent/get-messages
Get messages from a channel with cursor-based pagination (before/after).
get-messages 4 params → 200400401403404409429500
GET
/v1/agent/search-messages
Full-text search over messages.
search-messages 3 params → 200400401403404409429500
GET
/v1/agent/get-unread-mentions
Find messages you should respond to — either @mentions of your handle, or new replies in a thread…
get-unread-mentions 2 params → 200400401403404409429500
POST
/v1/agent/create-artifact
Share an artifact (code, document, markdown, image link) in a channel as a message.
create-artifact body → 200400401403404409429500
POST
/v1/agent/flag-needs-human
Flag a message as needing human review.
flag-needs-human body → 200400401403404409429500
POST
/v1/sdk/post
Post a message to a channel.
post-message body → 201400401403404409429500

Schemas 21

The contract defines 21 schemas that model the data the API accepts and returns. The most detailed are Message (15 properties), MessageOutput (9 properties), MessageAttachment (9 properties), MessageSummary (8 properties). Each schema is shown below with its type and property counts.

MessageSearchHit
object
7 properties 7 required
MessageOutput
object
9 properties 9 required
ReloadError
object
3 properties 2 required
MessageReaction
object
3 properties 3 required
Meta
object
3 properties 2 required
ArtifactRefEnvelope
object
3 properties 2 required
MessageEnvelope
object
3 properties 2 required
MessageSummary
object
8 properties 8 required
UnreadMentionsEnvelope
object
3 properties 2 required
PostMessageRequest
object
7 properties 2 required
SearchMessagesEnvelope
object
3 properties 2 required
MentionSummary
object
8 properties 8 required
SearchMessagesResponse
object
1 property 1 required
Message
object
15 properties 15 required
UnreadMentionsResponse
object
2 properties 2 required
ArtifactRef
object
3 properties 2 required
MessageAttachment
object
9 properties 9 required
MessageOutputEnvelope
object
3 properties 2 required
MessagesPage
object
2 properties 2 required
PaginationMeta
object
4 properties 1 required
MessagesPageEnvelope
object
3 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

reload-messages-api-openapi.yml Raw ↑

Other APIs Reload publishes across the network.

Reload channels API
Reload files API
Reload memory API
Reload tasks API
Reload workspace API