Skill

Membuat skill dan menugaskannya ke bot. 11 endpoint

GET /skills

/api/v1/skills · Perlu sesi login

Contoh

curl -X GET 'https://api.lexcetha.com/api/v1/skills' \
  -H "Authorization: Bearer $LEX_TOKEN"

POST /bots/{botId}/skills/new

/api/v1/bots/{botId}/skills/new · Perlu sesi login

Parameter

Field	Tipe	Wajib	Catatan
botId (path)	string	ya

Body permintaan

Field	Tipe	Wajib	Catatan
name	string	ya	panjang 1–80
description	string		panjang 0–500
instructions	string	ya	panjang 1–20000

Contoh

curl -X POST 'https://api.lexcetha.com/api/v1/bots/:botId/skills/new' \
  -H "Authorization: Bearer $LEX_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"name":"string","instructions":"string"}'

POST /skills/{skillId}/revise

/api/v1/skills/{skillId}/revise · Perlu sesi login

Parameter

Field	Tipe	Wajib	Catatan
skillId (path)	string	ya

Body permintaan

Field	Tipe	Wajib	Catatan
name	string		panjang 1–80
description	string		panjang 0–500
instructions	string	ya	panjang 1–20000

Contoh

curl -X POST 'https://api.lexcetha.com/api/v1/skills/:skillId/revise' \
  -H "Authorization: Bearer $LEX_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"instructions":"string"}'

PATCH /skills/{skillId}/sharing

/api/v1/skills/{skillId}/sharing · Perlu sesi login

Parameter

Field	Tipe	Wajib	Catatan
skillId (path)	string	ya

Body permintaan

Field	Tipe	Wajib	Catatan
shared	boolean	ya

Contoh

curl -X PATCH 'https://api.lexcetha.com/api/v1/skills/:skillId/sharing' \
  -H "Authorization: Bearer $LEX_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"shared":true}'

GET /skills/{skillId}

/api/v1/skills/{skillId} · Perlu sesi login

Parameter

Field	Tipe	Wajib	Catatan
skillId (path)	string	ya

Contoh

curl -X GET 'https://api.lexcetha.com/api/v1/skills/:skillId' \
  -H "Authorization: Bearer $LEX_TOKEN"

PATCH /skills/{skillId}

/api/v1/skills/{skillId} · Perlu sesi login

Parameter

Field	Tipe	Wajib	Catatan
skillId (path)	string	ya

Body permintaan

Field	Tipe	Wajib	Catatan
status	"published" | "disabled"	ya

Contoh

curl -X PATCH 'https://api.lexcetha.com/api/v1/skills/:skillId' \
  -H "Authorization: Bearer $LEX_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"status":"published"}'

POST /skills/{skillId}/versions

/api/v1/skills/{skillId}/versions · Perlu sesi login

Parameter

Field	Tipe	Wajib	Catatan
skillId (path)	string	ya

Body permintaan

Field	Tipe	Wajib	Catatan
version	string	ya	pola ^\d+\.\d+\.\d+(-[0-9A-Za-z.-]+)?$
instructions	string	ya	panjang 1–20000
inputSchema	record<string, any>
outputSchema	record<string, any>
requiredCapabilities	string[]	ya	maks 20 item · bawaan []
compatibility	string		panjang 0–50

Contoh

curl -X POST 'https://api.lexcetha.com/api/v1/skills/:skillId/versions' \
  -H "Authorization: Bearer $LEX_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"version":"string","instructions":"string","requiredCapabilities":[]}'

POST /skills/{skillId}/versions/{versionId}/publish

/api/v1/skills/{skillId}/versions/{versionId}/publish · Perlu sesi login

Parameter

Field	Tipe	Wajib	Catatan
skillId (path)	string	ya
versionId (path)	string	ya

Contoh

curl -X POST 'https://api.lexcetha.com/api/v1/skills/:skillId/versions/:versionId/publish' \
  -H "Authorization: Bearer $LEX_TOKEN"

GET /bots/{botId}/skills

/api/v1/bots/{botId}/skills · Perlu sesi login

Parameter

Field	Tipe	Wajib	Catatan
botId (path)	string	ya

Contoh

curl -X GET 'https://api.lexcetha.com/api/v1/bots/:botId/skills' \
  -H "Authorization: Bearer $LEX_TOKEN"

POST /bots/{botId}/skills

/api/v1/bots/{botId}/skills · Perlu sesi login

Parameter

Field	Tipe	Wajib	Catatan
botId (path)	string	ya

Body permintaan

Field	Tipe	Wajib	Catatan
skillVersionId	string	ya	panjang 1–∞

Contoh

curl -X POST 'https://api.lexcetha.com/api/v1/bots/:botId/skills' \
  -H "Authorization: Bearer $LEX_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"skillVersionId":"string"}'

DELETE /bots/{botId}/skills/{assignmentId}

/api/v1/bots/{botId}/skills/{assignmentId} · Perlu sesi login

Parameter

Field	Tipe	Wajib	Catatan
botId (path)	string	ya
assignmentId (path)	string	ya

Contoh

curl -X DELETE 'https://api.lexcetha.com/api/v1/bots/:botId/skills/:assignmentId' \
  -H "Authorization: Bearer $LEX_TOKEN"