Build apps for Amedeus

Developer docs

Build apps your team talks to

Post a message with one request. React to events. Answer slash commands. Everything is signed, versioned and written for people and for AI tools.

Build your first appBrowse the Web API

• curl, Node or Python
• HMAC-signed requests
• Stable v1

curl

curl -X POST "https://amedeus.app/api/public/apps/v1/messages" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"channel": "<channel id>", "text": "Deploy finished :tada:"}'

JavaScript

await fetch("https://amedeus.app/api/public/apps/v1/messages", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.TOKEN}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ channel: "<channel id>", text: "Deploy finished :tada:" }),
});

Python

import json, os, urllib.request

request = urllib.request.Request(
    "https://amedeus.app/api/public/apps/v1/messages",
    data=json.dumps({"channel": "<channel id>", "text": "Deploy finished :tada:"}).encode(),
    headers={
        "Authorization": f"Bearer {os.environ['TOKEN']}",
        "Content-Type": "application/json",
        "User-Agent": "my-app/1.0",
    },
    method="POST",
)
urllib.request.urlopen(request)

↓

🚀

Deploy botAPPnow

Deploy finished 🎉

Find your path

What brings you here?

• Post from a script or a pipeline

  One secret URL and one JSON body. Nothing to install.

• Answer a slash command

  Someone runs /deploy staging. You get a signed request and reply privately or to the channel.

• React to what people write

  Messages, direct messages and mentions, delivered to your URL with a signature.

• Call the Web API

  Post, read, react, list channels and people, with a bot token.

• Fix an error

  Every code the API returns, its status, and what to do about it.

• Coming from Slack

  What carries over, what differs, and what is not here yet.

Templates

Start from something that runs

Small servers with no dependencies, tested against a real workspace. Replace the part that does your work.

• Echo bot

  Repeats what people write to it, in the thread. Start here for anything that answers messages or mentions.

  • message.im
  • app_mention
  • chat:write

  Nodecurl -O https://docs.amedeus.app/templates/echo-bot-node/bot.mjs

  Pythoncurl -O https://docs.amedeus.app/templates/echo-bot-python/bot.py

• Slash command bot

  Answers /deploy staging: checks who may run it, starts the work, replies privately and tells the channel.

  • slash command
  • response_url
  • commands

  Nodecurl -O https://docs.amedeus.app/templates/slash-command-node/bot.mjs

  Pythoncurl -O https://docs.amedeus.app/templates/slash-command-python/bot.py

See the full code of every template →

Incoming webhooks

Send anything to Amedeus

A secret URL, one JSON body, no token and no code to host. Tools that already notify Slack can point at it: the body is the same, including Slack's attachments.

Create a webhook →

curl -X POST "https://amedeus.app/api/public/apps/hooks/<secret>" \
  -H "Content-Type: application/json" \
  -d '{"text": "Build passed ✅"}'

For coding agents

Docs your agent can read

This site is built for machines too. Point your agent at it, or paste the instruction below into CLAUDE.md, AGENTS.md or your editor's rules.

• Start from the indexEvery page, grouped, with a line about each.
  https://docs.amedeus.app/llms.txt
• Any page as MarkdownAdd .md to the URL of a page.
  https://docs.amedeus.app/guides/events.md
• The whole site in one fileFor a model with a long context.
  https://docs.amedeus.app/llms-full.txt
• The API, machine-readableOpenAPI 3.1, generated from the code.
  https://docs.amedeus.app/openapi.json

When building an Amedeus app, start from https://docs.amedeus.app/llms.txt and read pages as Markdown (add .md to their URL).

Copy the instruction