Global_Skills

You need the Manage skills permission to manage skills.

Global_Agents_Skills
- Global_Agents_Skills Manage
GET global/skills/{id}
POST global/skills
PUT global/skills/{id}
DELETE global/skills/{id}
Model
Global_Skills JSON Format

Global_Skills is represented as simple flat JSON objects with the following keys:

Name Type Description
name string Name of the skill
id guid Id of the skill
description string Description of the skill
agentIds array Id of the agents master this skill.
Endpoint
Get the list of Global_Agents_Skills

GET global/skills

Parameters:
Name Type In Required Description
keywords string query no Filter by keywords in name of the skill.
include string query no Allowed value is "agent".
Response:

An array of   Global_Skills

Example

Sample Request:

curl https://api15.comm100.io/v4/global/skills \
-X 'GET' \
-H 'Authorization: Bearer {access_token}' \

Response:

 HTTP/1.1 200 OK

[{"name":"English","id":"AB743060-4735-4E26-9B57-24AD469EC12A","description":"Speak,Listen,Write English","agentIds":["57561598-BE6E-43C8-9865-CB2F23C862DC"]}]
Get a single Global_Skills

GET global/skills/{id}

Parameters:
Name Type In Required Description
include string query no Allowed value is "agent".
Response:
Example

Sample Request:

curl https://api15.comm100.io/v4/global/skills/AB743060-4735-4E26-9B57-24AD469EC12A \
-X 'GET' \
-H 'Authorization: Bearer {access_token}' \

Response:

 HTTP/1.1 200 OK

{"name":"English","id":"AB743060-4735-4E26-9B57-24AD469EC12A","description":"Speak,Listen,Write English","agentIds":["57561598-BE6E-43C8-9865-CB2F23C862DC"]}
Create a new Global_Skills

POST global/skills

Parameters:
Name Type In Required Description
name string body yes Name of the skill
description string body no Description of the skill
agentIds array body no Id of the agents master this skill.
Response:
Example

Sample Request:

curl https://api15.comm100.io/v4/global/skills \
-X 'POST' \
-H 'Authorization: Bearer {access_token}' \
-H 'Content-Type: application/json' \
-D '{"name":"English","description":"Speak,Listen,Write English"}'

Response:

 HTTP/1.1 201 Created

{"name":"English","id":"AB743060-4735-4E26-9B57-24AD469EC12A","description":"Speak,Listen,Write English","agentIds":["57561598-BE6E-43C8-9865-CB2F23C862DC"]}
Update the Global_Skills

PUT global/skills/{id}

Parameters:
Name Type In Required Description
name string body yes Name of the skill
description string body no Description of the skill
agentIds array body no Id of the agents master this skill.
Response:
Example

Sample Request:

curl https://api15.comm100.io/v4/global/skills/AB743060-4735-4E26-9B57-24AD469EC12A \
-X 'PUT' \
-H 'Authorization: Bearer {access_token}' \
-H 'Content-Type: application/json' \
-D '{"name":"English","description":"Speak,Listen,Write English"}'

Response:

 HTTP/1.1 200 OK

{"name":"English","id":"AB743060-4735-4E26-9B57-24AD469EC12A","description":"Speak,Listen,Write English","agentIds":["57561598-BE6E-43C8-9865-CB2F23C862DC"]}
Remove the Global_Skills

DELETE global/skills/{id}

Parameters:
No Parameters
Response:

No Content

Example

Sample Request:

curl https://api15.comm100.io/v4/global/skills/AB743060-4735-4E26-9B57-24AD469EC12A \
-X 'DELETE' \
-H 'Authorization: Bearer {access_token}' \

Response:

 HTTP/1.1 204 No Content