Skip to content

Commit c809099

Browse files
zimegClaude
andauthored
feat: add slackbot.skills.list method (#1688)
Adds the slackbot.skills.list Web API method to the sync and async clients, with its request and response types, mock fixture, rate limit tier, and tests. Co-authored-by: Claude <svc-devxp-claude@slack-corp.com>
1 parent 778ae31 commit c809099

14 files changed

Lines changed: 225 additions & 2 deletions

File tree

Lines changed: 43 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,43 @@
1+
{
2+
"ok": false,
3+
"error": "",
4+
"needed": "",
5+
"provided": "",
6+
"warning": "",
7+
"response_metadata": {
8+
"messages": [
9+
""
10+
],
11+
"next_cursor": ""
12+
},
13+
"skills": [
14+
{
15+
"access": "",
16+
"category": "",
17+
"creator_id": "U00000000",
18+
"date_created": 12345,
19+
"date_updated": 12345,
20+
"description": "",
21+
"display_name": "",
22+
"example_prompt": "",
23+
"id": "F00000000",
24+
"instructions": "",
25+
"is_official": false,
26+
"library_count": 12345,
27+
"mcp_servers": [
28+
{
29+
"service_type": "",
30+
"app_id": "A00000000",
31+
"server_id": "",
32+
"display_name": "",
33+
"is_available": false
34+
}
35+
],
36+
"name": "",
37+
"permalink": "",
38+
"type": "",
39+
"usage_count": 12345,
40+
"visibility": ""
41+
}
42+
]
43+
}

‎metadata/web-api/rate_limit_tiers.json‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -298,6 +298,7 @@
298298
"slackLists.update": "Tier2",
299299
"slackbot.skills.create": "Tier2",
300300
"slackbot.skills.info": "Tier3",
301+
"slackbot.skills.list": "Tier3",
301302
"slackbot.skills.update": "Tier3",
302303
"stars.add": "Tier2",
303304
"stars.list": "Tier3",

‎slack-api-client/src/main/java/com/slack/api/methods/AsyncMethodsClient.java‎

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -131,6 +131,7 @@
131131
import com.slack.api.methods.request.slack_lists.SlackListsUpdateRequest;
132132
import com.slack.api.methods.request.slackbot.skills.SlackbotSkillsCreateRequest;
133133
import com.slack.api.methods.request.slackbot.skills.SlackbotSkillsInfoRequest;
134+
import com.slack.api.methods.request.slackbot.skills.SlackbotSkillsListRequest;
134135
import com.slack.api.methods.request.slackbot.skills.SlackbotSkillsUpdateRequest;
135136
import com.slack.api.methods.request.stars.StarsAddRequest;
136137
import com.slack.api.methods.request.stars.StarsListRequest;
@@ -288,6 +289,7 @@
288289
import com.slack.api.methods.response.slack_lists.SlackListsUpdateResponse;
289290
import com.slack.api.methods.response.slackbot.skills.SlackbotSkillsCreateResponse;
290291
import com.slack.api.methods.response.slackbot.skills.SlackbotSkillsInfoResponse;
292+
import com.slack.api.methods.response.slackbot.skills.SlackbotSkillsListResponse;
291293
import com.slack.api.methods.response.slackbot.skills.SlackbotSkillsUpdateResponse;
292294
import com.slack.api.methods.response.stars.StarsAddResponse;
293295
import com.slack.api.methods.response.stars.StarsListResponse;
@@ -1601,6 +1603,10 @@ CompletableFuture<AdminConversationsWhitelistListGroupsLinkedToChannelResponse>
16011603

16021604
CompletableFuture<SlackbotSkillsInfoResponse> slackbotSkillsInfo(RequestConfigurator<SlackbotSkillsInfoRequest.SlackbotSkillsInfoRequestBuilder> req);
16031605

1606+
CompletableFuture<SlackbotSkillsListResponse> slackbotSkillsList(SlackbotSkillsListRequest req);
1607+
1608+
CompletableFuture<SlackbotSkillsListResponse> slackbotSkillsList(RequestConfigurator<SlackbotSkillsListRequest.SlackbotSkillsListRequestBuilder> req);
1609+
16041610
CompletableFuture<SlackbotSkillsUpdateResponse> slackbotSkillsUpdate(SlackbotSkillsUpdateRequest req);
16051611

16061612
CompletableFuture<SlackbotSkillsUpdateResponse> slackbotSkillsUpdate(RequestConfigurator<SlackbotSkillsUpdateRequest.SlackbotSkillsUpdateRequestBuilder> req);

‎slack-api-client/src/main/java/com/slack/api/methods/Methods.java‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -707,6 +707,7 @@ private Methods() {
707707

708708
public static final String SLACKBOT_SKILLS_CREATE = "slackbot.skills.create";
709709
public static final String SLACKBOT_SKILLS_INFO = "slackbot.skills.info";
710+
public static final String SLACKBOT_SKILLS_LIST = "slackbot.skills.list";
710711
public static final String SLACKBOT_SKILLS_UPDATE = "slackbot.skills.update";
711712

712713
// ------------------------------

‎slack-api-client/src/main/java/com/slack/api/methods/MethodsClient.java‎

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -147,6 +147,7 @@
147147
import com.slack.api.methods.request.slack_lists.SlackListsUpdateRequest;
148148
import com.slack.api.methods.request.slackbot.skills.SlackbotSkillsCreateRequest;
149149
import com.slack.api.methods.request.slackbot.skills.SlackbotSkillsInfoRequest;
150+
import com.slack.api.methods.request.slackbot.skills.SlackbotSkillsListRequest;
150151
import com.slack.api.methods.request.slackbot.skills.SlackbotSkillsUpdateRequest;
151152
import com.slack.api.methods.request.team.*;
152153
import com.slack.api.methods.request.team.external_teams.TeamExternalTeamsDisconnectRequest;
@@ -313,6 +314,7 @@
313314
import com.slack.api.methods.response.slack_lists.SlackListsUpdateResponse;
314315
import com.slack.api.methods.response.slackbot.skills.SlackbotSkillsCreateResponse;
315316
import com.slack.api.methods.response.slackbot.skills.SlackbotSkillsInfoResponse;
317+
import com.slack.api.methods.response.slackbot.skills.SlackbotSkillsListResponse;
316318
import com.slack.api.methods.response.slackbot.skills.SlackbotSkillsUpdateResponse;
317319
import com.slack.api.methods.response.stars.StarsAddResponse;
318320
import com.slack.api.methods.response.stars.StarsListResponse;
@@ -2748,6 +2750,11 @@ SlackbotSkillsCreateResponse slackbotSkillsCreate(RequestConfigurator<SlackbotSk
27482750
SlackbotSkillsInfoResponse slackbotSkillsInfo(RequestConfigurator<SlackbotSkillsInfoRequest.SlackbotSkillsInfoRequestBuilder> req)
27492751
throws IOException, SlackApiException;
27502752

2753+
SlackbotSkillsListResponse slackbotSkillsList(SlackbotSkillsListRequest req) throws IOException, SlackApiException;
2754+
2755+
SlackbotSkillsListResponse slackbotSkillsList(RequestConfigurator<SlackbotSkillsListRequest.SlackbotSkillsListRequestBuilder> req)
2756+
throws IOException, SlackApiException;
2757+
27512758
SlackbotSkillsUpdateResponse slackbotSkillsUpdate(SlackbotSkillsUpdateRequest req) throws IOException, SlackApiException;
27522759

27532760
SlackbotSkillsUpdateResponse slackbotSkillsUpdate(RequestConfigurator<SlackbotSkillsUpdateRequest.SlackbotSkillsUpdateRequestBuilder> req)

‎slack-api-client/src/main/java/com/slack/api/methods/MethodsRateLimits.java‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -459,6 +459,7 @@ public static void setRateLimitTier(String methodName, MethodsRateLimitTier tier
459459

460460
setRateLimitTier(SLACKBOT_SKILLS_CREATE, Tier2);
461461
setRateLimitTier(SLACKBOT_SKILLS_INFO, Tier3);
462+
setRateLimitTier(SLACKBOT_SKILLS_LIST, Tier3);
462463
setRateLimitTier(SLACKBOT_SKILLS_UPDATE, Tier3);
463464

464465
setRateLimitTier(STARS_ADD, Tier2);

‎slack-api-client/src/main/java/com/slack/api/methods/RequestFormBuilder.java‎

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -144,6 +144,7 @@
144144
import com.slack.api.methods.request.slack_lists.SlackListsUpdateRequest;
145145
import com.slack.api.methods.request.slackbot.skills.SlackbotSkillsCreateRequest;
146146
import com.slack.api.methods.request.slackbot.skills.SlackbotSkillsInfoRequest;
147+
import com.slack.api.methods.request.slackbot.skills.SlackbotSkillsListRequest;
147148
import com.slack.api.methods.request.slackbot.skills.SlackbotSkillsUpdateRequest;
148149
import com.slack.api.methods.request.stars.StarsAddRequest;
149150
import com.slack.api.methods.request.stars.StarsListRequest;
@@ -3170,6 +3171,15 @@ public static FormBody.Builder toForm(SlackbotSkillsInfoRequest req) {
31703171
return form;
31713172
}
31723173

3174+
public static FormBody.Builder toForm(SlackbotSkillsListRequest req) {
3175+
FormBody.Builder form = new FormBody.Builder();
3176+
setIfNotNull("filter", req.getFilter(), form);
3177+
setIfNotNull("category", req.getCategory(), form);
3178+
setIfNotNull("cursor", req.getCursor(), form);
3179+
setIfNotNull("limit", req.getLimit(), form);
3180+
return form;
3181+
}
3182+
31733183
public static FormBody.Builder toForm(SlackbotSkillsUpdateRequest req) {
31743184
FormBody.Builder form = new FormBody.Builder();
31753185
setIfNotNull("skill_id", req.getSkillId(), form);

‎slack-api-client/src/main/java/com/slack/api/methods/impl/AsyncMethodsClientImpl.java‎

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -135,6 +135,7 @@
135135
import com.slack.api.methods.request.slack_lists.SlackListsUpdateRequest;
136136
import com.slack.api.methods.request.slackbot.skills.SlackbotSkillsCreateRequest;
137137
import com.slack.api.methods.request.slackbot.skills.SlackbotSkillsInfoRequest;
138+
import com.slack.api.methods.request.slackbot.skills.SlackbotSkillsListRequest;
138139
import com.slack.api.methods.request.slackbot.skills.SlackbotSkillsUpdateRequest;
139140
import com.slack.api.methods.request.stars.StarsAddRequest;
140141
import com.slack.api.methods.request.stars.StarsListRequest;
@@ -292,6 +293,7 @@
292293
import com.slack.api.methods.response.slack_lists.SlackListsUpdateResponse;
293294
import com.slack.api.methods.response.slackbot.skills.SlackbotSkillsCreateResponse;
294295
import com.slack.api.methods.response.slackbot.skills.SlackbotSkillsInfoResponse;
296+
import com.slack.api.methods.response.slackbot.skills.SlackbotSkillsListResponse;
295297
import com.slack.api.methods.response.slackbot.skills.SlackbotSkillsUpdateResponse;
296298
import com.slack.api.methods.response.stars.StarsAddResponse;
297299
import com.slack.api.methods.response.stars.StarsListResponse;
@@ -2889,6 +2891,16 @@ public CompletableFuture<SlackbotSkillsInfoResponse> slackbotSkillsInfo(RequestC
28892891
return slackbotSkillsInfo(req.configure(SlackbotSkillsInfoRequest.builder()).build());
28902892
}
28912893

2894+
@Override
2895+
public CompletableFuture<SlackbotSkillsListResponse> slackbotSkillsList(SlackbotSkillsListRequest req) {
2896+
return executor.execute(SLACKBOT_SKILLS_LIST, toMap(req), () -> methods.slackbotSkillsList(req));
2897+
}
2898+
2899+
@Override
2900+
public CompletableFuture<SlackbotSkillsListResponse> slackbotSkillsList(RequestConfigurator<SlackbotSkillsListRequest.SlackbotSkillsListRequestBuilder> req) {
2901+
return slackbotSkillsList(req.configure(SlackbotSkillsListRequest.builder()).build());
2902+
}
2903+
28922904
@Override
28932905
public CompletableFuture<SlackbotSkillsUpdateResponse> slackbotSkillsUpdate(SlackbotSkillsUpdateRequest req) {
28942906
return executor.execute(SLACKBOT_SKILLS_UPDATE, toMap(req), () -> methods.slackbotSkillsUpdate(req));

‎slack-api-client/src/main/java/com/slack/api/methods/impl/MethodsClientImpl.java‎

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -145,6 +145,7 @@
145145
import com.slack.api.methods.request.slack_lists.SlackListsUpdateRequest;
146146
import com.slack.api.methods.request.slackbot.skills.SlackbotSkillsCreateRequest;
147147
import com.slack.api.methods.request.slackbot.skills.SlackbotSkillsInfoRequest;
148+
import com.slack.api.methods.request.slackbot.skills.SlackbotSkillsListRequest;
148149
import com.slack.api.methods.request.slackbot.skills.SlackbotSkillsUpdateRequest;
149150
import com.slack.api.methods.request.stars.StarsAddRequest;
150151
import com.slack.api.methods.request.stars.StarsListRequest;
@@ -315,6 +316,7 @@
315316
import com.slack.api.methods.response.slack_lists.SlackListsUpdateResponse;
316317
import com.slack.api.methods.response.slackbot.skills.SlackbotSkillsCreateResponse;
317318
import com.slack.api.methods.response.slackbot.skills.SlackbotSkillsInfoResponse;
319+
import com.slack.api.methods.response.slackbot.skills.SlackbotSkillsListResponse;
318320
import com.slack.api.methods.response.slackbot.skills.SlackbotSkillsUpdateResponse;
319321
import com.slack.api.methods.response.stars.StarsAddResponse;
320322
import com.slack.api.methods.response.stars.StarsListResponse;
@@ -3567,6 +3569,16 @@ public SlackbotSkillsInfoResponse slackbotSkillsInfo(RequestConfigurator<Slackbo
35673569
return slackbotSkillsInfo(req.configure(SlackbotSkillsInfoRequest.builder()).build());
35683570
}
35693571

3572+
@Override
3573+
public SlackbotSkillsListResponse slackbotSkillsList(SlackbotSkillsListRequest req) throws IOException, SlackApiException {
3574+
return postFormWithTokenAndParseResponse(toForm(req), Methods.SLACKBOT_SKILLS_LIST, getToken(req), SlackbotSkillsListResponse.class);
3575+
}
3576+
3577+
@Override
3578+
public SlackbotSkillsListResponse slackbotSkillsList(RequestConfigurator<SlackbotSkillsListRequest.SlackbotSkillsListRequestBuilder> req) throws IOException, SlackApiException {
3579+
return slackbotSkillsList(req.configure(SlackbotSkillsListRequest.builder()).build());
3580+
}
3581+
35703582
@Override
35713583
public SlackbotSkillsUpdateResponse slackbotSkillsUpdate(SlackbotSkillsUpdateRequest req) throws IOException, SlackApiException {
35723584
return postFormWithTokenAndParseResponse(toForm(req), Methods.SLACKBOT_SKILLS_UPDATE, getToken(req), SlackbotSkillsUpdateResponse.class);
Lines changed: 40 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,40 @@
1+
package com.slack.api.methods.request.slackbot.skills;
2+
3+
import com.slack.api.methods.SlackApiRequest;
4+
import lombok.Builder;
5+
import lombok.Data;
6+
7+
/**
8+
* https://docs.slack.dev/reference/methods/slackbot.skills.list
9+
*/
10+
@Data
11+
@Builder
12+
public class SlackbotSkillsListRequest implements SlackApiRequest {
13+
14+
/**
15+
* Authentication token bearing required scopes. Tokens should be passed as an HTTP Authorization header or alternatively, as a POST parameter.
16+
*/
17+
private String token;
18+
19+
/**
20+
* `library`: skills enabled for the caller, including auto-enabled skills and skills from skill sets. `owned`: skills the caller created. `catalog`: the organization's official skills.
21+
* Acceptable values: `library`, `owned`, `catalog`
22+
*/
23+
private String filter;
24+
25+
/**
26+
* Only return skills in this category.
27+
*/
28+
private String category;
29+
30+
/**
31+
* Paginate through collections of data by setting the `cursor` parameter to a `next_cursor` attribute returned by a previous request's `response_metadata`. Must be used with the same `filter` and `category`.
32+
*/
33+
private String cursor;
34+
35+
/**
36+
* The maximum number of skills to return. Fewer may be returned even when more remain.
37+
*/
38+
private Integer limit;
39+
40+
}

0 commit comments

Comments
 (0)