Actualizar Skill de organización

Mediante el skill_id indicado se puede actualizar el Skill de una organización específica; una vez completada la actualización, la publicación se realiza automáticamente.

Método de solicitud

POST

URL de la solicitud

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

Autenticación de la solicitud

Utiliza la autenticación HTTP Basic con la DevKey y la DevSecret de la cuenta de la organización. La cuenta que realiza la llamada debe tener permiso de gestión de Skill de la organización de destino.

Ejemplo de solicitud

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'

Este bloque de código en una ventana flotante

Parámetros de Form Data

Parámetro	Tipo	Obligatorio	Descripción
`skill_id`	String	Sí	ID del Skill compartido de la organización que se desea actualizar.
`org_id`	String	Sí	ID de la organización a la que pertenece el Skill; debe coincidir con el del Skill de destino.
`file`	File	Sí	Paquete de habilidad `.skill` o `.zip`.
`category_id`	String	No	ID de la categoría tras la actualización; si no se indica, se mantiene la categoría original.

Respuesta correcta

{ "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"
  }
}

Este bloque de código en una ventana flotante

Campo	Descripción
`skill_id`	ID del Skill compartido de la organización que se ha actualizado.
`name`	El `name` del frontmatter de `SKILL.md` de este paquete de habilidad.
`owner_type`	Fijo en `ORGANIZATION`.

Límites de la llamada

Solo actualiza Skill compartidos con owner_type=ORGANIZATION que no estén vinculados a ningún Agent.
Se rechazan los Skill privados de Agent, los registros privados históricos con bot_id y los Skill de tipo SYSTEM.
Solo se aceptan .skill y .zip; el paquete comprimido tiene un tamaño máximo de 20 MiB, debe contener SKILL.md, y su frontmatter debe incluir name.
POST /v1/org/skill/import solo se utiliza para crear Skill de la organización y no asume la semántica de actualización.