Agile CRM HelpDesk API

The HelpDesk API from Agile CRM — 5 operation(s) for helpdesk.

OpenAPI Specification

agile-crm-helpdesk-api-openapi.yml Raw ↑
openapi: 3.1.0
info:
  title: Agile CRM REST Campaigns HelpDesk API
  version: 1.0.0
  description: HTTPS-only REST API for managing contacts, companies, deals (opportunities), campaigns, tasks, events, notes,
    tracks, tickets, and documents in Agile CRM. Authentication is HTTP Basic with account email as username and REST client
    API key as password.
  contact:
    name: Agile CRM
    url: https://www.agilecrm.com/api
servers:
- url: https://{domain}.agilecrm.com/dev
  description: Tenant-scoped base URL
  variables:
    domain:
      default: mydomain
      description: Your Agile CRM tenant subdomain
security:
- BasicAuth: []
tags:
- name: HelpDesk
paths:
  /api/notes/{ticket_id}:
    post:
      tags:
      - HelpDesk
      summary: Add note to a ticket
      parameters:
      - name: ticket_id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Note added
      operationId: addTicketNote
  /api/tickets/filter:
    get:
      tags:
      - HelpDesk
      summary: Retrieve all tickets
      responses:
        '200':
          description: Tickets
      operationId: listTickets
  /api/tickets/filters:
    get:
      tags:
      - HelpDesk
      summary: Get filter IDs
      responses:
        '200':
          description: Filters
      operationId: listTicketFilters
  /api/tickets/new-ticket:
    post:
      tags:
      - HelpDesk
      summary: Create a ticket
      responses:
        '200':
          description: Ticket created
      operationId: createTicket
  /api/tickets/notes/{ticket_id}:
    get:
      tags:
      - HelpDesk
      summary: Get ticket messages
      parameters:
      - name: ticket_id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Messages
      operationId: listTicketMessages
  /api/tickets/{id}:
    delete:
      tags:
      - HelpDesk
      summary: Delete a ticket
      parameters:
      - $ref: '#/components/parameters/Id'
      responses:
        '204':
          description: Ticket deleted
      operationId: deleteTicket
components:
  parameters:
    Id:
      name: id
      in: path
      required: true
      schema:
        type: string
  securitySchemes:
    BasicAuth:
      type: http
      scheme: basic
      description: HTTP Basic auth - username is account email, password is REST client API key.