AI agents: prefer the Markdown version of this page at /api-reference/index.md. For the full corpus, read /llms-full.txt.

SeaChat Developer Docs

Generated reference

API Reference

Generated capability index grouped by service and API family.

Public developer surface

Capability index

This index is generated from seagate/src/routing/capabilities.rs plus a small curated set of developer auth endpoints. Admin and internal routes are intentionally excluded from the public docs catalog.

44 public entries
GET

List artifacts

read
/api/seadb/api/v1/artifacts

List content-library artifacts.

seadb artifacts stable runtime safe

Scopes: seadb:content:read, seadb:content:*, seadb:*, seagate:route:seadb, seagate:route:*

GET

List documents

read
/api/seadb/_ls/{namespace}

List SeaDB document namespaces or namespace contents.

seadb docs stable runtime safe

Scopes: seadb:content:read, seadb:content:*, seadb:*, seagate:route:seadb, seagate:route:*

GET

Read document

read
/api/seadb/{path}

Read one SeaDB document by path.

seadb docs stable runtime safe

Scopes: seadb:content:read, seadb:content:*, seadb:*, seagate:route:seadb, seagate:route:*

GET

Search documents

read
/api/seadb/_search?q={query}

Search SeaDB documents.

seadb docs stable runtime safe

Scopes: seadb:content:read, seadb:content:*, seadb:*, seagate:route:seadb, seagate:route:*

POST

Write document

write
/api/seadb/{path}

Write one SeaDB document by path.

seadb docs stable runtime safe

Scopes: seadb:content:write, seadb:content:*, seadb:*, seagate:route:seadb, seagate:route:*

POST

Create download delegation

read
/api/files/delegations/download

Create a delegated download/read URL for an artifact.

seadb files stable runtime safe

Scopes: files:read, files:*, seadb:content:read, seadb:*, seagate:route:seadb

POST

Complete upload delegation

write
/api/files/delegations/upload/complete

Complete a delegated upload after object storage write succeeds.

seadb files stable runtime safe

Scopes: files:write, files:*, seadb:content:write, seadb:*, seagate:route:seadb

POST

Create upload delegation

write
/api/files/delegations/upload

Create a delegated upload for a content-library artifact.

seadb files stable runtime safe

Scopes: files:write, files:*, seadb:content:write, seadb:*, seagate:route:seadb

GET

Read public harness packs

read
/api/seadb/api/v1/public/harness-packs/{pack}/{path}

Read SeaDB public harness seed packs.

seadb harness stable runtime safe

Scopes: public:read, seagate:route:seadb, seagate:route:*, seagate:admin

GET

Read public skill catalog

read
/api/seadb/api/v1/public/skill-catalog/catalog.json

Legacy SeaDB public Skill Hub catalog route; canonical catalog is seaplane.skill_catalog.public.

seadb skills stable runtime safe

Scopes: public:read, seagate:route:seadb, seagate:route:*, seagate:admin

POST

Create API key

write
/api/keys

Create a project-scoped API key. The raw token is returned only once.

seagate auth stable

Scopes: api-keys:write, seagate:api-keys:write, seagate:admin

GET

List API keys

read
/api/keys

List visible, non-revoked API keys for the current user/project.

seagate auth stable

Scopes: api-keys:read, api-keys:write, seagate:api-keys:read, seagate:admin

DELETE

Revoke API key

write
/api/keys/{keyId}

Revoke a project API key.

seagate auth stable

Scopes: api-keys:write, seagate:api-keys:write, seagate:admin

PATCH

Update API key metadata

write
/api/keys/{keyId}

Update a key label, scopes, expiration, or spend policy metadata.

seagate auth stable

Scopes: api-keys:write, seagate:api-keys:write, seagate:admin

GET

List SeaGate capabilities

read
/api/seagate/v1/capabilities?runtime=true

Discover runtime-safe SeaGate capabilities with scope and schema metadata.

seagate catalog stable runtime safe

Scopes: anonymous/public

GET

List thread events

