Languages: every operation supports cURL, Node.js (TypeScript), Python, Go, Ruby, and PHP. The first 15 operations on this page show all six languages; the remaining 19 show cURL and TypeScript — the two most-used.

TeamChat API

TeamChat endpoints exposed by the Devotel CPaaS API Base path: /api/v1/team-chat Endpoint count: 34

title: “TeamChat orientation: worked channel + message round-trip” description: “Create an internal channel, post a message with @-mentions, read the history back with sender identity hydrated, and react to a message — with the full response bodies to copy.”

The channel and message resources

TeamChat is internal, workspace-to-workspace messaging: a channel is one thread of conversation scoped to your organization, and a message is one post inside it. A channel carries its id, name, and (optional) description; each message carries a body plus two fields your own integrations write — mentions (resolved user ids) and attachments. Membership is the authorization boundary: you must be a member of a channel to read its history or post to it, and only owner/admin roles manage members. When you create a channel, you join it automatically as owner. Every response on this page follows the same { data, meta } envelope — a data payload plus a meta block carrying request_id and timestamp — so the examples below hold for every endpoint here. Errors follow Devotel Orbit’s { error, meta } envelope, shown once under Error envelope.

Worked sequence: create, post, read back

The run-through every integration does first: create the channel, post a message that mentions a teammate, then read the history back with sender identity hydrated.

1. Create the channel

POST /api/v1/team-chat/channels

Only name is required (1–120 characters). description is optional (up to 500 characters). The caller is inserted as the channel’s owner member. Request

cURL

curl -X POST "https://api.orbit.devotel.io/api/v1/team-chat/channels" \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "launch-war-room",
  "description": "Coordination channel for the fall product launch"
}'

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/team-chat/channels', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
  "name": "launch-war-room",
  "description": "Coordination channel for the fall product launch"
}),
})
console.log(await res.json())

Python

import os, requests

headers = {"X-API-Key": os.environ["ORBIT_API_KEY"]}
headers["Content-Type"] = "application/json"
r = requests.post("https://api.orbit.devotel.io/api/v1/team-chat/channels", headers=headers, json={
  "name": "launch-war-room",
  "description": "Coordination channel for the fall product launch"
})
print(r.json())

package main

import (
	"bytes"
	"net/http"
	"os"
)

func main() {
	req, _ := http.NewRequest("POST", "https://api.orbit.devotel.io/api/v1/team-chat/channels", bytes.NewBuffer([]byte(`{
  "name": "launch-war-room",
  "description": "Coordination channel for the fall product launch"
}`)))
	req.Header.Set("X-API-Key", os.Getenv("ORBIT_API_KEY"))
	req.Header.Set("Content-Type", "application/json")
	http.DefaultClient.Do(req)
}

Ruby

require 'net/http'
require 'json'

uri = URI('https://api.orbit.devotel.io/api/v1/team-chat/channels')
req = Net::HTTP::Post.new(uri)
req['X-API-Key'] = ENV['ORBIT_API_KEY']
req['Content-Type'] = 'application/json'
req.body = {
  "name": "launch-war-room",
  "description": "Coordination channel for the fall product launch"
}.to_json
res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |h| h.request(req) }
puts res.body

PHP

<?php
$ch = curl_init('https://api.orbit.devotel.io/api/v1/team-chat/channels');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  'X-API-Key: ' . getenv('ORBIT_API_KEY'),
  'Content-Type: application/json',
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, <<<JSON
{
  "name": "launch-war-room",
  "description": "Coordination channel for the fall product launch"
}
JSON);
echo curl_exec($ch);

{
  "data": {
    "id": "9f2c1b7a-4d3e-4b8f-9a1c-2e7d5f8b0a41",
    "name": "launch-war-room",
    "description": "Coordination channel for the fall product launch",
    "created_by_user_id": "user_2abc3def4ghi5jkl6mnopqr",
    "created_at": "2026-08-28T09:15:00.000Z",
    "updated_at": "2026-08-28T09:15:00.000Z",
    "my_role": "owner"
  },
  "meta": {
    "request_id": "req_create_channel",
    "timestamp": "2026-08-28T09:15:00.000Z"
  }
}

The response carries my_role: "owner" as a convenience — the channels list endpoint returns the same field on every row you are a member of.

2. Post a message with @-mentions

POST /api/v1/team-chat/channels/{channelId}/messages

A message needs a body or at least one attachment — an empty post is rejected with 422. body accepts plain text or Slack-style markdown (**bold**, _italic_, ~strike~, back-tick code blocks, and lists) and is capped at 8000 characters. mentions is an array of resolved user ids — write @name in the body text for the reader and pass the same person’s user id in mentions so the notification fan-out knows whom to ping without re-parsing your text. Request

cURL

curl -X POST "https://api.orbit.devotel.io/api/v1/team-chat/channels/{channelId}/messages" \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
  "body": "Supplier contract draft is in the shared drive. @Ada Lovelace please review the liability clause before Friday.",
  "mentions": [
    "user_2xyz7wvu8tsr9qpo1nmlkjih"
  ]
}'

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/team-chat/channels/{channelId}/messages', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
  "body": "Supplier contract draft is in the shared drive. @Ada Lovelace please review the liability clause before Friday.",
  "mentions": [
    "user_2xyz7wvu8tsr9qpo1nmlkjih"
  ]
}),
})
console.log(await res.json())

Python

import os, requests

headers = {"X-API-Key": os.environ["ORBIT_API_KEY"]}
headers["Content-Type"] = "application/json"
r = requests.post("https://api.orbit.devotel.io/api/v1/team-chat/channels/{channelId}/messages", headers=headers, json={
  "body": "Supplier contract draft is in the shared drive. @Ada Lovelace please review the liability clause before Friday.",
  "mentions": [
    "user_2xyz7wvu8tsr9qpo1nmlkjih"
  ]
})
print(r.json())

package main

import (
	"bytes"
	"net/http"
	"os"
)

func main() {
	req, _ := http.NewRequest("POST", "https://api.orbit.devotel.io/api/v1/team-chat/channels/{channelId}/messages", bytes.NewBuffer([]byte(`{
  "body": "Supplier contract draft is in the shared drive. @Ada Lovelace please review the liability clause before Friday.",
  "mentions": [
    "user_2xyz7wvu8tsr9qpo1nmlkjih"
  ]
}`)))
	req.Header.Set("X-API-Key", os.Getenv("ORBIT_API_KEY"))
	req.Header.Set("Content-Type", "application/json")
	http.DefaultClient.Do(req)
}

Ruby

require 'net/http'
require 'json'

uri = URI('https://api.orbit.devotel.io/api/v1/team-chat/channels/{channelId}/messages')
req = Net::HTTP::Post.new(uri)
req['X-API-Key'] = ENV['ORBIT_API_KEY']
req['Content-Type'] = 'application/json'
req.body = {
  "body": "Supplier contract draft is in the shared drive. @Ada Lovelace please review the liability clause before Friday.",
  "mentions": [
    "user_2xyz7wvu8tsr9qpo1nmlkjih"
  ]
}.to_json
res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |h| h.request(req) }
puts res.body

PHP

<?php
$ch = curl_init('https://api.orbit.devotel.io/api/v1/team-chat/channels/{channelId}/messages');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  'X-API-Key: ' . getenv('ORBIT_API_KEY'),
  'Content-Type: application/json',
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, <<<JSON
{
  "body": "Supplier contract draft is in the shared drive. @Ada Lovelace please review the liability clause before Friday.",
  "mentions": [
    "user_2xyz7wvu8tsr9qpo1nmlkjih"
  ]
}
JSON);
echo curl_exec($ch);

{
  "data": {
    "id": "3a4b5c6d-7e8f-4a2f-8b3d-1c4e5f6a7b8c",
    "channel_id": "9f2c1b7a-4d3e-4b8f-9a1c-2e7d5f8b0a41",
    "sender_user_id": "user_2abc3def4ghi5jkl6mnopqr",
    "body": "Supplier contract draft is in the shared drive. @Ada Lovelace please review the liability clause before Friday.",
    "mentions": ["user_2xyz7wvu8tsr9qpo1nmlkjih"],
    "attachments": [],
    "created_at": "2026-08-28T09:16:30.000Z",
    "edited_at": null
  },
  "meta": {
    "request_id": "req_post_message",
    "timestamp": "2026-08-28T09:16:30.000Z"
  }
}

edited_at is null until somebody edits the message. Posting a message also pushes a realtime refresh hint to every open dashboard and creates a persistent notification for each other channel member, so an empty client poll is never required to learn about a new post.

3. Read the channel history back

GET /api/v1/team-chat/channels/{channelId}/messages

Returns thread roots (top-level posts) newest-first, bounded by the limit query parameter — default 50, maximum 200. Replies live inside their parent’s thread so a busy thread never floods the channel feed; each root carries reply_count and last_reply_at when it has replies. The GET hydrates each row with the sender’s human-readable identity from your user directory — sender_name and sender_avatar_url — so a UI renders a person, not the internal sender_user_id. When the sender row was deleted (or was a system sender) both fields come back null and the id stays.

curl -X GET "https://api.orbit.devotel.io/api/v1/team-chat/channels/9f2c1b7a-4d3e-4b8f-9a1c-2e7d5f8b0a41/messages?limit=50" \
  -H "X-API-Key: dv_live_sk_your_key_here"

{
  "data": [
    {
      "id": "3a4b5c6d-7e8f-4a2f-8b3d-1c4e5f6a7b8c",
      "channel_id": "9f2c1b7a-4d3e-4b8f-9a1c-2e7d5f8b0a41",
      "sender_user_id": "user_2abc3def4ghi5jkl6mnopqr",
      "body": "Supplier contract draft is in the shared drive. @Ada Lovelace please review the liability clause before Friday.",
      "mentions": ["user_2xyz7wvu8tsr9qpo1nmlkjih"],
      "attachments": [],
      "created_at": "2026-08-28T09:16:30.000Z",
      "edited_at": null,
      "reply_count": 0,
      "last_reply_at": null,
      "sender_name": "Grace Hopper",
      "sender_avatar_url": "https://avatar.example.com/grace.png"
    }
  ],
  "meta": {
    "request_id": "req_list_messages",
    "timestamp": "2026-08-28T09:17:00.000Z"
  }
}

