---
title: "Developers and AI agents | My Tree"
description: "The public My Tree API, Markdown pages, agent skills and WebMCP tools that let apps and AI agents open a tree, see its gifts and leave a message."
url: https://decomytree.link/developers
language: en
last_updated: 2026-10-18
---

Developers

# My Tree for developers and AI agents

Apps, scripts and AI agents can open a tree, see the gifts on it and leave a message for a friend, the same way people do on this site.

## What apps and agents can do

- **Look up a tree** by its 8-character code: its name, its type, the day its messages open and how many gifts it has.
- **See the gifts** on a tree. The messages stay private: only the tree owner can read them.
- **Leave a gift with a message** of up to 500 characters on someone’s tree.
- **Report a tree** or a message that breaks the [Community Guidelines](https://decomytree.link/content-policy).

Creating a tree and reading its messages stay with the tree owner, who signs in with their own email and password at [decomytree.link/create-tree](https://decomytree.link/create-tree).

## API

Base address: `https://api.decomytree.link`. Requests and answers are JSON, and anyone can call the API from any website (CORS is open). Every answer has `success`: the result is in `data`, or `error` says what went wrong. The full description is [openapi.json](https://decomytree.link/openapi.json) (OpenAPI 3.1).

| Request | What it does |
| --- | --- |
| `GET /v1/trees/{code}` | A tree: name, type (`christmas`, `birthday` or `valentine`), the day it opens and its gift count |
| `GET /v1/messages/{code}` | The gifts on a tree, with the names their senders chose to show; the message text stays empty |
| `POST /v1/messages` | Leaves a gift with a message |
| `POST /v1/reports` | Reports a tree or one of its messages for review |
| `GET /v1/status` | Whether My Tree is working right now |

### Leave a message

```
curl -X POST https://api.decomytree.link/v1/messages \
  -H 'Content-Type: application/json' \
  -d '{"shareCode":"ABCD2345","senderName":"Emma","message":"Merry Christmas! 🎄","giftAssetId":"card","showSenderName":true}'
```

- `shareCode`: the tree code, 8 letters and digits, as in a link like `decomytree.link/send-message?tree=ABCD2345`.
- `senderName`: up to 30 characters. The tree owner always sees it; `"showSenderName": false` hides it from other visitors only.
- `message`: up to 500 characters. A word filter turns away offensive words with status 422.
- `giftAssetId`: one of the gift ids listed in [openapi.json](https://decomytree.link/openapi.json), for example `card`, `snow-globe` or `pink-teddy`.

Requests are limited per IP address and per tree (for example 10 messages a minute from one address). Past the limit the API answers with status 429; wait a minute and try again.

## Rules for apps and agents

- Send only messages that the person you act for wrote or approved, to trees whose link they were given.
- No bulk, automated or unsolicited messages, no advertising and nothing the [Community Guidelines](https://decomytree.link/content-policy) forbid.
- Never present a message as coming from someone else.
- Never ask anyone for their My Tree password: tree owners sign in on this website themselves.

## For AI agents

- [llms.txt](https://decomytree.link/llms.txt) explains My Tree in a few lines; [llms-full.txt](https://decomytree.link/llms-full.txt) holds every guide in one file.
- **Markdown pages:** every guide answers `Accept: text/markdown` with Markdown, which is also at the same address ending in `.md`, like [deco-my-tree.md](https://decomytree.link/deco-my-tree.md).
- [API catalog](https://decomytree.link/.well-known/api-catalog) (RFC 9727) and the [OpenAPI description](https://decomytree.link/openapi.json).
- [Agent skills](https://decomytree.link/.well-known/agent-skills/index.json): how to leave a message on a tree and how to help someone create one.
- [AI catalog](https://decomytree.link/.well-known/ai-catalog.json): the skills and the API in one list.
- **WebMCP:** in browsers that support it, the pages offer the tools `open\_tree`, `create\_tree` and `days\_until`, and an agent can fill in the tree-code and message forms; the person still presses Send.

## Contact

Questions or a bigger idea? Write to [mytreeapplink@gmail.com](mailto:mytreeapplink@gmail.com).