openapi: 3.2.0
info:
  title: Avochato Contacts API
  version: '2026-09-27'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-09-27: 18 operation(s) read from 1 public documentation page(s) (each operation names its page in x-source). This is not the provider''s published contract; Avochato has published no machine-readable contract that the pipeline could find. Engine: local.'
  x-evidence-tiers:
    code-example: 28
    documentation: -10
    pages-with-code: 1
    pages-read: 1
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-09-27'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:
  - https://www.avochato.com/docs
servers:
- url: https://ww
tags:
- name: Contacts
paths:
  /v1/contacts/2jRbk681Pv:
    get:
      operationId: get_v1_contacts_2jRbk681Pv
      tags:
      - Contacts
      summary: Fetch Contacts
      x-source: https://www.avochato.com/docs
      parameters:
      - name: auth_id
        in: query
        required: true
        schema:
          type: string
        description: Auth Id field
      - name: auth_secret
        in: query
        required: true
        schema:
          type: string
        description: Authentication Secret field
      - name: page
        in: query
        required: false
        schema:
          type: string
        description: Page to request
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetV1Contacts2Jrbk681PvResponse'
      x-evidence:
        kind: documentation
  /v1/contacts/2jRbk681Pv%2CenL8alJ7Nw:
    get:
      operationId: get_v1_contacts_2jRbk681Pv_2CenL8alJ7Nw
      tags:
      - Contacts
      summary: GET /v1/contacts/2jRbk681Pv%2CenL8alJ7Nw
      x-source: https://www.avochato.com/docs
      parameters:
      - name: auth_id
        in: query
        required: false
        schema:
          type: string
      - name: auth_secret
        in: query
        required: false
        schema:
          type: string
      - name: page
        in: query
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetV1Contacts2Jrbk681Pv2Cenl8Alj7NwResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -g \"https://www.avochato.com/v1/contacts/2jRbk681Pv%2CenL8alJ7Nw?auth_id=xDjJBRJoOe&auth_secret=YYYYYYYYYYYYYYYYYYYY&page=1\" -X GET  -H \"Version: HTTP/1.0\"  -H \"Content-Type: application/json\"  -H \"Host: www.avochato.com\" \n Response \n Simulated Response \n Status \n 200 \n Headers \n Content-Type: application/json; charset=utf-8\nX-Request-Id: 27808e3b-61c0-41ce-bd2d-38042d7e2f17\nX-Runtime: 0.1188"
  /v1/contacts/RkAJvDlb0o/events:
    post:
      operationId: post_v1_contacts_RkAJvDlb0o_events
      tags:
      - Contacts
      summary: POST /v1/contacts/RkAJvDlb0o/events
      x-source: https://www.avochato.com/docs
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostV1ContactsRkajvdlb0OEventsRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl \"https://www.avochato.com/v1/contacts/RkAJvDlb0o/events\" -d '{\"auth_id\":\"xoWbqYbqnB\",\"auth_secret\":\"YYYYYYYYYYYYYYYYYYYY\",\"type\":\"sale\",\"context\":\"Wanted a new watch ($99.99) with no warranty\",\"revenue\":99.99}' -X POST  -H \"Version: HTTP/1.0\"  -H \"Content-Type: application/json\"  -H \"Host: www.avochato.com\" \n Response \n Simulated Response \n Status \n 200 \n Headers \n Content-Type: application/j"
  /v1/contacts/remove_all:
    delete:
      operationId: delete_v1_contacts_remove_all
      tags:
      - Contacts
      summary: DELETE /v1/contacts/remove_all
      x-source: https://www.avochato.com/docs
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DeleteV1ContactsRemoveAllRequest'
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl \"https://www.avochato.com/v1/contacts/remove_all\" -d '{\"auth_id\":\"BLP9Me9qYX\",\"auth_secret\":\"YYYYYYYYYYYYYYYYYYYY\",\"query\":null}' -X DELETE  -H \"Version: HTTP/1.0\"  -H \"Content-Type: application/json\"  -H \"Host: www.avochato.com\" \n Response \n Simulated Response \n Status \n 200 \n Headers \n Content-Type: application/json; charset=utf-8\nX-Request-Id: acb356fd-64b7-4d8b-8568-5570a4d908da\nX-Runtime"
components:
  schemas:
    GetV1Contacts2Jrbk681Pv2Cenl8Alj7NwResponse:
      type: object
      properties:
        contacts:
          type: array
          items:
            type: object
            properties:
              id:
                type: string
              name:
                type: string
              phone:
                type: string
              email:
                type: string
              street:
                type:
                - string
                - 'null'
              city:
                type: string
              state:
                type: string
              zip:
                type: string
              country:
                type: string
              address:
                type: string
              notes:
                type:
                - string
                - 'null'
              company:
                type: string
              other_phone:
                type:
                - string
                - 'null'
              created_at:
                type: number
              tags:
                type: array
                items:
                  type: string
              tag_details:
                type: array
                items:
                  type: object
                  properties:
                    name:
                      type: string
                    color:
                      type:
                      - string
                      - 'null'
                    duration:
                      type:
                      - string
                      - 'null'
                    routable:
                      type:
                      - string
                      - 'null'
              opted_out:
                type: boolean
              double_opted_in:
                type: boolean
              muted:
                type: boolean
              blocked:
                type: boolean
              salesforce_object_type:
                type:
                - string
                - 'null'
              salesforce_object_id:
                type:
                - string
                - 'null'
              priority:
                type: integer
              user_id:
                type:
                - string
                - 'null'
              visible:
                type: boolean
              current_owner:
                type:
                - string
                - 'null'
              due_for_compliance:
                type: boolean
    DeleteV1ContactsRemoveAllRequest:
      type: object
      properties:
        auth_id:
          type: string
        auth_secret:
          type: string
        query:
          type:
          - string
          - 'null'
    PostV1ContactsRkajvdlb0OEventsRequest:
      type: object
      properties:
        auth_id:
          type: string
        auth_secret:
          type: string
        type:
          type: string
        context:
          type: string
        revenue:
          type: number
    GetV1Contacts2Jrbk681PvResponse:
      type: object
      properties:
        status:
          type: integer
          description: HTTP status code
        data.contacts:
          type: array
          description: Array of contact objects
        page:
          type: integer
          description: Current page number