4. React to a message

POST /api/v1/team-chat/channels/{channelId}/messages/{messageId}/reactions

One reaction per user per emoji — repeating the POST with the same emoji is a no-op. The reaction feeds the per-message summary your UI polls with GET …/messages/reactions?message_ids=…. Request

cURL

curl -X POST "https://api.orbit.devotel.io/api/v1/team-chat/channels/{channelId}/messages/{messageId}/reactions" \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
  "emoji": "🎉"
}'

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/team-chat/channels/{channelId}/messages/{messageId}/reactions', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
  "emoji": "🎉"
}),
})
console.log(await res.json())

Python

import os, requests

headers = {"X-API-Key": os.environ["ORBIT_API_KEY"]}
headers["Content-Type"] = "application/json"
r = requests.post("https://api.orbit.devotel.io/api/v1/team-chat/channels/{channelId}/messages/{messageId}/reactions", headers=headers, json={
  "emoji": "🎉"
})
print(r.json())

package main

import (
	"bytes"
	"net/http"
	"os"
)

func main() {
	req, _ := http.NewRequest("POST", "https://api.orbit.devotel.io/api/v1/team-chat/channels/{channelId}/messages/{messageId}/reactions", bytes.NewBuffer([]byte(`{
  "emoji": "🎉"
}`)))
	req.Header.Set("X-API-Key", os.Getenv("ORBIT_API_KEY"))
	req.Header.Set("Content-Type", "application/json")
	http.DefaultClient.Do(req)
}

Ruby

require 'net/http'
require 'json'

uri = URI('https://api.orbit.devotel.io/api/v1/team-chat/channels/{channelId}/messages/{messageId}/reactions')
req = Net::HTTP::Post.new(uri)
req['X-API-Key'] = ENV['ORBIT_API_KEY']
req['Content-Type'] = 'application/json'
req.body = {
  "emoji": "🎉"
}.to_json
res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |h| h.request(req) }
puts res.body

PHP

<?php
$ch = curl_init('https://api.orbit.devotel.io/api/v1/team-chat/channels/{channelId}/messages/{messageId}/reactions');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  'X-API-Key: ' . getenv('ORBIT_API_KEY'),
  'Content-Type: application/json',
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, <<<JSON
{
  "emoji": "🎉"
}
JSON);
echo curl_exec($ch);

{
  "data": {
    "emoji": "🎉",
    "message_id": "3a4b5c6d-7e8f-4a2f-8b3d-1c4e5f6a7b8c"
  },
  "meta": {
    "request_id": "req_add_reaction",
    "timestamp": "2026-08-28T09:17:20.000Z"
  }
}

Error envelope

Schema failures return 422 with a VALIDATION_ERROR code and the offending fields listed under details. The classic case is an empty message — no body, no attachments:

422

{
  "error": {
    "code": "VALIDATION_ERROR",
    "status": 422,
    "message": "Invalid message body"
  },
  "meta": {
    "request_id": "req_...",
    "timestamp": "2026-08-28T09:16:30.000Z"
  }
}

Reading or posting to a channel you do not belong to returns 403 NOT_A_MEMBER — handle it before you code a retry loop. On the creation path a 500 means the insert itself failed; channel names and descriptions are server-scrubbed only for length, so a narrower client-side validation never shadows a server accept.

List internal team channels the caller is a member of

GET /api/v1/team-chat/channels

string (enum: true|false)

Sandbox opt-in for Clerk-session-authenticated requests. Set to true to route the call through the test-mode pipeline: no real provider delivery, no credits deducted, response meta.test_mode: true. Ignored for live API keys (dv_live_sk_*) — server-to-server clients must use a test-prefixed key (dv_test_sk_*) to exercise sandbox. Test-prefixed keys unconditionally enable sandbox regardless of this header.

cURL

curl -X GET "https://api.orbit.devotel.io/api/v1/team-chat/channels" \
  -H "X-API-Key: dv_live_sk_your_key_here" 

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/team-chat/channels', {
  method: 'GET',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
  },
})
console.log(await res.json())

Python

import os, requests

headers = {"X-API-Key": os.environ["ORBIT_API_KEY"]}
r = requests.get("https://api.orbit.devotel.io/api/v1/team-chat/channels", headers=headers)
print(r.json())

package main

import (
	"bytes"
	"net/http"
	"os"
)

func main() {
	req, _ := http.NewRequest("GET", "https://api.orbit.devotel.io/api/v1/team-chat/channels", nil)
	req.Header.Set("X-API-Key", os.Getenv("ORBIT_API_KEY"))

	http.DefaultClient.Do(req)
}

Ruby

require 'net/http'
require 'json'

uri = URI('https://api.orbit.devotel.io/api/v1/team-chat/channels')
req = Net::HTTP::Get.new(uri)
req['X-API-Key'] = ENV['ORBIT_API_KEY']


res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |h| h.request(req) }
puts res.body

PHP

<?php
$ch = curl_init('https://api.orbit.devotel.io/api/v1/team-chat/channels');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  'X-API-Key: ' . getenv('ORBIT_API_KEY'),

]);

echo curl_exec($ch);

{
  "data": [
    {
      "id": "3a4b5c6d-7e8f-4a2f-8b3d-1c4e5f6a7b8c",
      "channel_id": "9f2c1b7a-4d3e-4b8f-9a1c-2e7d5f8b0a41",
      "sender_user_id": "user_2abc3def4ghi5jkl6mnopqr",
      "body": "Supplier contract draft is in the shared drive. @Ada Lovelace please review the liability clause before Friday.",
      "mentions": ["user_2xyz7wvu8tsr9qpo1nmlkjih"],
      "attachments": [],
      "created_at": "2026-08-28T09:16:30.000Z",
      "edited_at": null,
      "reply_count": 0,
      "last_reply_at": null,
      "sender_name": "Grace Hopper",
      "sender_avatar_url": "https://avatar.example.com/grace.png"
    }
  ],
  "meta": {
    "request_id": "req_list_messages",
    "timestamp": "2026-08-28T09:17:00.000Z"
  }
}

Get the active huddle (if any) for a channel

GET /api/v1/team-chat/channels/{channelId}/huddle

string

required

—

string (enum: true|false)

cURL

curl -X GET "https://api.orbit.devotel.io/api/v1/team-chat/channels/{channelId}/huddle" \
  -H "X-API-Key: dv_live_sk_your_key_here" 

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/team-chat/channels/{channelId}/huddle', {
  method: 'GET',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
  },
})
console.log(await res.json())

Python

import os, requests

headers = {"X-API-Key": os.environ["ORBIT_API_KEY"]}
r = requests.get("https://api.orbit.devotel.io/api/v1/team-chat/channels/{channelId}/huddle", headers=headers)
print(r.json())

package main

import (
	"bytes"
	"net/http"
	"os"
)

func main() {
	req, _ := http.NewRequest("GET", "https://api.orbit.devotel.io/api/v1/team-chat/channels/{channelId}/huddle", nil)
	req.Header.Set("X-API-Key", os.Getenv("ORBIT_API_KEY"))

	http.DefaultClient.Do(req)
}

Ruby

require 'net/http'
require 'json'

uri = URI('https://api.orbit.devotel.io/api/v1/team-chat/channels/{channelId}/huddle')
req = Net::HTTP::Get.new(uri)
req['X-API-Key'] = ENV['ORBIT_API_KEY']


res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |h| h.request(req) }
puts res.body

PHP

<?php
$ch = curl_init('https://api.orbit.devotel.io/api/v1/team-chat/channels/{channelId}/huddle');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  'X-API-Key: ' . getenv('ORBIT_API_KEY'),

]);

echo curl_exec($ch);

{
  "data": [
    {
      "id": "3a4b5c6d-7e8f-4a2f-8b3d-1c4e5f6a7b8c",
      "channel_id": "9f2c1b7a-4d3e-4b8f-9a1c-2e7d5f8b0a41",
      "sender_user_id": "user_2abc3def4ghi5jkl6mnopqr",
      "body": "Supplier contract draft is in the shared drive. @Ada Lovelace please review the liability clause before Friday.",
      "mentions": ["user_2xyz7wvu8tsr9qpo1nmlkjih"],
      "attachments": [],
      "created_at": "2026-08-28T09:16:30.000Z",
      "edited_at": null,
      "reply_count": 0,
      "last_reply_at": null,
      "sender_name": "Grace Hopper",
      "sender_avatar_url": "https://avatar.example.com/grace.png"
    }
  ],
  "meta": {
    "request_id": "req_list_messages",
    "timestamp": "2026-08-28T09:17:00.000Z"
  }
}

List members of a channel

GET /api/v1/team-chat/channels/{channelId}/members

string

required

—

string (enum: true|false)

cURL

curl -X GET "https://api.orbit.devotel.io/api/v1/team-chat/channels/{channelId}/members" \
  -H "X-API-Key: dv_live_sk_your_key_here" 

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/team-chat/channels/{channelId}/members', {
  method: 'GET',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
  },
})
console.log(await res.json())

Python

import os, requests

headers = {"X-API-Key": os.environ["ORBIT_API_KEY"]}
r = requests.get("https://api.orbit.devotel.io/api/v1/team-chat/channels/{channelId}/members", headers=headers)
print(r.json())

package main

import (
	"bytes"
	"net/http"
	"os"
)

func main() {
	req, _ := http.NewRequest("GET", "https://api.orbit.devotel.io/api/v1/team-chat/channels/{channelId}/members", nil)
	req.Header.Set("X-API-Key", os.Getenv("ORBIT_API_KEY"))

	http.DefaultClient.Do(req)
}

Ruby

require 'net/http'
require 'json'

uri = URI('https://api.orbit.devotel.io/api/v1/team-chat/channels/{channelId}/members')
req = Net::HTTP::Get.new(uri)
req['X-API-Key'] = ENV['ORBIT_API_KEY']


res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |h| h.request(req) }
puts res.body

PHP

<?php
$ch = curl_init('https://api.orbit.devotel.io/api/v1/team-chat/channels/{channelId}/members');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  'X-API-Key: ' . getenv('ORBIT_API_KEY'),

]);

