{ "name": "CreateAutomationRunner", "fully_qualified_name": "PagerdutyApi.CreateAutomationRunner@2.0.0", "description": "Create a Process or Runbook Automation runner.\n\nUse this tool to create a new Process Automation or Runbook Automation runner in PagerDuty.", "toolkit": { "name": "ArcadePagerdutyApi", "description": null, "version": "2.0.0" }, "input": { "parameters": [ { "name": "accept_version_header", "required": true, "description": "The version identifier for the API response format. Use it to specify which version of the API to use.", "value_schema": { "val_type": "string", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": "The `Accept` header is used as a versioning header." }, "inferrable": true, "http_endpoint_parameter_name": "Accept" }, { "name": "content_type_header", "required": true, "description": "Specifies the content type of the request, usually set to 'application/json'.", "value_schema": { "val_type": "string", "inner_val_type": null, "enum": [ "application/json" ], "properties": null, "inner_properties": null, "description": "" }, "inferrable": true, "http_endpoint_parameter_name": "Content-Type" }, { "name": "automation_runner_details", "required": true, "description": "Provide details of the automation runner to be created. This should include necessary configuration settings in JSON format.", "value_schema": { "val_type": "json", "inner_val_type": null, "enum": null, "properties": { "runner": { "val_type": "json", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": null } }, "inner_properties": null, "description": "" }, "inferrable": true, "http_endpoint_parameter_name": "requestBody" } ] }, "output": { "description": "Response from the API endpoint 'createAutomationActionsRunner'.", "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-pagerduty", "provider_type": "oauth2", "id": null, "oauth2": null }, "secrets": null, "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 Pagerduty API." }, "http_endpoint": { "metadata": { "object_type": "http_endpoint", "version": "1.2.0", "description": "" }, "url": "https://api.pagerduty.com/automation_actions/runners", "http_method": "POST", "headers": {}, "parameters": [ { "name": "Accept", "tool_parameter_name": "accept_version_header", "description": "The `Accept` header is used as a versioning header.", "value_schema": { "val_type": "string", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": "The `Accept` header is used as a versioning header." }, "accepted_as": "header", "required": true, "deprecated": false, "default": "application/vnd.pagerduty+json;version=2", "documentation_urls": [] }, { "name": "Content-Type", "tool_parameter_name": "content_type_header", "description": "", "value_schema": { "val_type": "string", "inner_val_type": null, "enum": [ "application/json" ], "properties": null, "inner_properties": null, "description": "" }, "accepted_as": "header", "required": true, "deprecated": false, "default": "application/json", "documentation_urls": [] }, { "name": "requestBody", "tool_parameter_name": "automation_runner_details", "description": "", "value_schema": { "val_type": "json", "inner_val_type": null, "enum": null, "properties": { "runner": { "val_type": "json", "inner_val_type": null, "enum": null, "properties": null, "inner_properties": null, "description": null } }, "inner_properties": null, "description": "" }, "accepted_as": "body", "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": "{\n \"content\": {\n \"application/json\": {\n \"schema\": {\n \"type\": \"object\",\n \"properties\": {\n \"runner\": {\n \"oneOf\": [\n {\n \"type\": \"object\",\n \"title\": \"RunnerSidecarPostBody\",\n \"properties\": {\n \"runner_type\": {\n \"description\": \"sidecar -- The runner is backed by an external sidecar that polls for invocations.\\nrunbook -- The runner communicates directly with a runbook instance.\\n\",\n \"type\": \"string\",\n \"enum\": [\n \"sidecar\",\n \"runbook\"\n ],\n \"example\": \"runbook\"\n },\n \"name\": {\n \"type\": \"string\",\n \"maxLength\": 255,\n \"example\": \"us-west-2 prod runner\"\n },\n \"description\": {\n \"type\": \"string\",\n \"maxLength\": 1024,\n \"example\": \"us-west-2 runner provisioned in the production environment by the SRE team\"\n },\n \"teams\": {\n \"type\": \"array\",\n \"description\": \"The list of teams associated with the Runner\",\n \"items\": {\n \"allOf\": [\n {\n \"allOf\": [\n {\n \"type\": \"object\",\n \"properties\": {\n \"id\": {\n \"type\": \"string\",\n \"readOnly\": true\n },\n \"summary\": {\n \"type\": \"string\",\n \"nullable\": true,\n \"readOnly\": true,\n \"description\": \"A short-form, server-generated string that provides succinct, important information about an object suitable for primary labeling of an entity in a client. In many cases, this will be identical to `name`, though it is not intended to be an identifier.\"\n },\n \"type\": {\n \"type\": \"string\",\n \"readOnly\": true,\n \"description\": \"A string that determines the schema of the object. This must be the standard name for the entity, suffixed by `_reference` if the object is a reference.\"\n },\n \"self\": {\n \"type\": \"string\",\n \"nullable\": true,\n \"readOnly\": true,\n \"format\": \"url\",\n \"description\": \"the API show URL at which the object is accessible\"\n },\n \"html_url\": {\n \"type\": \"string\",\n \"nullable\": true,\n \"readOnly\": true,\n \"format\": \"url\",\n \"description\": \"a URL at which the entity is uniquely displayed in the Web app\"\n }\n }\n },\n {\n \"type\": \"object\",\n \"required\": [\n \"type\",\n \"id\"\n ]\n }\n ]\n },\n {\n \"type\": \"object\",\n \"properties\": {\n \"type\": {\n \"type\": \"string\",\n \"enum\": [\n \"team_reference\"\n ]\n }\n }\n }\n ]\n }\n }\n },\n \"required\": [\n \"runner_type\",\n \"name\",\n \"description\"\n ]\n },\n {\n \"type\": \"object\",\n \"title\": \"RunnerRunbookPostBody\",\n \"properties\": {\n \"runner_type\": {\n \"description\": \"sidecar -- The runner is backed by an external sidecar that polls for invocations.\\nrunbook -- The runner communicates directly with a runbook instance.\\n\",\n \"type\": \"string\",\n \"enum\": [\n \"sidecar\",\n \"runbook\"\n ],\n \"example\": \"runbook\"\n },\n \"name\": {\n \"type\": \"string\",\n \"maxLength\": 255,\n \"example\": \"us-west-2 prod runner\"\n },\n \"description\": {\n \"type\": \"string\",\n \"maxLength\": 1024,\n \"example\": \"us-west-2 runner provisioned in the production environment by the SRE team\"\n },\n \"runbook_base_uri\": {\n \"type\": \"string\",\n \"description\": \"The base URI of the Runbook server to connect to. May only contain alphanumeric characters, periods, underscores and dashes. Specified as the subdomain portion of an RBA host, as in .runbook.pagerduty.cloud\",\n \"maxLength\": 255,\n \"example\": \"subdomain\"\n },\n \"runbook_api_key\": {\n \"type\": \"string\",\n \"maxLength\": 64,\n \"description\": \"The API key to connect to the Runbook server with. If omitted, the previously stored value will remain unchanged\"\n },\n \"teams\": {\n \"type\": \"array\",\n \"description\": \"The list of teams associated with the Runner\",\n \"items\": {\n \"allOf\": [\n {\n \"allOf\": [\n {\n \"type\": \"object\",\n \"properties\": {\n \"id\": {\n \"type\": \"string\",\n \"readOnly\": true\n },\n \"summary\": {\n \"type\": \"string\",\n \"nullable\": true,\n \"readOnly\": true,\n \"description\": \"A short-form, server-generated string that provides succinct, important information about an object suitable for primary labeling of an entity in a client. In many cases, this will be identical to `name`, though it is not intended to be an identifier.\"\n },\n \"type\": {\n \"type\": \"string\",\n \"readOnly\": true,\n \"description\": \"A string that determines the schema of the object. This must be the standard name for the entity, suffixed by `_reference` if the object is a reference.\"\n },\n \"self\": {\n \"type\": \"string\",\n \"nullable\": true,\n \"readOnly\": true,\n \"format\": \"url\",\n \"description\": \"the API show URL at which the object is accessible\"\n },\n \"html_url\": {\n \"type\": \"string\",\n \"nullable\": true,\n \"readOnly\": true,\n \"format\": \"url\",\n \"description\": \"a URL at which the entity is uniquely displayed in the Web app\"\n }\n }\n },\n {\n \"type\": \"object\",\n \"required\": [\n \"type\",\n \"id\"\n ]\n }\n ]\n },\n {\n \"type\": \"object\",\n \"properties\": {\n \"type\": {\n \"type\": \"string\",\n \"enum\": [\n \"team_reference\"\n ]\n }\n }\n }\n ]\n }\n }\n },\n \"required\": [\n \"runner_type\",\n \"name\",\n \"description\",\n \"runbook_base_uri\",\n \"runbook_api_key\"\n ]\n }\n ],\n \"discriminator\": {\n \"propertyName\": \"runner_type\"\n }\n }\n },\n \"required\": [\n \"runner\"\n ]\n },\n \"examples\": {\n \"request\": {\n \"value\": {\n \"runner\": {\n \"name\": \"us-west-2 prod sidecar runner\",\n \"description\": \"us-west-2 prod sidecar runner provisioned by SRE\",\n \"runner_type\": \"sidecar\",\n \"teams\": [\n {\n \"id\": \"PQ9K7I8\",\n \"type\": \"team_reference\"\n }\n ]\n }\n }\n }\n }\n }\n },\n \"required\": true\n}", "use_request_body_schema_mode": true, "validate_request_body_schema": true } }