arcade-mcp/toolkits/figma_api/arcade_figma_api/wrapper_tools/GetTeamStyles.json
jottakka d71521ac81
[MOAR][FIGMA] Figma Starter Toolkit (#621)
Co-authored-by: Francisco Liberal <francisco@arcade.dev>
2025-10-16 14:15:01 -03:00

210 lines
7.3 KiB
JSON

{
"name": "GetTeamStyles",
"fully_qualified_name": "FigmaApi.GetTeamStyles@0.1.0",
"description": "Retrieve a list of published styles from a team's library in Figma.\n\nThis tool retrieves a paginated list of styles that have been published within a specified team's library in Figma. It should be called when you need access to design styles, such as colors or text styles, that a team has made available in their library.",
"toolkit": {
"name": "ArcadeFigmaApi",
"description": null,
"version": "0.1.0"
},
"input": {
"parameters": [
{
"name": "team_id",
"required": true,
"description": "The unique identifier of the team from which to retrieve published styles.",
"value_schema": {
"val_type": "string",
"inner_val_type": null,
"enum": null,
"properties": null,
"inner_properties": null,
"description": "Id of the team to list styles from."
},
"inferrable": true,
"http_endpoint_parameter_name": "team_id"
},
{
"name": "items_per_page",
"required": false,
"description": "Specify the number of styles to return per page. Defaults to 30 if not provided.",
"value_schema": {
"val_type": "number",
"inner_val_type": null,
"enum": null,
"properties": null,
"inner_properties": null,
"description": "Number of items to return in a paged list of results. Defaults to 30."
},
"inferrable": true,
"http_endpoint_parameter_name": "page_size"
},
{
"name": "start_after_cursor",
"required": false,
"description": "Cursor to start retrieving styles after a specific ID. Cannot be used with before. Internally tracked integer.",
"value_schema": {
"val_type": "number",
"inner_val_type": null,
"enum": null,
"properties": null,
"inner_properties": null,
"description": "Cursor indicating which id after which to start retrieving styles for. Exclusive with before. The cursor value is an internally tracked integer that doesn't correspond to any Ids."
},
"inferrable": true,
"http_endpoint_parameter_name": "after"
},
{
"name": "cursor_before_id",
"required": false,
"description": "Cursor for retrieving styles before a specific ID. Use this to paginate backwards. Exclusive with after.",
"value_schema": {
"val_type": "number",
"inner_val_type": null,
"enum": null,
"properties": null,
"inner_properties": null,
"description": "Cursor indicating which id before which to start retrieving styles for. Exclusive with after. The cursor value is an internally tracked integer that doesn't correspond to any Ids."
},
"inferrable": true,
"http_endpoint_parameter_name": "before"
}
]
},
"output": {
"description": "Response from the API endpoint 'getTeamStyles'.",
"available_modes": [
"value",
"error",
"null"
],
"value_schema": {
"val_type": "json",
"inner_val_type": null,
"enum": null,
"properties": null,
"inner_properties": null,
"description": null
}
},
"requirements": {
"authorization": {
"provider_id": "arcade-figma",
"provider_type": "oauth2",
"id": null,
"oauth2": {
"scopes": [
"team_library_content:read"
]
}
},
"secrets": null,
"metadata": null
},
"deprecation_message": null,
"metadata": {
"object_type": "api_wrapper_tool",
"version": "1.0.0",
"description": "Tools that enable LLMs to interact directly with the figma API."
},
"http_endpoint": {
"metadata": {
"object_type": "http_endpoint",
"version": "1.1.0",
"description": ""
},
"url": "https://api.figma.com/v1/teams/{team_id}/styles",
"http_method": "GET",
"headers": {
"Content-Type": "application/json"
},
"parameters": [
{
"name": "page_size",
"tool_parameter_name": "items_per_page",
"description": "Number of items to return in a paged list of results. Defaults to 30.",
"value_schema": {
"val_type": "number",
"inner_val_type": null,
"enum": null,
"properties": null,
"inner_properties": null,
"description": "Number of items to return in a paged list of results. Defaults to 30."
},
"accepted_as": "query",
"required": false,
"deprecated": false,
"default": 30,
"documentation_urls": []
},
{
"name": "after",
"tool_parameter_name": "start_after_cursor",
"description": "Cursor indicating which id after which to start retrieving styles for. Exclusive with before. The cursor value is an internally tracked integer that doesn't correspond to any Ids.",
"value_schema": {
"val_type": "number",
"inner_val_type": null,
"enum": null,
"properties": null,
"inner_properties": null,
"description": "Cursor indicating which id after which to start retrieving styles for. Exclusive with before. The cursor value is an internally tracked integer that doesn't correspond to any Ids."
},
"accepted_as": "query",
"required": false,
"deprecated": false,
"default": null,
"documentation_urls": []
},
{
"name": "before",
"tool_parameter_name": "cursor_before_id",
"description": "Cursor indicating which id before which to start retrieving styles for. Exclusive with after. The cursor value is an internally tracked integer that doesn't correspond to any Ids.",
"value_schema": {
"val_type": "number",
"inner_val_type": null,
"enum": null,
"properties": null,
"inner_properties": null,
"description": "Cursor indicating which id before which to start retrieving styles for. Exclusive with after. The cursor value is an internally tracked integer that doesn't correspond to any Ids."
},
"accepted_as": "query",
"required": false,
"deprecated": false,
"default": null,
"documentation_urls": []
},
{
"name": "team_id",
"tool_parameter_name": "team_id",
"description": "Id of the team to list styles from.",
"value_schema": {
"val_type": "string",
"inner_val_type": null,
"enum": null,
"properties": null,
"inner_properties": null,
"description": "Id of the team to list styles from."
},
"accepted_as": "path",
"required": true,
"deprecated": false,
"default": null,
"documentation_urls": []
}
],
"documentation_urls": [],
"secrets": [
{
"arcade_key": "auth_token",
"parameter_name": "Authorization",
"accepted_as": "header",
"formatted_value": "Bearer {authorization}",
"description": "The OAuth token to use for authentication.",
"is_auth_token": true
}
],
"request_body_spec": null,
"use_request_body_schema_mode": false,
"validate_request_body_schema": false
}
}