echo curl_exec($ch);

{
  "data": [
    {
      "id": "3a4b5c6d-7e8f-4a2f-8b3d-1c4e5f6a7b8c",
      "channel_id": "9f2c1b7a-4d3e-4b8f-9a1c-2e7d5f8b0a41",
      "sender_user_id": "user_2abc3def4ghi5jkl6mnopqr",
      "body": "Supplier contract draft is in the shared drive. @Ada Lovelace please review the liability clause before Friday.",
      "mentions": ["user_2xyz7wvu8tsr9qpo1nmlkjih"],
      "attachments": [],
      "created_at": "2026-08-28T09:16:30.000Z",
      "edited_at": null,
      "reply_count": 0,
      "last_reply_at": null,
      "sender_name": "Grace Hopper",
      "sender_avatar_url": "https://avatar.example.com/grace.png"
    }
  ],
  "meta": {
    "request_id": "req_list_messages",
    "timestamp": "2026-08-28T09:17:00.000Z"
  }
}

List channel messages, newest-first

GET /api/v1/team-chat/channels/{channelId}/messages

string

required

—

string (enum: true|false)

cURL

curl -X GET "https://api.orbit.devotel.io/api/v1/team-chat/channels/{channelId}/messages" \
  -H "X-API-Key: dv_live_sk_your_key_here" 

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/team-chat/channels/{channelId}/messages', {
  method: 'GET',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
  },
})
console.log(await res.json())

Python

import os, requests

headers = {"X-API-Key": os.environ["ORBIT_API_KEY"]}
r = requests.get("https://api.orbit.devotel.io/api/v1/team-chat/channels/{channelId}/messages", headers=headers)
print(r.json())

package main

import (
	"bytes"
	"net/http"
	"os"
)

func main() {
	req, _ := http.NewRequest("GET", "https://api.orbit.devotel.io/api/v1/team-chat/channels/{channelId}/messages", nil)
	req.Header.Set("X-API-Key", os.Getenv("ORBIT_API_KEY"))

	http.DefaultClient.Do(req)
}

Ruby

require 'net/http'
require 'json'

uri = URI('https://api.orbit.devotel.io/api/v1/team-chat/channels/{channelId}/messages')
req = Net::HTTP::Get.new(uri)
req['X-API-Key'] = ENV['ORBIT_API_KEY']


res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |h| h.request(req) }
puts res.body

PHP

<?php
$ch = curl_init('https://api.orbit.devotel.io/api/v1/team-chat/channels/{channelId}/messages');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  'X-API-Key: ' . getenv('ORBIT_API_KEY'),

]);

echo curl_exec($ch);

{
  "data": [
    {
      "id": "3a4b5c6d-7e8f-4a2f-8b3d-1c4e5f6a7b8c",
      "channel_id": "9f2c1b7a-4d3e-4b8f-9a1c-2e7d5f8b0a41",
      "sender_user_id": "user_2abc3def4ghi5jkl6mnopqr",
      "body": "Supplier contract draft is in the shared drive. @Ada Lovelace please review the liability clause before Friday.",
      "mentions": ["user_2xyz7wvu8tsr9qpo1nmlkjih"],
      "attachments": [],
      "created_at": "2026-08-28T09:16:30.000Z",
      "edited_at": null,
      "reply_count": 0,
      "last_reply_at": null,
      "sender_name": "Grace Hopper",
      "sender_avatar_url": "https://avatar.example.com/grace.png"
    }
  ],
  "meta": {
    "request_id": "req_list_messages",
    "timestamp": "2026-08-28T09:17:00.000Z"
  }
}

Load a channel message thread (root + replies)

GET /api/v1/team-chat/channels/{channelId}/messages/{messageId}/thread

string

required

—

string

required

—

string (enum: true|false)

cURL

curl -X GET "https://api.orbit.devotel.io/api/v1/team-chat/channels/{channelId}/messages/{messageId}/thread" \
  -H "X-API-Key: dv_live_sk_your_key_here" 

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/team-chat/channels/{channelId}/messages/{messageId}/thread', {
  method: 'GET',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
  },
})
console.log(await res.json())

Python

import os, requests

headers = {"X-API-Key": os.environ["ORBIT_API_KEY"]}
r = requests.get("https://api.orbit.devotel.io/api/v1/team-chat/channels/{channelId}/messages/{messageId}/thread", headers=headers)
print(r.json())

package main

import (
	"bytes"
	"net/http"
	"os"
)

func main() {
	req, _ := http.NewRequest("GET", "https://api.orbit.devotel.io/api/v1/team-chat/channels/{channelId}/messages/{messageId}/thread", nil)
	req.Header.Set("X-API-Key", os.Getenv("ORBIT_API_KEY"))

	http.DefaultClient.Do(req)
}

Ruby

require 'net/http'
require 'json'

uri = URI('https://api.orbit.devotel.io/api/v1/team-chat/channels/{channelId}/messages/{messageId}/thread')
req = Net::HTTP::Get.new(uri)
req['X-API-Key'] = ENV['ORBIT_API_KEY']


res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |h| h.request(req) }
puts res.body

PHP

<?php
$ch = curl_init('https://api.orbit.devotel.io/api/v1/team-chat/channels/{channelId}/messages/{messageId}/thread');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  'X-API-Key: ' . getenv('ORBIT_API_KEY'),

]);

echo curl_exec($ch);

{
  "data": [
    {
      "id": "3a4b5c6d-7e8f-4a2f-8b3d-1c4e5f6a7b8c",
      "channel_id": "9f2c1b7a-4d3e-4b8f-9a1c-2e7d5f8b0a41",
      "sender_user_id": "user_2abc3def4ghi5jkl6mnopqr",
      "body": "Supplier contract draft is in the shared drive. @Ada Lovelace please review the liability clause before Friday.",
      "mentions": ["user_2xyz7wvu8tsr9qpo1nmlkjih"],
      "attachments": [],
      "created_at": "2026-08-28T09:16:30.000Z",
      "edited_at": null,
      "reply_count": 0,
      "last_reply_at": null,
      "sender_name": "Grace Hopper",
      "sender_avatar_url": "https://avatar.example.com/grace.png"
    }
  ],
  "meta": {
    "request_id": "req_list_messages",
    "timestamp": "2026-08-28T09:17:00.000Z"
  }
}

GET /api/v1/team-chat/channels/{channelId}/messages/reactions

string

required

—

string (enum: true|false)

cURL

curl -X GET "https://api.orbit.devotel.io/api/v1/team-chat/channels/{channelId}/messages/reactions" \
  -H "X-API-Key: dv_live_sk_your_key_here" 

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/team-chat/channels/{channelId}/messages/reactions', {
  method: 'GET',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
  },
})
console.log(await res.json())

Python

import os, requests

headers = {"X-API-Key": os.environ["ORBIT_API_KEY"]}
r = requests.get("https://api.orbit.devotel.io/api/v1/team-chat/channels/{channelId}/messages/reactions", headers=headers)
print(r.json())

package main

import (
	"bytes"
	"net/http"
	"os"
)

func main() {
	req, _ := http.NewRequest("GET", "https://api.orbit.devotel.io/api/v1/team-chat/channels/{channelId}/messages/reactions", nil)
	req.Header.Set("X-API-Key", os.Getenv("ORBIT_API_KEY"))

	http.DefaultClient.Do(req)
}

Ruby

require 'net/http'
require 'json'

uri = URI('https://api.orbit.devotel.io/api/v1/team-chat/channels/{channelId}/messages/reactions')
req = Net::HTTP::Get.new(uri)
req['X-API-Key'] = ENV['ORBIT_API_KEY']


res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |h| h.request(req) }
puts res.body

PHP

<?php
$ch = curl_init('https://api.orbit.devotel.io/api/v1/team-chat/channels/{channelId}/messages/reactions');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  'X-API-Key: ' . getenv('ORBIT_API_KEY'),

]);

echo curl_exec($ch);

{
  "data": [
    {
      "id": "3a4b5c6d-7e8f-4a2f-8b3d-1c4e5f6a7b8c",
      "channel_id": "9f2c1b7a-4d3e-4b8f-9a1c-2e7d5f8b0a41",
      "sender_user_id": "user_2abc3def4ghi5jkl6mnopqr",
      "body": "Supplier contract draft is in the shared drive. @Ada Lovelace please review the liability clause before Friday.",
      "mentions": ["user_2xyz7wvu8tsr9qpo1nmlkjih"],
      "attachments": [],
      "created_at": "2026-08-28T09:16:30.000Z",
      "edited_at": null,
      "reply_count": 0,
      "last_reply_at": null,
      "sender_name": "Grace Hopper",
      "sender_avatar_url": "https://avatar.example.com/grace.png"
    }
  ],
  "meta": {
    "request_id": "req_list_messages",
    "timestamp": "2026-08-28T09:17:00.000Z"
  }
}

List DM threads the caller participates in

GET /api/v1/team-chat/dms

string (enum: true|false)

cURL

curl -X GET "https://api.orbit.devotel.io/api/v1/team-chat/dms" \
  -H "X-API-Key: dv_live_sk_your_key_here" 

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/team-chat/dms', {
  method: 'GET',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
  },
})
console.log(await res.json())

Python

import os, requests

headers = {"X-API-Key": os.environ["ORBIT_API_KEY"]}
r = requests.get("https://api.orbit.devotel.io/api/v1/team-chat/dms", headers=headers)
print(r.json())

package main

import (
	"bytes"
	"net/http"
	"os"
)

func main() {
	req, _ := http.NewRequest("GET", "https://api.orbit.devotel.io/api/v1/team-chat/dms", nil)
	req.Header.Set("X-API-Key", os.Getenv("ORBIT_API_KEY"))

	http.DefaultClient.Do(req)
}

Ruby

require 'net/http'
require 'json'

uri = URI('https://api.orbit.devotel.io/api/v1/team-chat/dms')
req = Net::HTTP::Get.new(uri)
req['X-API-Key'] = ENV['ORBIT_API_KEY']


res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |h| h.request(req) }
puts res.body

PHP

<?php
$ch = curl_init('https://api.orbit.devotel.io/api/v1/team-chat/dms');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  'X-API-Key: ' . getenv('ORBIT_API_KEY'),

]);

