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

name, description

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

disputes API Routes

Handle 9 OpenAPI operation(s) under /v2/disputes for the disputes 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_disputes

• Operation ID: list_disputes
• Route: GET /v2/disputes
• Mode: READ
• Summary: ListDisputes
• Parameters:
  • cursor in query
  • states in query
  • location_id in query

retrieve_dispute

• Operation ID: retrieve_dispute
• Route: GET /v2/disputes/{dispute_id}
• Mode: READ
• Summary: RetrieveDispute
• Parameters:
  • dispute_id in path required

accept_dispute

• Operation ID: accept_dispute
• Route: POST /v2/disputes/{dispute_id}/accept
• Mode: WRITE
• Summary: AcceptDispute
• Parameters:
  • dispute_id in path required

list_dispute_evidence

• Operation ID: list_dispute_evidence
• Route: GET /v2/disputes/{dispute_id}/evidence
• Mode: READ
• Summary: ListDisputeEvidence
• Parameters:
  • dispute_id in path required
  • cursor in query

create_dispute_evidence_file

• Operation ID: create_dispute_evidence_file
• Route: POST /v2/disputes/{dispute_id}/evidence-files
• Mode: WRITE
• Summary: CreateDisputeEvidenceFile
• Parameters:
  • dispute_id in path required
• Body: JSON request body accepted.

create_dispute_evidence_text

• Operation ID: create_dispute_evidence_text
• Route: POST /v2/disputes/{dispute_id}/evidence-text
• Mode: WRITE
• Summary: CreateDisputeEvidenceText
• Parameters:
  • dispute_id in path required
• Body: JSON request body accepted.

delete_dispute_evidence

• Operation ID: delete_dispute_evidence
• Route: DELETE /v2/disputes/{dispute_id}/evidence/{evidence_id}
• Mode: WRITE
• Summary: DeleteDisputeEvidence
• Parameters:
  • dispute_id in path required
  • evidence_id in path required

retrieve_dispute_evidence

• Operation ID: retrieve_dispute_evidence
• Route: GET /v2/disputes/{dispute_id}/evidence/{evidence_id}
• Mode: READ
• Summary: RetrieveDisputeEvidence
• Parameters:
  • dispute_id in path required
  • evidence_id in path required

submit_evidence

• Operation ID: submit_evidence
• Route: POST /v2/disputes/{dispute_id}/submit-evidence
• Mode: WRITE
• Summary: SubmitEvidence
• Parameters:
  • dispute_id in path required