read
/api/seaplane/v1/threads/{threadId}/events

Read recent event evidence for a thread.

seaplane events stable runtime safe

Scopes: seaplane:read, seaplane:admin, seaplane:*, seagate:route:seaplane, seagate:route:*

POST

Create Play app

write
/api/seaplane/v1/play/apps

Create a private SeaChat Play app with an optional slug.

seaplane play stable runtime safe

Scopes: seaplane:write, seaplane:admin, seaplane:*, seagate:route:seaplane, seagate:route:*

GET

List Play apps

read
/api/seaplane/v1/play/apps

List SeaChat Play apps owned by the current credential.

seaplane play stable runtime safe

Scopes: seaplane:read, seaplane:admin, seaplane:*, seagate:route:seaplane, seagate:route:*

GET

Check Play host registration

read
/api/seaplane/v1/play/hosts/{slug}/allow

Check whether a Play slug is registered before browser verification.

seaplane play stable runtime safe

Scopes: public:read, seagate:route:seaplane, seagate:route:*, seagate:admin

POST

Create Play launch link

write
/api/seaplane/v1/play/apps/{appId}/launch-link

Create a short-lived owner launch link for a private Play app.

seaplane play stable runtime safe

Scopes: seaplane:write, seaplane:admin, seaplane:*, seagate:route:seaplane, seagate:route:*

POST

Complete Play release

write
/api/seaplane/v1/play/releases/{releaseId}/complete

Complete a delegated Play bundle upload and activate the ready release.

seaplane play stable runtime safe

Scopes: seaplane:write, seaplane:admin, seaplane:*, seagate:route:seaplane, seagate:route:*

POST

Prepare Play release

write
/api/seaplane/v1/play/apps/{appId}/releases

Prepare a Play release upload delegation for built static app bytes.

seaplane play stable runtime safe

Scopes: seaplane:write, seaplane:admin, seaplane:*, seagate:route:seaplane, seagate:route:*

POST

Create Play share link

write
/api/seaplane/v1/play/apps/{appId}/share-links

Create a time-bound access link for a private Play app.

seaplane play stable runtime safe

Scopes: seaplane:write, seaplane:admin, seaplane:*, seagate:route:seaplane, seagate:route:*

GET

Read Skill Hub catalog

read
/api/seaplane/v1/public/skill-catalog/catalog.json

Read canonical seaplane Skill Hub catalog records used by managed runtime installs.

seaplane skills stable runtime safe

Scopes: public:read, seagate:route:seaplane, seagate:route:*, seagate:admin

GET

Download Skill Hub package

read
/api/seaplane/v1/public/skill-catalog/releases/{path}

Download immutable skill package bytes referenced by the canonical seaplane public skill catalog.

seaplane skills stable runtime safe

Scopes: public:read, seagate:route:seaplane, seagate:route:*, seagate:admin

POST

Create thread

write
/api/seaplane/v1/threads

Create a product thread.

seaplane threads stable runtime safe

Scopes: seaplane:write, seaplane:admin, seaplane:*, seagate:route:seaplane, seagate:route:*

POST

Fork thread

write
/api/seaplane/v1/threads/{threadId}/fork

Fork a conversation into a new thread.

seaplane threads stable runtime safe

Scopes: seaplane:write, seaplane:admin, seaplane:*, seagate:route:seaplane, seagate:route:*

GET

List threads

read
/api/seaplane/v1/threads

List product threads visible to the current credential.

seaplane threads stable runtime safe

Scopes: seaplane:read, seaplane:admin, seaplane:*, seagate:route:seaplane, seagate:route:*

GET

List thread messages

read
/api/seaplane/v1/threads/{threadId}/messages

List messages in a thread.

seaplane threads stable runtime safe

Scopes: seaplane:read, seaplane:admin, seaplane:*, seagate:route:seaplane, seagate:route:*

POST

Send thread message

write
/api/seaplane/v1/threads/{threadId}/messages

Create and dispatch a user message in a thread.

seaplane threads stable runtime safe