echo curl_exec($ch);

{
  "data": [
    {
      "id": "3a4b5c6d-7e8f-4a2f-8b3d-1c4e5f6a7b8c",
      "channel_id": "9f2c1b7a-4d3e-4b8f-9a1c-2e7d5f8b0a41",
      "sender_user_id": "user_2abc3def4ghi5jkl6mnopqr",
      "body": "Supplier contract draft is in the shared drive. @Ada Lovelace please review the liability clause before Friday.",
      "mentions": ["user_2xyz7wvu8tsr9qpo1nmlkjih"],
      "attachments": [],
      "created_at": "2026-08-28T09:16:30.000Z",
      "edited_at": null,
      "reply_count": 0,
      "last_reply_at": null,
      "sender_name": "Grace Hopper",
      "sender_avatar_url": "https://avatar.example.com/grace.png"
    }
  ],
  "meta": {
    "request_id": "req_list_messages",
    "timestamp": "2026-08-28T09:17:00.000Z"
  }
}

List messages in a DM thread

GET /api/v1/team-chat/dms/{threadId}/messages

string

required

—

string (enum: true|false)

cURL

curl -X GET "https://api.orbit.devotel.io/api/v1/team-chat/dms/{threadId}/messages" \
  -H "X-API-Key: dv_live_sk_your_key_here" 

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/team-chat/dms/{threadId}/messages', {
  method: 'GET',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
  },
})
console.log(await res.json())

Python

import os, requests

headers = {"X-API-Key": os.environ["ORBIT_API_KEY"]}
r = requests.get("https://api.orbit.devotel.io/api/v1/team-chat/dms/{threadId}/messages", headers=headers)
print(r.json())

package main

import (
	"bytes"
	"net/http"
	"os"
)

func main() {
	req, _ := http.NewRequest("GET", "https://api.orbit.devotel.io/api/v1/team-chat/dms/{threadId}/messages", nil)
	req.Header.Set("X-API-Key", os.Getenv("ORBIT_API_KEY"))

	http.DefaultClient.Do(req)
}

Ruby

require 'net/http'
require 'json'

uri = URI('https://api.orbit.devotel.io/api/v1/team-chat/dms/{threadId}/messages')
req = Net::HTTP::Get.new(uri)
req['X-API-Key'] = ENV['ORBIT_API_KEY']


res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |h| h.request(req) }
puts res.body

PHP

<?php
$ch = curl_init('https://api.orbit.devotel.io/api/v1/team-chat/dms/{threadId}/messages');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  'X-API-Key: ' . getenv('ORBIT_API_KEY'),

]);

echo curl_exec($ch);

{
  "data": [
    {
      "id": "3a4b5c6d-7e8f-4a2f-8b3d-1c4e5f6a7b8c",
      "channel_id": "9f2c1b7a-4d3e-4b8f-9a1c-2e7d5f8b0a41",
      "sender_user_id": "user_2abc3def4ghi5jkl6mnopqr",
      "body": "Supplier contract draft is in the shared drive. @Ada Lovelace please review the liability clause before Friday.",
      "mentions": ["user_2xyz7wvu8tsr9qpo1nmlkjih"],
      "attachments": [],
      "created_at": "2026-08-28T09:16:30.000Z",
      "edited_at": null,
      "reply_count": 0,
      "last_reply_at": null,
      "sender_name": "Grace Hopper",
      "sender_avatar_url": "https://avatar.example.com/grace.png"
    }
  ],
  "meta": {
    "request_id": "req_list_messages",
    "timestamp": "2026-08-28T09:17:00.000Z"
  }
}

GET /api/v1/team-chat/dms/{threadId}/messages/reactions

string

required

—

string (enum: true|false)

cURL

curl -X GET "https://api.orbit.devotel.io/api/v1/team-chat/dms/{threadId}/messages/reactions" \
  -H "X-API-Key: dv_live_sk_your_key_here" 

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/team-chat/dms/{threadId}/messages/reactions', {
  method: 'GET',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
  },
})
console.log(await res.json())

Python

import os, requests

headers = {"X-API-Key": os.environ["ORBIT_API_KEY"]}
r = requests.get("https://api.orbit.devotel.io/api/v1/team-chat/dms/{threadId}/messages/reactions", headers=headers)
print(r.json())

package main

import (
	"bytes"
	"net/http"
	"os"
)

func main() {
	req, _ := http.NewRequest("GET", "https://api.orbit.devotel.io/api/v1/team-chat/dms/{threadId}/messages/reactions", nil)
	req.Header.Set("X-API-Key", os.Getenv("ORBIT_API_KEY"))

	http.DefaultClient.Do(req)
}

Ruby

require 'net/http'
require 'json'

uri = URI('https://api.orbit.devotel.io/api/v1/team-chat/dms/{threadId}/messages/reactions')
req = Net::HTTP::Get.new(uri)
req['X-API-Key'] = ENV['ORBIT_API_KEY']


res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |h| h.request(req) }
puts res.body

PHP

<?php
$ch = curl_init('https://api.orbit.devotel.io/api/v1/team-chat/dms/{threadId}/messages/reactions');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  'X-API-Key: ' . getenv('ORBIT_API_KEY'),

]);

echo curl_exec($ch);

{
  "data": [
    {
      "id": "3a4b5c6d-7e8f-4a2f-8b3d-1c4e5f6a7b8c",
      "channel_id": "9f2c1b7a-4d3e-4b8f-9a1c-2e7d5f8b0a41",
      "sender_user_id": "user_2abc3def4ghi5jkl6mnopqr",
      "body": "Supplier contract draft is in the shared drive. @Ada Lovelace please review the liability clause before Friday.",
      "mentions": ["user_2xyz7wvu8tsr9qpo1nmlkjih"],
      "attachments": [],
      "created_at": "2026-08-28T09:16:30.000Z",
      "edited_at": null,
      "reply_count": 0,
      "last_reply_at": null,
      "sender_name": "Grace Hopper",
      "sender_avatar_url": "https://avatar.example.com/grace.png"
    }
  ],
  "meta": {
    "request_id": "req_list_messages",
    "timestamp": "2026-08-28T09:17:00.000Z"
  }
}

Snapshot of online peers (+ last-seen for requested users)

GET /api/v1/team-chat/presence

string (enum: true|false)

cURL

curl -X GET "https://api.orbit.devotel.io/api/v1/team-chat/presence" \
  -H "X-API-Key: dv_live_sk_your_key_here" 

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/team-chat/presence', {
  method: 'GET',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
  },
})
console.log(await res.json())

Python

import os, requests

headers = {"X-API-Key": os.environ["ORBIT_API_KEY"]}
r = requests.get("https://api.orbit.devotel.io/api/v1/team-chat/presence", headers=headers)
print(r.json())

package main

import (
	"bytes"
	"net/http"
	"os"
)

func main() {
	req, _ := http.NewRequest("GET", "https://api.orbit.devotel.io/api/v1/team-chat/presence", nil)
	req.Header.Set("X-API-Key", os.Getenv("ORBIT_API_KEY"))

	http.DefaultClient.Do(req)
}

Ruby

require 'net/http'
require 'json'

uri = URI('https://api.orbit.devotel.io/api/v1/team-chat/presence')
req = Net::HTTP::Get.new(uri)
req['X-API-Key'] = ENV['ORBIT_API_KEY']


res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |h| h.request(req) }
puts res.body

PHP

<?php
$ch = curl_init('https://api.orbit.devotel.io/api/v1/team-chat/presence');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  'X-API-Key: ' . getenv('ORBIT_API_KEY'),

]);

echo curl_exec($ch);

{
  "data": [
    {
      "id": "3a4b5c6d-7e8f-4a2f-8b3d-1c4e5f6a7b8c",
      "channel_id": "9f2c1b7a-4d3e-4b8f-9a1c-2e7d5f8b0a41",
      "sender_user_id": "user_2abc3def4ghi5jkl6mnopqr",
      "body": "Supplier contract draft is in the shared drive. @Ada Lovelace please review the liability clause before Friday.",
      "mentions": ["user_2xyz7wvu8tsr9qpo1nmlkjih"],
      "attachments": [],
      "created_at": "2026-08-28T09:16:30.000Z",
      "edited_at": null,
      "reply_count": 0,
      "last_reply_at": null,
      "sender_name": "Grace Hopper",
      "sender_avatar_url": "https://avatar.example.com/grace.png"
    }
  ],
  "meta": {
    "request_id": "req_list_messages",
    "timestamp": "2026-08-28T09:17:00.000Z"
  }
}

Full-text search channel messages across the channels you belong to

GET /api/v1/team-chat/search

string (enum: true|false)

cURL

curl -X GET "https://api.orbit.devotel.io/api/v1/team-chat/search" \
  -H "X-API-Key: dv_live_sk_your_key_here" 

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/team-chat/search', {
  method: 'GET',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
  },
})
console.log(await res.json())

Python

import os, requests

headers = {"X-API-Key": os.environ["ORBIT_API_KEY"]}
r = requests.get("https://api.orbit.devotel.io/api/v1/team-chat/search", headers=headers)
print(r.json())

package main

import (
	"bytes"
	"net/http"
	"os"
)

func main() {
	req, _ := http.NewRequest("GET", "https://api.orbit.devotel.io/api/v1/team-chat/search", nil)
	req.Header.Set("X-API-Key", os.Getenv("ORBIT_API_KEY"))

	http.DefaultClient.Do(req)
}

Ruby

require 'net/http'
require 'json'

uri = URI('https://api.orbit.devotel.io/api/v1/team-chat/search')
req = Net::HTTP::Get.new(uri)
req['X-API-Key'] = ENV['ORBIT_API_KEY']


res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |h| h.request(req) }
puts res.body

PHP

<?php
$ch = curl_init('https://api.orbit.devotel.io/api/v1/team-chat/search');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  'X-API-Key: ' . getenv('ORBIT_API_KEY'),

]);

echo curl_exec($ch);

