Awesome-omni-skill backend-api

Manage items, projects, and references in Senticor Project via REST API

install

source · Clone the upstream repo

git clone https://github.com/diegosouzapw/awesome-omni-skill

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/diegosouzapw/awesome-omni-skill "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/development/backend-api" ~/.claude/skills/diegosouzapw-awesome-omni-skill-backend-api-bb4bc6 && rm -rf "$T"

manifest: skills/development/backend-api/SKILL.md

source content

Backend API for Senticor Project

Du hast vollen Zugriff auf die Senticor Project Backend-API. Verwende

exec

mit

curl

, um Items zu lesen, erstellen und aktualisieren.

Authentifizierung

Der aktuelle Token liegt in

/runtime/token

. Verwende ihn so in jedem Request:

Authorization: Bearer $(cat /runtime/token)

Die Backend-URL liegt in der Umgebungsvariable

COPILOT_BACKEND_URL

. Weitere Umgebungsvariablen:

```
COPILOT_FRONTEND_URL
```
— Frontend-URL (z.B. fuer Kontext)
```
COPILOT_STORYBOOK_URL
```
— Storybook mit Produkt-, Design- und Engineering-Dokumentation

Umgebung erkennen

Pruefe deine Umgebungsvariablen:

exec echo "Backend: $COPILOT_BACKEND_URL | Frontend: $COPILOT_FRONTEND_URL | Storybook: $COPILOT_STORYBOOK_URL"

API-Dokumentation entdecken

Die vollstaendige OpenAPI-Spezifikation ist verfuegbar unter:

exec curl -s "$COPILOT_BACKEND_URL/openapi.json" | head -c 5000

Verwende sie, um alle verfuegbaren Endpoints, Parameter und Modelle zu entdecken. Wichtige Pfade:

/items

/items/sync

/items/{item_id}

/files

/search

