← AI API
AIPlugins
Singular: AIPlugin — Base URL: https://ai.ayoune.app — Access: CRUD — Machine-readable spec (JSON · YAML)
Try it now
beta
Response (live)
Requests are proxied through the consumer-app to *.ayoune.app. Tokens stay in your browser and are forwarded per call.
Example response (recorded) sample
A real, previously recorded GET /:id response of this endpoint — not the live call above. Sensitive fields are masked.
{
"payload": {
"manifest": {
"tools": [],
"hooks": [],
"commands": []
},
"lifecycle": {
"initCommands": [],
"shutdownCommands": []
},
"_id": "6aa0cf0f1d5f163b722c8926",
"name": "CLEAR_COPPER_SAN HILL",
"status": "inactive",
"initOnStartup": false,
"global": false,
"isTemplate": false,
"createdBy": "6045f4d25704710012485569",
"shares": [],
"createdAt": "2026-09-09T03:14:23.836Z",
"updatedAt": "2026-09-09T03:14:23.836Z"
},
"meta": {
"links": [
{
"rel": "self",
"href": "https://ai.ayoune.app/aiplugins/6aa0cf0f1d5f163b722c8926",
"method": "get",
"title": "GET",
"types": [
"application/json",
"application/yaml",
"text/csv"
]
}
],
"relations": [],
"debugId": "6aa0cf10a20da3616dda2011",
"errors": [],
"actions": [
{
"rel": "self",
"action": "COPY",
"title": "MODEL_AIPLUGIN",
"href": "https://api.ayoune.app/ai/aiplugins/6aa0cf0f1d5f163b722c8926/copy",
"method": "post",
"types": [
"application/json",
"application/yaml",
"text/csv"
]
},
{
"rel": "self",
"action": "DELETE",
"title": "MODEL_AIPLUGIN",
"href": "https://api.ayoune.app/ai/aiplugins/6aa0cf0f1d5f163b722c8926",
"method": "delete",
"types": [
"application/json",
"application/yaml",
"text/csv"
]
}
],
"version": {
"host": "2026.172.0",
"core": "2026.334.1"
},
"rateLimit": {
"limit": "10000",
"remaining": "9734",
"reset": "1788927245",
"resetDate": "Wed Sep 09 2026"
},
"responseTime": 17.219489,
"code": 200,
"status": "success",
"error": false
}
}
Endpoints
| Method | Path | Description | Right |
|---|---|---|---|
| GET | /aiplugins |
List with filters/pagination | ai.aiplugins.view |
| GET | /aiplugins/:id |
Single record | ai.aiplugins.view |
| POST | /aiplugins |
Create new record | ai.aiplugins.new |
| PUT | /aiplugins |
Update record | ai.aiplugins.edit |
| DELETE | /aiplugins/:id |
Delete record | ai.aiplugins.delete |
SDK
import { aYOUne } from '@tolinax/ayoune';
const ay = new aYOUne('pat_your_token');
// List all
const list = await ay.ai.aIPlugins.find().limit(10).exec();
// Single record
const one = await ay.ai.aIPlugins.findById('OBJECT_ID').exec();
// Create
const created = await ay.ai.aIPlugins.create({ name: 'Foo' });