{
  "data": [
    {
      "id": "3a4b5c6d-7e8f-4a2f-8b3d-1c4e5f6a7b8c",
      "channel_id": "9f2c1b7a-4d3e-4b8f-9a1c-2e7d5f8b0a41",
      "sender_user_id": "user_2abc3def4ghi5jkl6mnopqr",
      "body": "Supplier contract draft is in the shared drive. @Ada Lovelace please review the liability clause before Friday.",
      "mentions": ["user_2xyz7wvu8tsr9qpo1nmlkjih"],
      "attachments": [],
      "created_at": "2026-08-28T09:16:30.000Z",
      "edited_at": null,
      "reply_count": 0,
      "last_reply_at": null,
      "sender_name": "Grace Hopper",
      "sender_avatar_url": "https://avatar.example.com/grace.png"
    }
  ],
  "meta": {
    "request_id": "req_list_messages",
    "timestamp": "2026-08-28T09:17:00.000Z"
  }
}

Upload a file attachment for team chat

POST /api/v1/team-chat/attachments

string

Stripe-style idempotency token. Pass a stable, client-generated value (1-255 chars) to dedupe retries on transient timeouts. The same key+credential+path replays the original response for 24h on 2xx (5min on 4xx, 30s on 5xx). Returns 409 if a concurrent request with the same key is already in flight; replayed responses include the Idempotency-Replay: true response header.

string (enum: true|false)

cURL

curl -X POST "https://api.orbit.devotel.io/api/v1/team-chat/attachments" \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{}'

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/team-chat/attachments', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
})
console.log(await res.json())

Python

import os, requests

headers = {"X-API-Key": os.environ["ORBIT_API_KEY"]}
headers["Content-Type"] = "application/json"
r = requests.post("https://api.orbit.devotel.io/api/v1/team-chat/attachments", headers=headers, json={})
print(r.json())

package main

import (
	"bytes"
	"net/http"
	"os"
)

func main() {
	req, _ := http.NewRequest("POST", "https://api.orbit.devotel.io/api/v1/team-chat/attachments", bytes.NewBuffer([]byte(`{}`)))
	req.Header.Set("X-API-Key", os.Getenv("ORBIT_API_KEY"))
	req.Header.Set("Content-Type", "application/json")
	http.DefaultClient.Do(req)
}

Ruby

require 'net/http'
require 'json'

uri = URI('https://api.orbit.devotel.io/api/v1/team-chat/attachments')
req = Net::HTTP::Post.new(uri)
req['X-API-Key'] = ENV['ORBIT_API_KEY']
req['Content-Type'] = 'application/json'
req.body = {}.to_json
res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |h| h.request(req) }
puts res.body

PHP

<?php
$ch = curl_init('https://api.orbit.devotel.io/api/v1/team-chat/attachments');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  'X-API-Key: ' . getenv('ORBIT_API_KEY'),
  'Content-Type: application/json',
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, <<<JSON
{}
JSON);
echo curl_exec($ch);

{
  "data": [
    {
      "id": "3a4b5c6d-7e8f-4a2f-8b3d-1c4e5f6a7b8c",
      "channel_id": "9f2c1b7a-4d3e-4b8f-9a1c-2e7d5f8b0a41",
      "sender_user_id": "user_2abc3def4ghi5jkl6mnopqr",
      "body": "Supplier contract draft is in the shared drive. @Ada Lovelace please review the liability clause before Friday.",
      "mentions": ["user_2xyz7wvu8tsr9qpo1nmlkjih"],
      "attachments": [],
      "created_at": "2026-08-28T09:16:30.000Z",
      "edited_at": null,
      "reply_count": 0,
      "last_reply_at": null,
      "sender_name": "Grace Hopper",
      "sender_avatar_url": "https://avatar.example.com/grace.png"
    }
  ],
  "meta": {
    "request_id": "req_list_messages",
    "timestamp": "2026-08-28T09:17:00.000Z"
  }
}

Create an internal team channel

POST /api/v1/team-chat/channels

string

string (enum: true|false)

cURL

curl -X POST "https://api.orbit.devotel.io/api/v1/team-chat/channels" \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{}'

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/team-chat/channels', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
})
console.log(await res.json())

Python

import os, requests

headers = {"X-API-Key": os.environ["ORBIT_API_KEY"]}
headers["Content-Type"] = "application/json"
r = requests.post("https://api.orbit.devotel.io/api/v1/team-chat/channels", headers=headers, json={})
print(r.json())

package main

import (
	"bytes"
	"net/http"
	"os"
)

func main() {
	req, _ := http.NewRequest("POST", "https://api.orbit.devotel.io/api/v1/team-chat/channels", bytes.NewBuffer([]byte(`{}`)))
	req.Header.Set("X-API-Key", os.Getenv("ORBIT_API_KEY"))
	req.Header.Set("Content-Type", "application/json")
	http.DefaultClient.Do(req)
}

Ruby

require 'net/http'
require 'json'

uri = URI('https://api.orbit.devotel.io/api/v1/team-chat/channels')
req = Net::HTTP::Post.new(uri)
req['X-API-Key'] = ENV['ORBIT_API_KEY']
req['Content-Type'] = 'application/json'
req.body = {}.to_json
res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |h| h.request(req) }
puts res.body

PHP

<?php
$ch = curl_init('https://api.orbit.devotel.io/api/v1/team-chat/channels');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  'X-API-Key: ' . getenv('ORBIT_API_KEY'),
  'Content-Type: application/json',
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, <<<JSON
{}
JSON);
echo curl_exec($ch);

{
  "data": [
    {
      "id": "3a4b5c6d-7e8f-4a2f-8b3d-1c4e5f6a7b8c",
      "channel_id": "9f2c1b7a-4d3e-4b8f-9a1c-2e7d5f8b0a41",
      "sender_user_id": "user_2abc3def4ghi5jkl6mnopqr",
      "body": "Supplier contract draft is in the shared drive. @Ada Lovelace please review the liability clause before Friday.",
      "mentions": ["user_2xyz7wvu8tsr9qpo1nmlkjih"],
      "attachments": [],
      "created_at": "2026-08-28T09:16:30.000Z",
      "edited_at": null,
      "reply_count": 0,
      "last_reply_at": null,
      "sender_name": "Grace Hopper",
      "sender_avatar_url": "https://avatar.example.com/grace.png"
    }
  ],
  "meta": {
    "request_id": "req_list_messages",
    "timestamp": "2026-08-28T09:17:00.000Z"
  }
}

Start a huddle in a channel, or drop into the live one

POST /api/v1/team-chat/channels/{channelId}/huddle

string

required

—

string

string (enum: true|false)

cURL

curl -X POST "https://api.orbit.devotel.io/api/v1/team-chat/channels/{channelId}/huddle" \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{}'

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/team-chat/channels/{channelId}/huddle', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
})
console.log(await res.json())

Python

import os, requests

headers = {"X-API-Key": os.environ["ORBIT_API_KEY"]}
headers["Content-Type"] = "application/json"
r = requests.post("https://api.orbit.devotel.io/api/v1/team-chat/channels/{channelId}/huddle", headers=headers, json={})
print(r.json())

package main

import (
	"bytes"
	"net/http"
	"os"
)

func main() {
	req, _ := http.NewRequest("POST", "https://api.orbit.devotel.io/api/v1/team-chat/channels/{channelId}/huddle", bytes.NewBuffer([]byte(`{}`)))
	req.Header.Set("X-API-Key", os.Getenv("ORBIT_API_KEY"))
	req.Header.Set("Content-Type", "application/json")
	http.DefaultClient.Do(req)
}

Ruby

require 'net/http'
require 'json'

uri = URI('https://api.orbit.devotel.io/api/v1/team-chat/channels/{channelId}/huddle')
req = Net::HTTP::Post.new(uri)
req['X-API-Key'] = ENV['ORBIT_API_KEY']
req['Content-Type'] = 'application/json'
req.body = {}.to_json
res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |h| h.request(req) }
puts res.body

PHP

<?php
$ch = curl_init('https://api.orbit.devotel.io/api/v1/team-chat/channels/{channelId}/huddle');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  'X-API-Key: ' . getenv('ORBIT_API_KEY'),
  'Content-Type: application/json',
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, <<<JSON
{}
JSON);
echo curl_exec($ch);

{
  "data": [
    {
      "id": "3a4b5c6d-7e8f-4a2f-8b3d-1c4e5f6a7b8c",
      "channel_id": "9f2c1b7a-4d3e-4b8f-9a1c-2e7d5f8b0a41",
      "sender_user_id": "user_2abc3def4ghi5jkl6mnopqr",
      "body": "Supplier contract draft is in the shared drive. @Ada Lovelace please review the liability clause before Friday.",
      "mentions": ["user_2xyz7wvu8tsr9qpo1nmlkjih"],
      "attachments": [],
      "created_at": "2026-08-28T09:16:30.000Z",
      "edited_at": null,
      "reply_count": 0,
      "last_reply_at": null,
      "sender_name": "Grace Hopper",
      "sender_avatar_url": "https://avatar.example.com/grace.png"
    }
  ],
  "meta": {
    "request_id": "req_list_messages",
    "timestamp": "2026-08-28T09:17:00.000Z"
  }
}

Leave the channel huddle (ends it when the room empties)

POST /api/v1/team-chat/channels/{channelId}/huddle/leave

string

required

—

string

string (enum: true|false)

cURL

curl -X POST "https://api.orbit.devotel.io/api/v1/team-chat/channels/{channelId}/huddle/leave" \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{}'

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/team-chat/channels/{channelId}/huddle/leave', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
})
console.log(await res.json())

Python

import os, requests

headers = {"X-API-Key": os.environ["ORBIT_API_KEY"]}
headers["Content-Type"] = "application/json"
r = requests.post("https://api.orbit.devotel.io/api/v1/team-chat/channels/{channelId}/huddle/leave", headers=headers, json={})
print(r.json())

package main

import (
	"bytes"
	"net/http"
	"os"
)

func main() {
	req, _ := http.NewRequest("POST", "https://api.orbit.devotel.io/api/v1/team-chat/channels/{channelId}/huddle/leave", bytes.NewBuffer([]byte(`{}`)))
	req.Header.Set("X-API-Key", os.Getenv("ORBIT_API_KEY"))
	req.Header.Set("Content-Type", "application/json")
	http.DefaultClient.Do(req)
}

Ruby

require 'net/http'
require 'json'