/imports/nirvana/*

/imports/native/*

/imports/jobs

/email/*

/calendar/*

Fuer Import/Export-Details: Lies

/workspace/skills/import-export/SKILL.md

. Fuer E-Mail/Kalender-Details: Lies

/workspace/skills/email-calendar/SKILL.md

Storybook (Produktdokumentation)

Das Storybook enthaelt die gesamte Produkt-, Design- und Engineering-Dokumentation:

exec curl -s "$COPILOT_STORYBOOK_URL/index.json" | head -c 3000

Dort findest du Informationen zu:

Produktvision und Methodik
Design-System und Paperclip-Prinzipien
Datenmodell und Architektur
Verfuegbare UI-Komponenten

Items lesen

exec curl -s "$COPILOT_BACKEND_URL/items?limit=200" \
  -H "Authorization: Bearer $(cat /runtime/token)"

Antwort: Array von Items mit

item_id

canonical_id

item

(JSON-LD mit

name

@type

additionalProperty

Den Bucket findest du in

item.additionalProperty

unter

propertyID: "app:bucket"

Einzelnes Item:

exec curl -s "$COPILOT_BACKEND_URL/items/<item_id>" \
  -H "Authorization: Bearer $(cat /runtime/token)"

Item aktualisieren (Bucket aendern, umbenennen)

exec curl -s -X PATCH "$COPILOT_BACKEND_URL/items/<item_id>" \
  -H "Authorization: Bearer $(cat /runtime/token)" \
  -H "Content-Type: application/json" \
  -H "X-Agent: openclaw" \
  -d '{
    "source": "openclaw",
    "item": {
      "additionalProperty": [
        {"@type": "PropertyValue", "propertyID": "app:bucket", "value": "next"}
      ]
    }
  }'

Gueltige Buckets:

inbox

next

waiting

calendar

someday

reference

Name aendern:

exec curl -s -X PATCH "$COPILOT_BACKEND_URL/items/<item_id>" \
  -H "Authorization: Bearer $(cat /runtime/token)" \
  -H "Content-Type: application/json" \
  -H "X-Agent: openclaw" \
  -d '{
    "source": "openclaw",
    "item": {
      "name": "Neuer Name"
    }
  }'

Wichtig: Payload-Format fuer neue Items

Alle POST-Requests an

/items

erwarten dieses Format:

{
  "source": "openclaw",
  "item": { ... JSON-LD ... }
}

Jedes Item braucht eine

@id

als URN. Erzeuge sie mit UUID:

Aktionen:
```
urn:app:action:<uuid>
```
Referenzen:
```
urn:app:reference:<uuid>
```
Projekte:
```
urn:app:project:<uuid>
```

Verwende

$(cat /proc/sys/kernel/random/uuid)

fuer UUIDs.

Aktion erstellen

exec curl -s -X POST "$COPILOT_BACKEND_URL/items" \
  -H "Authorization: Bearer $(cat /runtime/token)" \
  -H "Content-Type: application/json" \
  -H "X-Agent: openclaw" \
  -d '{
    "source": "openclaw",
    "item": {
      "@id": "urn:app:action:'"$(cat /proc/sys/kernel/random/uuid)"'",
      "@type": "Action",
      "_schemaVersion": 2,
      "name": "Aktion-Name",
      "additionalProperty": [
        {"@type": "PropertyValue", "propertyID": "app:bucket", "value": "next"},
        {"@type": "PropertyValue", "propertyID": "app:rawCapture", "value": "Aktion-Name"}
      ]
    }
  }'

Gueltige Buckets:

inbox

next

waiting

calendar

someday

Referenz erstellen

exec curl -s -X POST "$COPILOT_BACKEND_URL/items" \
  -H "Authorization: Bearer $(cat /runtime/token)" \
  -H "Content-Type: application/json" \
  -H "X-Agent: openclaw" \
  -d '{
    "source": "openclaw",
    "item": {
      "@id": "urn:app:reference:'"$(cat /proc/sys/kernel/random/uuid)"'",
      "@type": "CreativeWork",
      "_schemaVersion": 2,
      "name": "Referenz-Name",
      "description": "Optionale Beschreibung",
      "additionalProperty": [
        {"@type": "PropertyValue", "propertyID": "app:bucket", "value": "reference"}
      ]
    }
  }'

Projekt erstellen (Projekt + Aktionen)

Erstelle zuerst das Projekt, dann die Aktionen mit

app:projectRefs

# 1. Projekt erstellen
exec curl -s -X POST "$COPILOT_BACKEND_URL/items" \
  -H "Authorization: Bearer $(cat /runtime/token)" \
  -H "Content-Type: application/json" \
  -H "X-Agent: openclaw" \
  -d '{
    "source": "openclaw",
    "item": {
      "@id": "urn:app:project:'"$(cat /proc/sys/kernel/random/uuid)"'",
      "@type": "Project",
      "_schemaVersion": 2,
      "name": "Projekt-Name",
      "additionalProperty": [
        {"@type": "PropertyValue", "propertyID": "app:bucket", "value": "project"},
        {"@type": "PropertyValue", "propertyID": "app:desiredOutcome", "value": "Gewuenschtes Ergebnis"},
        {"@type": "PropertyValue", "propertyID": "app:projectStatus", "value": "active"}
      ]
    }
  }'

# 2. canonical_id aus der Antwort notieren, dann Aktionen erstellen:
exec curl -s -X POST "$COPILOT_BACKEND_URL/items" \
  -H "Authorization: Bearer $(cat /runtime/token)" \
  -H "Content-Type: application/json" \
  -H "X-Agent: openclaw" \
  -d '{
    "source": "openclaw",
    "item": {
      "@id": "urn:app:action:'"$(cat /proc/sys/kernel/random/uuid)"'",
      "@type": "Action",
      "_schemaVersion": 2,
      "name": "Schritt 1",
      "additionalProperty": [
        {"@type": "PropertyValue", "propertyID": "app:bucket", "value": "next"},
        {"@type": "PropertyValue", "propertyID": "app:rawCapture", "value": "Schritt 1"},
        {"@type": "PropertyValue", "propertyID": "app:projectRefs", "value": ["<canonical_id_from_project>"]}
      ]
    }
  }'

Antwortformat

Erfolgreiche Erstellung liefert:

{
  "item_id": "uuid",
  "canonical_id": "urn:app:...",
  "source": "openclaw",
  "item": { ... },
  "created_at": "...",
  "updated_at": "..."
}