arcade-mcp/toolkits/vercel_api/arcade_vercel_api/wrapper_tools/FetchDeploymentLogs.json
jottakka 686dfce7b0
[MOAR][VERCEL] Adding Vercel Starter Toolkit (#638)
Vercel API

---------

Co-authored-by: Francisco Liberal <francisco@arcade.dev>
2025-10-21 12:06:46 -03:00

493 lines
15 KiB
JSON

{
"name": "FetchDeploymentLogs",
"fully_qualified_name": "VercelApi.FetchDeploymentLogs@0.1.0",
"description": "Retrieve build logs for a specific deployment by ID.\n\nUse this tool to access the build logs or events of a deployment using its deployment ID and build ID. It can stream logs continuously or return them in JSON format based on input parameters.",
"toolkit": {
"name": "ArcadeVercelApi",
"description": null,
"version": "0.1.0"
},
"input": {
"parameters": [
{
"name": "deployment_identifier_or_hostname",
"required": true,
"description": "The unique identifier or hostname of the deployment to fetch logs for.",
"value_schema": {
"val_type": "string",
"inner_val_type": null,
"enum": null,
"properties": null,
"inner_properties": null,
"description": "The unique identifier or hostname of the deployment."
},
"inferrable": true,
"http_endpoint_parameter_name": "idOrUrl"
},
{
"name": "event_order",
"required": false,
"description": "Specifies the order of returned events by timestamp. Use 'forward' for chronological order or 'backward' for reverse order.",
"value_schema": {
"val_type": "string",
"inner_val_type": null,
"enum": [
"backward",
"forward"
],
"properties": null,
"inner_properties": null,
"description": "Order of the returned events based on the timestamp."
},
"inferrable": true,
"http_endpoint_parameter_name": "direction"
},
{
"name": "enable_live_streaming",
"required": false,
"description": "Set to '1' to enable live streaming of events as they happen. Use '0' to disable live streaming.",
"value_schema": {
"val_type": "number",
"inner_val_type": null,
"enum": [
"0",
"1"
],
"properties": null,
"inner_properties": null,
"description": "When enabled, this endpoint will return live events as they happen."
},
"inferrable": true,
"http_endpoint_parameter_name": "follow"
},
{
"name": "maximum_events_to_return",
"required": false,
"description": "Specify the max number of events to return. Use `-1` for all available logs.",
"value_schema": {
"val_type": "number",
"inner_val_type": null,
"enum": null,
"properties": null,
"inner_properties": null,
"description": "Maximum number of events to return. Provide `-1` to return all available logs."
},
"inferrable": true,
"http_endpoint_parameter_name": "limit"
},
{
"name": "deployment_build_id",
"required": false,
"description": "The unique identifier for the deployment build for which logs are to be retrieved.",
"value_schema": {
"val_type": "string",
"inner_val_type": null,
"enum": null,
"properties": null,
"inner_properties": null,
"description": "Deployment build ID."
},
"inferrable": true,
"http_endpoint_parameter_name": "name"
},
{
"name": "start_timestamp_for_logs",
"required": false,
"description": "Timestamp from which to start retrieving build logs. Provide in milliseconds.",
"value_schema": {
"val_type": "number",
"inner_val_type": null,
"enum": null,
"properties": null,
"inner_properties": null,
"description": "Timestamp for when build logs should be pulled from."
},
"inferrable": true,
"http_endpoint_parameter_name": "since"
},
{
"name": "fetch_until_timestamp",
"required": false,
"description": "Timestamp up to which the build logs should be retrieved.",
"value_schema": {
"val_type": "number",
"inner_val_type": null,
"enum": null,
"properties": null,
"inner_properties": null,
"description": "Timestamp for when the build logs should be pulled up until."
},
"inferrable": true,
"http_endpoint_parameter_name": "until"
},
{
"name": "filter_by_status_code",
"required": false,
"description": "Specify the HTTP status code range to filter deployment events.",
"value_schema": {
"val_type": "string",
"inner_val_type": null,
"enum": null,
"properties": null,
"inner_properties": null,
"description": "HTTP status code range to filter events by."
},
"inferrable": true,
"http_endpoint_parameter_name": "statusCode"
},
{
"name": "build_event_delimiter",
"required": false,
"description": "Specify the delimiter type for separating logged events. Use '0' for no delimiter and '1' for an alternative separation method.",
"value_schema": {
"val_type": "number",
"inner_val_type": null,
"enum": [
"0",
"1"
],
"properties": null,
"inner_properties": null,
"description": ""
},
"inferrable": true,
"http_endpoint_parameter_name": "delimiter"
},
{
"name": "include_builds",
"required": false,
"description": "Specify whether to include build events (1) or not (0) in the response.",
"value_schema": {
"val_type": "number",
"inner_val_type": null,
"enum": [
"0",
"1"
],
"properties": null,
"inner_properties": null,
"description": ""
},
"inferrable": true,
"http_endpoint_parameter_name": "builds"
},
{
"name": "team_identifier",
"required": false,
"description": "Identifies the team on whose behalf the request is performed.",
"value_schema": {
"val_type": "string",
"inner_val_type": null,
"enum": null,
"properties": null,
"inner_properties": null,
"description": "The Team identifier to perform the request on behalf of."
},
"inferrable": true,
"http_endpoint_parameter_name": "teamId"
},
{
"name": "team_slug",
"required": false,
"description": "The unique identifier (slug) of the Team for which the request is made. Used to specify the team context.",
"value_schema": {
"val_type": "string",
"inner_val_type": null,
"enum": null,
"properties": null,
"inner_properties": null,
"description": "The Team slug to perform the request on behalf of."
},
"inferrable": true,
"http_endpoint_parameter_name": "slug"
}
]
},
"output": {
"description": "Response from the API endpoint 'getDeploymentEvents'.",
"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": null,
"secrets": [
{
"key": "VERCEL_ACCESS_TOKEN"
}
],
"metadata": null
},
"deprecation_message": null,
"metadata": {
"object_type": "api_wrapper_tool",
"version": "1.1.0",
"description": "Tools that enable LLMs to interact directly with the vercel API."
},
"http_endpoint": {
"metadata": {
"object_type": "http_endpoint",
"version": "1.2.0",
"description": ""
},
"url": "https://api.vercel.com/v3/deployments/{idOrUrl}/events",
"http_method": "GET",
"headers": {
"Content-Type": "application/json"
},
"parameters": [
{
"name": "direction",
"tool_parameter_name": "event_order",
"description": "Order of the returned events based on the timestamp.",
"value_schema": {
"val_type": "string",
"inner_val_type": null,
"enum": [
"backward",
"forward"
],
"properties": null,
"inner_properties": null,
"description": "Order of the returned events based on the timestamp."
},
"accepted_as": "query",
"required": false,
"deprecated": false,
"default": "forward",
"documentation_urls": []
},
{
"name": "follow",
"tool_parameter_name": "enable_live_streaming",
"description": "When enabled, this endpoint will return live events as they happen.",
"value_schema": {
"val_type": "number",
"inner_val_type": null,
"enum": [
"0",
"1"
],
"properties": null,
"inner_properties": null,
"description": "When enabled, this endpoint will return live events as they happen."
},
"accepted_as": "query",
"required": false,
"deprecated": false,
"default": null,
"documentation_urls": []
},
{
"name": "limit",
"tool_parameter_name": "maximum_events_to_return",
"description": "Maximum number of events to return. Provide `-1` to return all available logs.",
"value_schema": {
"val_type": "number",
"inner_val_type": null,
"enum": null,
"properties": null,
"inner_properties": null,
"description": "Maximum number of events to return. Provide `-1` to return all available logs."
},
"accepted_as": "query",
"required": false,
"deprecated": false,
"default": null,
"documentation_urls": []
},
{
"name": "name",
"tool_parameter_name": "deployment_build_id",
"description": "Deployment build ID.",
"value_schema": {
"val_type": "string",
"inner_val_type": null,
"enum": null,
"properties": null,
"inner_properties": null,
"description": "Deployment build ID."
},
"accepted_as": "query",
"required": false,
"deprecated": false,
"default": null,
"documentation_urls": []
},
{
"name": "since",
"tool_parameter_name": "start_timestamp_for_logs",
"description": "Timestamp for when build logs should be pulled from.",
"value_schema": {
"val_type": "number",
"inner_val_type": null,
"enum": null,
"properties": null,
"inner_properties": null,
"description": "Timestamp for when build logs should be pulled from."
},
"accepted_as": "query",
"required": false,
"deprecated": false,
"default": null,
"documentation_urls": []
},
{
"name": "until",
"tool_parameter_name": "fetch_until_timestamp",
"description": "Timestamp for when the build logs should be pulled up until.",
"value_schema": {
"val_type": "number",
"inner_val_type": null,
"enum": null,
"properties": null,
"inner_properties": null,
"description": "Timestamp for when the build logs should be pulled up until."
},
"accepted_as": "query",
"required": false,
"deprecated": false,
"default": null,
"documentation_urls": []
},
{
"name": "statusCode",
"tool_parameter_name": "filter_by_status_code",
"description": "HTTP status code range to filter events by.",
"value_schema": {
"val_type": "string",
"inner_val_type": null,
"enum": null,
"properties": null,
"inner_properties": null,
"description": "HTTP status code range to filter events by."
},
"accepted_as": "query",
"required": false,
"deprecated": false,
"default": null,
"documentation_urls": []
},
{
"name": "delimiter",
"tool_parameter_name": "build_event_delimiter",
"description": "",
"value_schema": {
"val_type": "number",
"inner_val_type": null,
"enum": [
"0",
"1"
],
"properties": null,
"inner_properties": null,
"description": ""
},
"accepted_as": "query",
"required": false,
"deprecated": false,
"default": null,
"documentation_urls": []
},
{
"name": "builds",
"tool_parameter_name": "include_builds",
"description": "",
"value_schema": {
"val_type": "number",
"inner_val_type": null,
"enum": [
"0",
"1"
],
"properties": null,
"inner_properties": null,
"description": ""
},
"accepted_as": "query",
"required": false,
"deprecated": false,
"default": null,
"documentation_urls": []
},
{
"name": "teamId",
"tool_parameter_name": "team_identifier",
"description": "The Team identifier to perform the request on behalf of.",
"value_schema": {
"val_type": "string",
"inner_val_type": null,
"enum": null,
"properties": null,
"inner_properties": null,
"description": "The Team identifier to perform the request on behalf of."
},
"accepted_as": "query",
"required": false,
"deprecated": false,
"default": null,
"documentation_urls": []
},
{
"name": "slug",
"tool_parameter_name": "team_slug",
"description": "The Team slug to perform the request on behalf of.",
"value_schema": {
"val_type": "string",
"inner_val_type": null,
"enum": null,
"properties": null,
"inner_properties": null,
"description": "The Team slug to perform the request on behalf of."
},
"accepted_as": "query",
"required": false,
"deprecated": false,
"default": null,
"documentation_urls": []
},
{
"name": "idOrUrl",
"tool_parameter_name": "deployment_identifier_or_hostname",
"description": "The unique identifier or hostname of the deployment.",
"value_schema": {
"val_type": "string",
"inner_val_type": null,
"enum": null,
"properties": null,
"inner_properties": null,
"description": "The unique identifier or hostname of the deployment."
},
"accepted_as": "path",
"required": true,
"deprecated": false,
"default": null,
"documentation_urls": []
}
],
"documentation_urls": [],
"secrets": [
{
"arcade_key": "VERCEL_ACCESS_TOKEN",
"parameter_name": "Authorization",
"accepted_as": "header",
"formatted_value": "Bearer {authorization}",
"description": "",
"is_auth_token": false
}
],
"request_body_spec": null,
"use_request_body_schema_mode": false,
"validate_request_body_schema": false
}
}