uri = URI('https://api.orbit.devotel.io/api/v1/team-chat/channels/{channelId}/huddle/leave')
req = Net::HTTP::Post.new(uri)
req['X-API-Key'] = ENV['ORBIT_API_KEY']
req['Content-Type'] = 'application/json'
req.body = {}.to_json
res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |h| h.request(req) }
puts res.body

PHP

<?php
$ch = curl_init('https://api.orbit.devotel.io/api/v1/team-chat/channels/{channelId}/huddle/leave');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  'X-API-Key: ' . getenv('ORBIT_API_KEY'),
  'Content-Type: application/json',
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, <<<JSON
{}
JSON);
echo curl_exec($ch);

{
  "data": [
    {
      "id": "3a4b5c6d-7e8f-4a2f-8b3d-1c4e5f6a7b8c",
      "channel_id": "9f2c1b7a-4d3e-4b8f-9a1c-2e7d5f8b0a41",
      "sender_user_id": "user_2abc3def4ghi5jkl6mnopqr",
      "body": "Supplier contract draft is in the shared drive. @Ada Lovelace please review the liability clause before Friday.",
      "mentions": ["user_2xyz7wvu8tsr9qpo1nmlkjih"],
      "attachments": [],
      "created_at": "2026-08-28T09:16:30.000Z",
      "edited_at": null,
      "reply_count": 0,
      "last_reply_at": null,
      "sender_name": "Grace Hopper",
      "sender_avatar_url": "https://avatar.example.com/grace.png"
    }
  ],
  "meta": {
    "request_id": "req_list_messages",
    "timestamp": "2026-08-28T09:17:00.000Z"
  }
}

Add a member to a channel

POST /api/v1/team-chat/channels/{channelId}/members

string

required

—

string

string (enum: true|false)

cURL

curl -X POST "https://api.orbit.devotel.io/api/v1/team-chat/channels/{channelId}/members" \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{}'

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/team-chat/channels/{channelId}/members', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
})
console.log(await res.json())

{
  "data": [
    {
      "id": "3a4b5c6d-7e8f-4a2f-8b3d-1c4e5f6a7b8c",
      "channel_id": "9f2c1b7a-4d3e-4b8f-9a1c-2e7d5f8b0a41",
      "sender_user_id": "user_2abc3def4ghi5jkl6mnopqr",
      "body": "Supplier contract draft is in the shared drive. @Ada Lovelace please review the liability clause before Friday.",
      "mentions": ["user_2xyz7wvu8tsr9qpo1nmlkjih"],
      "attachments": [],
      "created_at": "2026-08-28T09:16:30.000Z",
      "edited_at": null,
      "reply_count": 0,
      "last_reply_at": null,
      "sender_name": "Grace Hopper",
      "sender_avatar_url": "https://avatar.example.com/grace.png"
    }
  ],
  "meta": {
    "request_id": "req_list_messages",
    "timestamp": "2026-08-28T09:17:00.000Z"
  }
}

Post a message to a channel

POST /api/v1/team-chat/channels/{channelId}/messages

string

required

—

string

string (enum: true|false)

cURL

curl -X POST "https://api.orbit.devotel.io/api/v1/team-chat/channels/{channelId}/messages" \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{}'

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/team-chat/channels/{channelId}/messages', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
})
console.log(await res.json())

{
  "data": [
    {
      "id": "3a4b5c6d-7e8f-4a2f-8b3d-1c4e5f6a7b8c",
      "channel_id": "9f2c1b7a-4d3e-4b8f-9a1c-2e7d5f8b0a41",
      "sender_user_id": "user_2abc3def4ghi5jkl6mnopqr",
      "body": "Supplier contract draft is in the shared drive. @Ada Lovelace please review the liability clause before Friday.",
      "mentions": ["user_2xyz7wvu8tsr9qpo1nmlkjih"],
      "attachments": [],
      "created_at": "2026-08-28T09:16:30.000Z",
      "edited_at": null,
      "reply_count": 0,
      "last_reply_at": null,
      "sender_name": "Grace Hopper",
      "sender_avatar_url": "https://avatar.example.com/grace.png"
    }
  ],
  "meta": {
    "request_id": "req_list_messages",
    "timestamp": "2026-08-28T09:17:00.000Z"
  }
}

Add a reaction to a channel message

POST /api/v1/team-chat/channels/{channelId}/messages/{messageId}/reactions

string

required

—

string

required

—

string

string (enum: true|false)

cURL

curl -X POST "https://api.orbit.devotel.io/api/v1/team-chat/channels/{channelId}/messages/{messageId}/reactions" \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{}'

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/team-chat/channels/{channelId}/messages/{messageId}/reactions', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
})
console.log(await res.json())

{
  "data": [
    {
      "id": "3a4b5c6d-7e8f-4a2f-8b3d-1c4e5f6a7b8c",
      "channel_id": "9f2c1b7a-4d3e-4b8f-9a1c-2e7d5f8b0a41",
      "sender_user_id": "user_2abc3def4ghi5jkl6mnopqr",
      "body": "Supplier contract draft is in the shared drive. @Ada Lovelace please review the liability clause before Friday.",
      "mentions": ["user_2xyz7wvu8tsr9qpo1nmlkjih"],
      "attachments": [],
      "created_at": "2026-08-28T09:16:30.000Z",
      "edited_at": null,
      "reply_count": 0,
      "last_reply_at": null,
      "sender_name": "Grace Hopper",
      "sender_avatar_url": "https://avatar.example.com/grace.png"
    }
  ],
  "meta": {
    "request_id": "req_list_messages",
    "timestamp": "2026-08-28T09:17:00.000Z"
  }
}

Reply in-thread to a channel message

POST /api/v1/team-chat/channels/{channelId}/messages/{messageId}/replies

string

required

—

string

required

—

string

string (enum: true|false)

cURL

curl -X POST "https://api.orbit.devotel.io/api/v1/team-chat/channels/{channelId}/messages/{messageId}/replies" \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{}'

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/team-chat/channels/{channelId}/messages/{messageId}/replies', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
})
console.log(await res.json())

{
  "data": [
    {
      "id": "3a4b5c6d-7e8f-4a2f-8b3d-1c4e5f6a7b8c",
      "channel_id": "9f2c1b7a-4d3e-4b8f-9a1c-2e7d5f8b0a41",
      "sender_user_id": "user_2abc3def4ghi5jkl6mnopqr",
      "body": "Supplier contract draft is in the shared drive. @Ada Lovelace please review the liability clause before Friday.",
      "mentions": ["user_2xyz7wvu8tsr9qpo1nmlkjih"],
      "attachments": [],
      "created_at": "2026-08-28T09:16:30.000Z",
      "edited_at": null,
      "reply_count": 0,
      "last_reply_at": null,
      "sender_name": "Grace Hopper",
      "sender_avatar_url": "https://avatar.example.com/grace.png"
    }
  ],
  "meta": {
    "request_id": "req_list_messages",
    "timestamp": "2026-08-28T09:17:00.000Z"
  }
}

Mark a channel read (advances the caller’s per-channel read cursor)

POST /api/v1/team-chat/channels/{channelId}/read

string

required

—

string

string (enum: true|false)

cURL

curl -X POST "https://api.orbit.devotel.io/api/v1/team-chat/channels/{channelId}/read" \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{}'

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/team-chat/channels/{channelId}/read', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
})
console.log(await res.json())

{
  "data": [
    {
      "id": "3a4b5c6d-7e8f-4a2f-8b3d-1c4e5f6a7b8c",
      "channel_id": "9f2c1b7a-4d3e-4b8f-9a1c-2e7d5f8b0a41",
      "sender_user_id": "user_2abc3def4ghi5jkl6mnopqr",
      "body": "Supplier contract draft is in the shared drive. @Ada Lovelace please review the liability clause before Friday.",
      "mentions": ["user_2xyz7wvu8tsr9qpo1nmlkjih"],
      "attachments": [],
      "created_at": "2026-08-28T09:16:30.000Z",
      "edited_at": null,
      "reply_count": 0,
      "last_reply_at": null,
      "sender_name": "Grace Hopper",
      "sender_avatar_url": "https://avatar.example.com/grace.png"
    }
  ],
  "meta": {
    "request_id": "req_list_messages",
    "timestamp": "2026-08-28T09:17:00.000Z"
  }
}

Open (get-or-create) a 1:1 DM thread with another user

POST /api/v1/team-chat/dms

string

string (enum: true|false)

cURL

curl -X POST "https://api.orbit.devotel.io/api/v1/team-chat/dms" \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{}'

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/team-chat/dms', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
})
console.log(await res.json())

{
  "data": [
    {
      "id": "3a4b5c6d-7e8f-4a2f-8b3d-1c4e5f6a7b8c",
      "channel_id": "9f2c1b7a-4d3e-4b8f-9a1c-2e7d5f8b0a41",
      "sender_user_id": "user_2abc3def4ghi5jkl6mnopqr",
      "body": "Supplier contract draft is in the shared drive. @Ada Lovelace please review the liability clause before Friday.",
      "mentions": ["user_2xyz7wvu8tsr9qpo1nmlkjih"],
      "attachments": [],
      "created_at": "2026-08-28T09:16:30.000Z",
      "edited_at": null,
      "reply_count": 0,
      "last_reply_at": null,
      "sender_name": "Grace Hopper",
      "sender_avatar_url": "https://avatar.example.com/grace.png"
    }
  ],
  "meta": {
    "request_id": "req_list_messages",
    "timestamp": "2026-08-28T09:17:00.000Z"
  }
}

Send a message in a DM thread

POST /api/v1/team-chat/dms/{threadId}/messages

string

required

—

string

string (enum: true|false)

cURL

curl -X POST "https://api.orbit.devotel.io/api/v1/team-chat/dms/{threadId}/messages" \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{}'

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/team-chat/dms/{threadId}/messages', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
})
console.log(await res.json())

