This commit is contained in:
a2a-platform
2026-06-27 01:01:39 +00:00
commit f2c2274e5e
76 changed files with 208440 additions and 0 deletions

279
skills/terminal/SKILL.md Normal file
View File

@@ -0,0 +1,279 @@
---
name: terminal-routes
description: Handle 26 OpenAPI operation(s) under /v1/terminal for the terminal route group.
---
# terminal API Routes
Handle 26 OpenAPI operation(s) under /v1/terminal for the terminal route group.
Use the generated operation tools to make real API calls. Do not invent API responses.
If a tool reports missing setup, return the exact setup field name to the caller.
For write, update, or delete operations, state the intended action before calling the tool.
## Operations
### get_terminal_configurations
- Operation ID: `get_terminal_configurations`
- Route: `GET /v1/terminal/configurations`
- Mode: READ
- Summary: List all Configurations
- Parameters:
- `ending_before` in `query`
- `expand` in `query`
- `is_account_default` in `query`
- `limit` in `query`
- `starting_after` in `query`
- Body: JSON request body accepted.
### post_terminal_configurations
- Operation ID: `post_terminal_configurations`
- Route: `POST /v1/terminal/configurations`
- Mode: WRITE
- Summary: Create a Configuration
- Body: JSON request body accepted.
### delete_terminal_configurations_configuration
- Operation ID: `delete_terminal_configurations_configuration`
- Route: `DELETE /v1/terminal/configurations/{configuration}`
- Mode: WRITE
- Summary: Delete a Configuration
- Parameters:
- `configuration` in `path` required
- Body: JSON request body accepted.
### get_terminal_configurations_configuration
- Operation ID: `get_terminal_configurations_configuration`
- Route: `GET /v1/terminal/configurations/{configuration}`
- Mode: READ
- Summary: Retrieve a Configuration
- Parameters:
- `configuration` in `path` required
- `expand` in `query`
- Body: JSON request body accepted.
### post_terminal_configurations_configuration
- Operation ID: `post_terminal_configurations_configuration`
- Route: `POST /v1/terminal/configurations/{configuration}`
- Mode: WRITE
- Summary: Update a Configuration
- Parameters:
- `configuration` in `path` required
- Body: JSON request body accepted.
### post_terminal_connection_tokens
- Operation ID: `post_terminal_connection_tokens`
- Route: `POST /v1/terminal/connection_tokens`
- Mode: WRITE
- Summary: Create a Connection Token
- Body: JSON request body accepted.
### get_terminal_locations
- Operation ID: `get_terminal_locations`
- Route: `GET /v1/terminal/locations`
- Mode: READ
- Summary: List all Locations
- Parameters:
- `ending_before` in `query`
- `expand` in `query`
- `limit` in `query`
- `starting_after` in `query`
- Body: JSON request body accepted.
### post_terminal_locations
- Operation ID: `post_terminal_locations`
- Route: `POST /v1/terminal/locations`
- Mode: WRITE
- Summary: Create a Location
- Body: JSON request body accepted.
### delete_terminal_locations_location
- Operation ID: `delete_terminal_locations_location`
- Route: `DELETE /v1/terminal/locations/{location}`
- Mode: WRITE
- Summary: Delete a Location
- Parameters:
- `location` in `path` required
- Body: JSON request body accepted.
### get_terminal_locations_location
- Operation ID: `get_terminal_locations_location`
- Route: `GET /v1/terminal/locations/{location}`
- Mode: READ
- Summary: Retrieve a Location
- Parameters:
- `expand` in `query`
- `location` in `path` required
- Body: JSON request body accepted.
### post_terminal_locations_location
- Operation ID: `post_terminal_locations_location`
- Route: `POST /v1/terminal/locations/{location}`
- Mode: WRITE
- Summary: Update a Location
- Parameters:
- `location` in `path` required
- Body: JSON request body accepted.
### post_terminal_onboarding_links
- Operation ID: `post_terminal_onboarding_links`
- Route: `POST /v1/terminal/onboarding_links`
- Mode: WRITE
- Summary: Create an Onboarding Link
- Body: JSON request body accepted.
### get_terminal_readers
- Operation ID: `get_terminal_readers`
- Route: `GET /v1/terminal/readers`
- Mode: READ
- Summary: List all Readers
- Parameters:
- `device_type` in `query`
- `ending_before` in `query`
- `expand` in `query`
- `limit` in `query`
- `location` in `query`
- `serial_number` in `query`
- `starting_after` in `query`
- `status` in `query`
- Body: JSON request body accepted.
### post_terminal_readers
- Operation ID: `post_terminal_readers`
- Route: `POST /v1/terminal/readers`
- Mode: WRITE
- Summary: Create a Reader
- Body: JSON request body accepted.
### delete_terminal_readers_reader
- Operation ID: `delete_terminal_readers_reader`
- Route: `DELETE /v1/terminal/readers/{reader}`
- Mode: WRITE
- Summary: Delete a Reader
- Parameters:
- `reader` in `path` required
- Body: JSON request body accepted.
### get_terminal_readers_reader
- Operation ID: `get_terminal_readers_reader`
- Route: `GET /v1/terminal/readers/{reader}`
- Mode: READ
- Summary: Retrieve a Reader
- Parameters:
- `expand` in `query`
- `reader` in `path` required
- Body: JSON request body accepted.
### post_terminal_readers_reader
- Operation ID: `post_terminal_readers_reader`
- Route: `POST /v1/terminal/readers/{reader}`
- Mode: WRITE
- Summary: Update a Reader
- Parameters:
- `reader` in `path` required
- Body: JSON request body accepted.
### post_terminal_readers_reader_cancel_action
- Operation ID: `post_terminal_readers_reader_cancel_action`
- Route: `POST /v1/terminal/readers/{reader}/cancel_action`
- Mode: WRITE
- Summary: Cancel the current reader action
- Parameters:
- `reader` in `path` required
- Body: JSON request body accepted.
### post_terminal_readers_reader_collect_inputs
- Operation ID: `post_terminal_readers_reader_collect_inputs`
- Route: `POST /v1/terminal/readers/{reader}/collect_inputs`
- Mode: WRITE
- Summary: Collect inputs using a Reader
- Parameters:
- `reader` in `path` required
- Body: JSON request body accepted.
### post_terminal_readers_reader_collect_payment_method
- Operation ID: `post_terminal_readers_reader_collect_payment_method`
- Route: `POST /v1/terminal/readers/{reader}/collect_payment_method`
- Mode: WRITE
- Summary: Hand off a PaymentIntent to a Reader and collect card details
- Parameters:
- `reader` in `path` required
- Body: JSON request body accepted.
### post_terminal_readers_reader_confirm_payment_intent
- Operation ID: `post_terminal_readers_reader_confirm_payment_intent`
- Route: `POST /v1/terminal/readers/{reader}/confirm_payment_intent`
- Mode: WRITE
- Summary: Confirm a PaymentIntent on the Reader
- Parameters:
- `reader` in `path` required
- Body: JSON request body accepted.
### post_terminal_readers_reader_process_payment_intent
- Operation ID: `post_terminal_readers_reader_process_payment_intent`
- Route: `POST /v1/terminal/readers/{reader}/process_payment_intent`
- Mode: WRITE
- Summary: Hand-off a PaymentIntent to a Reader
- Parameters:
- `reader` in `path` required
- Body: JSON request body accepted.
### post_terminal_readers_reader_process_setup_intent
- Operation ID: `post_terminal_readers_reader_process_setup_intent`
- Route: `POST /v1/terminal/readers/{reader}/process_setup_intent`
- Mode: WRITE
- Summary: Hand-off a SetupIntent to a Reader
- Parameters:
- `reader` in `path` required
- Body: JSON request body accepted.
### post_terminal_readers_reader_refund_payment
- Operation ID: `post_terminal_readers_reader_refund_payment`
- Route: `POST /v1/terminal/readers/{reader}/refund_payment`
- Mode: WRITE
- Summary: Refund a Charge or a PaymentIntent in-person
- Parameters:
- `reader` in `path` required
- Body: JSON request body accepted.
### post_terminal_readers_reader_set_reader_display
- Operation ID: `post_terminal_readers_reader_set_reader_display`
- Route: `POST /v1/terminal/readers/{reader}/set_reader_display`
- Mode: WRITE
- Summary: Set reader display
- Parameters:
- `reader` in `path` required
- Body: JSON request body accepted.
### post_terminal_refunds
- Operation ID: `post_terminal_refunds`
- Route: `POST /v1/terminal/refunds`
- Mode: WRITE
- Summary: Create a refund using a Terminal-supported device.
- Body: JSON request body accepted.