Organisations-Skill aktualisieren

Mit einer angegebenen skill_id lässt sich der Skill einer bestimmten Organisation aktualisieren; nach Abschluss der Aktualisierung erfolgt die Veröffentlichung automatisch.

Anfragemethode

POST

Anfrage-URL

https://api.${endpoint}/v1/org/skill/update

Authentifizierung der Anfrage

HTTP-Basic-Authentifizierung mit DevKey und DevSecret des Organisationskontos. Das aufrufende Konto muss über die Berechtigung zur Skill-Verwaltung der Zielorganisation verfügen.

Beispielanfrage

curl -X POST 'https://api.${endpoint}/v1/org/skill/update' \ -H 'Authorization: Basic ${BASIC_TOKEN}' \ -F 'org_id=org-xxxx' \ -F 'skill_id=skill-xxxx' \ -F 'file=@/path/to/refund-policy-v2.skill' \ -F 'category_id=category-xxxx'

                      
                      curl -X POST 'https://api.${endpoint}/v1/org/skill/update' \
  -H 'Authorization: Basic ${BASIC_TOKEN}' \
  -F 'org_id=org-xxxx' \
  -F 'skill_id=skill-xxxx' \
  -F 'file=@/path/to/refund-policy-v2.skill' \
  -F 'category_id=category-xxxx'

Dieser Codeblock im schwebenden Fenster

Form-Data-Parameter

Parameter	Typ	Erforderlich	Beschreibung
`skill_id`	String	Ja	ID des zu aktualisierenden geteilten Organisations-Skill.
`org_id`	String	Ja	ID der Organisation, zu der der Skill gehört; muss mit dem Ziel-Skill übereinstimmen.
`file`	File	Ja	`.skill`- oder `.zip`-Skill-Paket.
`category_id`	String	Nein	Kategorie-ID nach der Aktualisierung; bei fehlender Angabe wird die ursprüngliche Kategorie beibehalten.

Erfolgreiche Antwort

{ "code": 0, "message": "OK", "data": { "skill_id": "skill-xxxx", "name": "refund_policy", "owner_type": "ORGANIZATION" } }

                      
                      {
  "code": 0,
  "message": "OK",
  "data": {
    "skill_id": "skill-xxxx",
    "name": "refund_policy",
    "owner_type": "ORGANIZATION"
  }
}

Dieser Codeblock im schwebenden Fenster

Feld	Beschreibung
`skill_id`	ID des aktualisierten geteilten Organisations-Skill.
`name`	Der `name` aus dem Frontmatter von `SKILL.md` in diesem Skill-Paket.
`owner_type`	Fest auf `ORGANIZATION` gesetzt.

Aufrufgrenzen

Es werden nur geteilte Skill mit owner_type=ORGANIZATION aktualisiert, die nicht an einen Agent gebunden sind.
Private Agent-Skill, historische private Datensätze mit bot_id sowie SYSTEM-Skill werden abgelehnt.
Es werden nur .skill und .zip akzeptiert; das Archiv darf maximal 20 MiB groß sein und muss SKILL.md enthalten, dessen Frontmatter name enthalten muss.
POST /v1/org/skill/import dient ausschließlich dem Erstellen von Organisations-Skill und übernimmt keine Aktualisierungssemantik.