{
  "data": [
    {
      "id": "3a4b5c6d-7e8f-4a2f-8b3d-1c4e5f6a7b8c",
      "channel_id": "9f2c1b7a-4d3e-4b8f-9a1c-2e7d5f8b0a41",
      "sender_user_id": "user_2abc3def4ghi5jkl6mnopqr",
      "body": "Supplier contract draft is in the shared drive. @Ada Lovelace please review the liability clause before Friday.",
      "mentions": ["user_2xyz7wvu8tsr9qpo1nmlkjih"],
      "attachments": [],
      "created_at": "2026-08-28T09:16:30.000Z",
      "edited_at": null,
      "reply_count": 0,
      "last_reply_at": null,
      "sender_name": "Grace Hopper",
      "sender_avatar_url": "https://avatar.example.com/grace.png"
    }
  ],
  "meta": {
    "request_id": "req_list_messages",
    "timestamp": "2026-08-28T09:17:00.000Z"
  }
}

Add a reaction to a DM message

POST /api/v1/team-chat/dms/{threadId}/messages/{messageId}/reactions

string

required

—

string

required

—

string

string (enum: true|false)

cURL

curl -X POST "https://api.orbit.devotel.io/api/v1/team-chat/dms/{threadId}/messages/{messageId}/reactions" \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{}'

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/team-chat/dms/{threadId}/messages/{messageId}/reactions', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
})
console.log(await res.json())

{
  "data": [
    {
      "id": "3a4b5c6d-7e8f-4a2f-8b3d-1c4e5f6a7b8c",
      "channel_id": "9f2c1b7a-4d3e-4b8f-9a1c-2e7d5f8b0a41",
      "sender_user_id": "user_2abc3def4ghi5jkl6mnopqr",
      "body": "Supplier contract draft is in the shared drive. @Ada Lovelace please review the liability clause before Friday.",
      "mentions": ["user_2xyz7wvu8tsr9qpo1nmlkjih"],
      "attachments": [],
      "created_at": "2026-08-28T09:16:30.000Z",
      "edited_at": null,
      "reply_count": 0,
      "last_reply_at": null,
      "sender_name": "Grace Hopper",
      "sender_avatar_url": "https://avatar.example.com/grace.png"
    }
  ],
  "meta": {
    "request_id": "req_list_messages",
    "timestamp": "2026-08-28T09:17:00.000Z"
  }
}

Mark inbound DM messages in a thread as read

POST /api/v1/team-chat/dms/{threadId}/read

string

required

—

string

string (enum: true|false)

cURL

curl -X POST "https://api.orbit.devotel.io/api/v1/team-chat/dms/{threadId}/read" \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{}'

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/team-chat/dms/{threadId}/read', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
})
console.log(await res.json())

{
  "data": [
    {
      "id": "3a4b5c6d-7e8f-4a2f-8b3d-1c4e5f6a7b8c",
      "channel_id": "9f2c1b7a-4d3e-4b8f-9a1c-2e7d5f8b0a41",
      "sender_user_id": "user_2abc3def4ghi5jkl6mnopqr",
      "body": "Supplier contract draft is in the shared drive. @Ada Lovelace please review the liability clause before Friday.",
      "mentions": ["user_2xyz7wvu8tsr9qpo1nmlkjih"],
      "attachments": [],
      "created_at": "2026-08-28T09:16:30.000Z",
      "edited_at": null,
      "reply_count": 0,
      "last_reply_at": null,
      "sender_name": "Grace Hopper",
      "sender_avatar_url": "https://avatar.example.com/grace.png"
    }
  ],
  "meta": {
    "request_id": "req_list_messages",
    "timestamp": "2026-08-28T09:17:00.000Z"
  }
}

Refresh the caller’s presence (online/away)

POST /api/v1/team-chat/presence/heartbeat

string

string (enum: true|false)

cURL

curl -X POST "https://api.orbit.devotel.io/api/v1/team-chat/presence/heartbeat" \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{}'

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/team-chat/presence/heartbeat', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
})
console.log(await res.json())

{
  "data": [
    {
      "id": "3a4b5c6d-7e8f-4a2f-8b3d-1c4e5f6a7b8c",
      "channel_id": "9f2c1b7a-4d3e-4b8f-9a1c-2e7d5f8b0a41",
      "sender_user_id": "user_2abc3def4ghi5jkl6mnopqr",
      "body": "Supplier contract draft is in the shared drive. @Ada Lovelace please review the liability clause before Friday.",
      "mentions": ["user_2xyz7wvu8tsr9qpo1nmlkjih"],
      "attachments": [],
      "created_at": "2026-08-28T09:16:30.000Z",
      "edited_at": null,
      "reply_count": 0,
      "last_reply_at": null,
      "sender_name": "Grace Hopper",
      "sender_avatar_url": "https://avatar.example.com/grace.png"
    }
  ],
  "meta": {
    "request_id": "req_list_messages",
    "timestamp": "2026-08-28T09:17:00.000Z"
  }
}

Broadcast a typing indicator to a channel or DM peer

POST /api/v1/team-chat/typing

string

string (enum: true|false)

cURL

curl -X POST "https://api.orbit.devotel.io/api/v1/team-chat/typing" \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{}'

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/team-chat/typing', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
})
console.log(await res.json())

{
  "data": [
    {
      "id": "3a4b5c6d-7e8f-4a2f-8b3d-1c4e5f6a7b8c",
      "channel_id": "9f2c1b7a-4d3e-4b8f-9a1c-2e7d5f8b0a41",
      "sender_user_id": "user_2abc3def4ghi5jkl6mnopqr",
      "body": "Supplier contract draft is in the shared drive. @Ada Lovelace please review the liability clause before Friday.",
      "mentions": ["user_2xyz7wvu8tsr9qpo1nmlkjih"],
      "attachments": [],
      "created_at": "2026-08-28T09:16:30.000Z",
      "edited_at": null,
      "reply_count": 0,
      "last_reply_at": null,
      "sender_name": "Grace Hopper",
      "sender_avatar_url": "https://avatar.example.com/grace.png"
    }
  ],
  "meta": {
    "request_id": "req_list_messages",
    "timestamp": "2026-08-28T09:17:00.000Z"
  }
}

Edit your own channel message

PATCH /api/v1/team-chat/channels/{channelId}/messages/{messageId}

string

required

—

string

required

—

string (enum: true|false)

cURL

curl -X PATCH "https://api.orbit.devotel.io/api/v1/team-chat/channels/{channelId}/messages/{messageId}" \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{}'

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/team-chat/channels/{channelId}/messages/{messageId}', {
  method: 'PATCH',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
})
console.log(await res.json())

{
  "data": [
    {
      "id": "3a4b5c6d-7e8f-4a2f-8b3d-1c4e5f6a7b8c",
      "channel_id": "9f2c1b7a-4d3e-4b8f-9a1c-2e7d5f8b0a41",
      "sender_user_id": "user_2abc3def4ghi5jkl6mnopqr",
      "body": "Supplier contract draft is in the shared drive. @Ada Lovelace please review the liability clause before Friday.",
      "mentions": ["user_2xyz7wvu8tsr9qpo1nmlkjih"],
      "attachments": [],
      "created_at": "2026-08-28T09:16:30.000Z",
      "edited_at": null,
      "reply_count": 0,
      "last_reply_at": null,
      "sender_name": "Grace Hopper",
      "sender_avatar_url": "https://avatar.example.com/grace.png"
    }
  ],
  "meta": {
    "request_id": "req_list_messages",
    "timestamp": "2026-08-28T09:17:00.000Z"
  }
}

Delete a channel and all of its messages (owner only)

DELETE /api/v1/team-chat/channels/{channelId}

string

required

—

string (enum: true|false)

cURL

curl -X DELETE "https://api.orbit.devotel.io/api/v1/team-chat/channels/{channelId}" \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{}'

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/team-chat/channels/{channelId}', {
  method: 'DELETE',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
})
console.log(await res.json())

{
  "data": [
    {
      "id": "3a4b5c6d-7e8f-4a2f-8b3d-1c4e5f6a7b8c",
      "channel_id": "9f2c1b7a-4d3e-4b8f-9a1c-2e7d5f8b0a41",
      "sender_user_id": "user_2abc3def4ghi5jkl6mnopqr",
      "body": "Supplier contract draft is in the shared drive. @Ada Lovelace please review the liability clause before Friday.",
      "mentions": ["user_2xyz7wvu8tsr9qpo1nmlkjih"],
      "attachments": [],
      "created_at": "2026-08-28T09:16:30.000Z",
      "edited_at": null,
      "reply_count": 0,
      "last_reply_at": null,
      "sender_name": "Grace Hopper",
      "sender_avatar_url": "https://avatar.example.com/grace.png"
    }
  ],
  "meta": {
    "request_id": "req_list_messages",
    "timestamp": "2026-08-28T09:17:00.000Z"
  }
}

Remove a member from a channel

DELETE /api/v1/team-chat/channels/{channelId}/members/{userId}

string

required

—

string

required

—

string (enum: true|false)

cURL

curl -X DELETE "https://api.orbit.devotel.io/api/v1/team-chat/channels/{channelId}/members/{userId}" \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{}'

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/team-chat/channels/{channelId}/members/{userId}', {
  method: 'DELETE',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
})
console.log(await res.json())

{
  "data": [
    {
      "id": "3a4b5c6d-7e8f-4a2f-8b3d-1c4e5f6a7b8c",
      "channel_id": "9f2c1b7a-4d3e-4b8f-9a1c-2e7d5f8b0a41",
      "sender_user_id": "user_2abc3def4ghi5jkl6mnopqr",
      "body": "Supplier contract draft is in the shared drive. @Ada Lovelace please review the liability clause before Friday.",
      "mentions": ["user_2xyz7wvu8tsr9qpo1nmlkjih"],
      "attachments": [],
      "created_at": "2026-08-28T09:16:30.000Z",
      "edited_at": null,
      "reply_count": 0,
      "last_reply_at": null,
      "sender_name": "Grace Hopper",
      "sender_avatar_url": "https://avatar.example.com/grace.png"
    }
  ],
  "meta": {
    "request_id": "req_list_messages",
    "timestamp": "2026-08-28T09:17:00.000Z"
  }
}

Soft-delete a channel message (own message, or any as channel owner/admin)

DELETE /api/v1/team-chat/channels/{channelId}/messages/{messageId}

string

required

—

string

required

—

string (enum: true|false)

cURL

