square-connect-openapi-agent/skills/invoices/SKILL.md

name, description

name	description
invoices-routes	Handle 10 OpenAPI operation(s) under /v2/invoices for the invoices route group.

invoices API Routes

Handle 10 OpenAPI operation(s) under /v2/invoices for the invoices 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

list_invoices

• Operation ID: list_invoices
• Route: GET /v2/invoices
• Mode: READ
• Summary: ListInvoices
• Parameters:
  • location_id in query required
  • cursor in query
  • limit in query

create_invoice

• Operation ID: create_invoice
• Route: POST /v2/invoices
• Mode: WRITE
• Summary: CreateInvoice
• Body: JSON request body accepted.

search_invoices

• Operation ID: search_invoices
• Route: POST /v2/invoices/search
• Mode: WRITE
• Summary: SearchInvoices
• Body: JSON request body accepted.

delete_invoice

• Operation ID: delete_invoice
• Route: DELETE /v2/invoices/{invoice_id}
• Mode: WRITE
• Summary: DeleteInvoice
• Parameters:
  • invoice_id in path required
  • version in query

get_invoice

• Operation ID: get_invoice
• Route: GET /v2/invoices/{invoice_id}
• Mode: READ
• Summary: GetInvoice
• Parameters:
  • invoice_id in path required

update_invoice

• Operation ID: update_invoice
• Route: PUT /v2/invoices/{invoice_id}
• Mode: WRITE
• Summary: UpdateInvoice
• Parameters:
  • invoice_id in path required
• Body: JSON request body accepted.

create_invoice_attachment

• Operation ID: create_invoice_attachment
• Route: POST /v2/invoices/{invoice_id}/attachments
• Mode: WRITE
• Summary: CreateInvoiceAttachment
• Parameters:
  • invoice_id in path required
• Body: JSON request body accepted.

delete_invoice_attachment

• Operation ID: delete_invoice_attachment
• Route: DELETE /v2/invoices/{invoice_id}/attachments/{attachment_id}
• Mode: WRITE
• Summary: DeleteInvoiceAttachment
• Parameters:
  • invoice_id in path required
  • attachment_id in path required

cancel_invoice

• Operation ID: cancel_invoice
• Route: POST /v2/invoices/{invoice_id}/cancel
• Mode: WRITE
• Summary: CancelInvoice
• Parameters:
  • invoice_id in path required
• Body: JSON request body accepted.

publish_invoice

• Operation ID: publish_invoice
• Route: POST /v2/invoices/{invoice_id}/publish
• Mode: WRITE
• Summary: PublishInvoice
• Parameters:
  • invoice_id in path required
• Body: JSON request body accepted.