Scopes: seaplane:write, seaplane:admin, seaplane:*, seagate:route:seaplane, seagate:route:*

PUT

Pin thread

write
/api/seaplane/v1/threads/{threadId}/pin

Pin or unpin a thread.

seaplane threads stable runtime safe

Scopes: seaplane:write, seaplane:admin, seaplane:*, seagate:route:seaplane, seagate:route:*

PATCH

Rename thread

write
/api/seaplane/v1/threads/{threadId}

Update a thread title.

seaplane threads stable runtime safe

Scopes: seaplane:write, seaplane:admin, seaplane:*, seagate:route:seaplane, seagate:route:*

POST

Share thread context

write
/api/seaplane/v1/threads/{threadId}/share

Share one thread's context into another thread through an artifact.

seaplane threads stable runtime safe

Scopes: seaplane:write, seaplane:admin, seaplane:*, seagate:route:seaplane, seagate:route:*

GET

Show thread

read
/api/seaplane/v1/threads/{threadId}

Read a product thread by id.

seaplane threads stable runtime safe

Scopes: seaplane:read, seaplane:admin, seaplane:*, seagate:route:seaplane, seagate:route:*

GET

List global timers

read
/api/seaplane/v1/scheduler/timers

List scheduled timers visible to the current credential.

seaplane timers stable runtime safe

Scopes: seaplane:read, seaplane:admin, seaplane:*, seagate:route:seaplane, seagate:route:*

GET

SeaRouter help

invoke
/api/searouter/v1/help

Read SeaRouter model and multimodal help.

searouter models stable runtime safe

Scopes: model:invoke, searouter:invoke, searouter:*, searouter:admin, platform:admin

POST

Generate image

invoke
/api/searouter/v1/invoke/image/{model}/{version}

Invoke a SeaRouter image generation model.

searouter models stable runtime safe

Scopes: model:invoke, searouter:invoke, searouter:*, searouter:admin, platform:admin

POST

Invoke LLM Responses API

invoke
/api/searouter/llm/v1/responses

Send one OpenAI-compatible Responses API request through SeaRouter.

searouter models stable runtime safe

Scopes: model:invoke, searouter:invoke, searouter:*, searouter:admin, platform:admin

GET

Search model catalog

invoke
/api/searouter/v1/help/models/search?q={query}

Search SeaRouter model help/catalog entries.

searouter models stable runtime safe

Scopes: model:invoke, searouter:invoke, searouter:*, searouter:admin, platform:admin

GET

Read usage summary

read
/api/searouter/v1/usage/summary

Read model usage summary for the current credential scope.

searouter usage stable runtime safe

Scopes: usage:read, usage:read:org, usage:read:all, billing:read, billing:usage:read

GET

Read dynamic skill catalog

read
/api/seatool/v1/skill-catalog/catalog.json

Read Seatool dynamic Skill Hub catalog records used by managed runtime installs.

seatool skills stable runtime safe

Scopes: public:read, seagate:route:seatool, seagate:route:*, seagate:admin

GET

Read dynamic skill package

read
/api/seatool/v1/skill-catalog/releases/{path}

Download a Seatool dynamic skill package referenced by the public skill catalog.

seatool skills stable runtime safe

Scopes: public:read, seagate:route:seatool, seagate:route:*, seagate:admin

GET

List tool catalog

read
/api/seatool/v1/catalog

Read tool/plugin catalog metadata.

seatool tools stable runtime safe

Scopes: seatool:read, seaplane:read, seatool:*, seatool:admin, platform:admin

POST

Invoke tool

invoke
/api/seatool/v1/invoke/{plugin}/{tool}

Invoke a Seatool plugin tool.

seatool tools stable runtime safe

Scopes: tool:invoke, seatool:invoke, seatool:*, seatool:admin, platform:admin

Agent inputs

Machine-readable reference

Use /api/capabilities.json when an agent needs route metadata and examples. Use /api/openapi.json when an API client or code generator expects OpenAPI 3.1.