curl -X DELETE "https://api.orbit.devotel.io/api/v1/team-chat/channels/{channelId}/messages/{messageId}" \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{}'

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/team-chat/channels/{channelId}/messages/{messageId}', {
  method: 'DELETE',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
})
console.log(await res.json())

{
  "data": [
    {
      "id": "3a4b5c6d-7e8f-4a2f-8b3d-1c4e5f6a7b8c",
      "channel_id": "9f2c1b7a-4d3e-4b8f-9a1c-2e7d5f8b0a41",
      "sender_user_id": "user_2abc3def4ghi5jkl6mnopqr",
      "body": "Supplier contract draft is in the shared drive. @Ada Lovelace please review the liability clause before Friday.",
      "mentions": ["user_2xyz7wvu8tsr9qpo1nmlkjih"],
      "attachments": [],
      "created_at": "2026-08-28T09:16:30.000Z",
      "edited_at": null,
      "reply_count": 0,
      "last_reply_at": null,
      "sender_name": "Grace Hopper",
      "sender_avatar_url": "https://avatar.example.com/grace.png"
    }
  ],
  "meta": {
    "request_id": "req_list_messages",
    "timestamp": "2026-08-28T09:17:00.000Z"
  }
}

Remove your reaction from a channel message

DELETE /api/v1/team-chat/channels/{channelId}/messages/{messageId}/reactions/{emoji}

string

required

—

string

required

—

string

required

—

string (enum: true|false)

cURL

curl -X DELETE "https://api.orbit.devotel.io/api/v1/team-chat/channels/{channelId}/messages/{messageId}/reactions/{emoji}" \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{}'

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/team-chat/channels/{channelId}/messages/{messageId}/reactions/{emoji}', {
  method: 'DELETE',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
})
console.log(await res.json())

{
  "data": [
    {
      "id": "3a4b5c6d-7e8f-4a2f-8b3d-1c4e5f6a7b8c",
      "channel_id": "9f2c1b7a-4d3e-4b8f-9a1c-2e7d5f8b0a41",
      "sender_user_id": "user_2abc3def4ghi5jkl6mnopqr",
      "body": "Supplier contract draft is in the shared drive. @Ada Lovelace please review the liability clause before Friday.",
      "mentions": ["user_2xyz7wvu8tsr9qpo1nmlkjih"],
      "attachments": [],
      "created_at": "2026-08-28T09:16:30.000Z",
      "edited_at": null,
      "reply_count": 0,
      "last_reply_at": null,
      "sender_name": "Grace Hopper",
      "sender_avatar_url": "https://avatar.example.com/grace.png"
    }
  ],
  "meta": {
    "request_id": "req_list_messages",
    "timestamp": "2026-08-28T09:17:00.000Z"
  }
}

Delete a DM thread and all of its messages (participant)

DELETE /api/v1/team-chat/dms/{threadId}

string

required

—

string (enum: true|false)

cURL

curl -X DELETE "https://api.orbit.devotel.io/api/v1/team-chat/dms/{threadId}" \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{}'

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/team-chat/dms/{threadId}', {
  method: 'DELETE',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
})
console.log(await res.json())

{
  "data": [
    {
      "id": "3a4b5c6d-7e8f-4a2f-8b3d-1c4e5f6a7b8c",
      "channel_id": "9f2c1b7a-4d3e-4b8f-9a1c-2e7d5f8b0a41",
      "sender_user_id": "user_2abc3def4ghi5jkl6mnopqr",
      "body": "Supplier contract draft is in the shared drive. @Ada Lovelace please review the liability clause before Friday.",
      "mentions": ["user_2xyz7wvu8tsr9qpo1nmlkjih"],
      "attachments": [],
      "created_at": "2026-08-28T09:16:30.000Z",
      "edited_at": null,
      "reply_count": 0,
      "last_reply_at": null,
      "sender_name": "Grace Hopper",
      "sender_avatar_url": "https://avatar.example.com/grace.png"
    }
  ],
  "meta": {
    "request_id": "req_list_messages",
    "timestamp": "2026-08-28T09:17:00.000Z"
  }
}

Remove your reaction from a DM message

DELETE /api/v1/team-chat/dms/{threadId}/messages/{messageId}/reactions/{emoji}

string

required

—

string

required

—

string

required

—

string (enum: true|false)

cURL

curl -X DELETE "https://api.orbit.devotel.io/api/v1/team-chat/dms/{threadId}/messages/{messageId}/reactions/{emoji}" \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{}'

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/team-chat/dms/{threadId}/messages/{messageId}/reactions/{emoji}', {
  method: 'DELETE',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
})
console.log(await res.json())

{
  "data": [
    {
      "id": "3a4b5c6d-7e8f-4a2f-8b3d-1c4e5f6a7b8c",
      "channel_id": "9f2c1b7a-4d3e-4b8f-9a1c-2e7d5f8b0a41",
      "sender_user_id": "user_2abc3def4ghi5jkl6mnopqr",
      "body": "Supplier contract draft is in the shared drive. @Ada Lovelace please review the liability clause before Friday.",
      "mentions": ["user_2xyz7wvu8tsr9qpo1nmlkjih"],
      "attachments": [],
      "created_at": "2026-08-28T09:16:30.000Z",
      "edited_at": null,
      "reply_count": 0,
      "last_reply_at": null,
      "sender_name": "Grace Hopper",
      "sender_avatar_url": "https://avatar.example.com/grace.png"
    }
  ],
  "meta": {
    "request_id": "req_list_messages",
    "timestamp": "2026-08-28T09:17:00.000Z"
  }
}

Mark the caller offline (graceful disconnect)

DELETE /api/v1/team-chat/presence

string (enum: true|false)

cURL

curl -X DELETE "https://api.orbit.devotel.io/api/v1/team-chat/presence" \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{}'

Node.js

import { Orbit } from '@devotel-orbit/node'

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
})

const res = await fetch('https://api.orbit.devotel.io/api/v1/team-chat/presence', {
  method: 'DELETE',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
})
console.log(await res.json())

{
  "data": [
    {
      "id": "3a4b5c6d-7e8f-4a2f-8b3d-1c4e5f6a7b8c",
      "channel_id": "9f2c1b7a-4d3e-4b8f-9a1c-2e7d5f8b0a41",
      "sender_user_id": "user_2abc3def4ghi5jkl6mnopqr",
      "body": "Supplier contract draft is in the shared drive. @Ada Lovelace please review the liability clause before Friday.",
      "mentions": ["user_2xyz7wvu8tsr9qpo1nmlkjih"],
      "attachments": [],
      "created_at": "2026-08-28T09:16:30.000Z",
      "edited_at": null,
      "reply_count": 0,
      "last_reply_at": null,
      "sender_name": "Grace Hopper",
      "sender_avatar_url": "https://avatar.example.com/grace.png"
    }
  ],
  "meta": {
    "request_id": "req_list_messages",
    "timestamp": "2026-08-28T09:17:00.000Z"
  }
}

​TeamChat API

​title: “TeamChat orientation: worked channel + message round-trip” description: “Create an internal channel, post a message with @-mentions, read the history back with sender identity hydrated, and react to a message — with the full response bodies to copy.”

​The channel and message resources

​Worked sequence: create, post, read back

​1. Create the channel

​2. Post a message with @-mentions

​3. Read the channel history back

​4. React to a message

​Error envelope

​List internal team channels the caller is a member of

​Get the active huddle (if any) for a channel

​List members of a channel

​List channel messages, newest-first

​Load a channel message thread (root + replies)

​Batch reaction summary for channel messages

​List DM threads the caller participates in

​List messages in a DM thread

​Batch reaction summary for DM messages

​Snapshot of online peers (+ last-seen for requested users)

​Full-text search channel messages across the channels you belong to

​Upload a file attachment for team chat

​Create an internal team channel

​Start a huddle in a channel, or drop into the live one

​Leave the channel huddle (ends it when the room empties)

​Add a member to a channel

​Post a message to a channel

​Add a reaction to a channel message

​Reply in-thread to a channel message

​Mark a channel read (advances the caller’s per-channel read cursor)

​Open (get-or-create) a 1:1 DM thread with another user

​Send a message in a DM thread

​Add a reaction to a DM message

​Mark inbound DM messages in a thread as read

​Refresh the caller’s presence (online/away)

​Broadcast a typing indicator to a channel or DM peer

​Edit your own channel message

​Delete a channel and all of its messages (owner only)

​Remove a member from a channel

​Soft-delete a channel message (own message, or any as channel owner/admin)

​Remove your reaction from a channel message

​Delete a DM thread and all of its messages (participant)

​Remove your reaction from a DM message

​Mark the caller offline (graceful disconnect)

TeamChat API

title: “TeamChat orientation: worked channel + message round-trip” description: “Create an internal channel, post a message with @-mentions, read the history back with sender identity hydrated, and react to a message — with the full response bodies to copy.”

The channel and message resources

Worked sequence: create, post, read back

1. Create the channel

2. Post a message with @-mentions

3. Read the channel history back

4. React to a message

Error envelope

List internal team channels the caller is a member of

Get the active huddle (if any) for a channel

List members of a channel

List channel messages, newest-first

Load a channel message thread (root + replies)

Batch reaction summary for channel messages

List DM threads the caller participates in

List messages in a DM thread

Batch reaction summary for DM messages

Snapshot of online peers (+ last-seen for requested users)

Full-text search channel messages across the channels you belong to

Upload a file attachment for team chat

Create an internal team channel

Start a huddle in a channel, or drop into the live one

Leave the channel huddle (ends it when the room empties)

Add a member to a channel

Post a message to a channel

Add a reaction to a channel message

Reply in-thread to a channel message

Mark a channel read (advances the caller’s per-channel read cursor)

Open (get-or-create) a 1:1 DM thread with another user

Send a message in a DM thread

Add a reaction to a DM message

Mark inbound DM messages in a thread as read

Refresh the caller’s presence (online/away)

Broadcast a typing indicator to a channel or DM peer

Edit your own channel message

Delete a channel and all of its messages (owner only)

Remove a member from a channel

Soft-delete a channel message (own message, or any as channel owner/admin)

Remove your reaction from a channel message

Delete a DM thread and all of its messages (participant)

Remove your reaction from a DM message

Mark the caller offline (graceful disconnect)