Goodays events API

The events API from Goodays — 5 operation(s) for events.

OpenAPI Specification

goodays-events-api-openapi.yml Raw ↑
openapi: 3.0.0
info:
  title: Goodays core events API
  description: 'Goodays (formerly Critizr) REST API for managing your customer experience environment: places, levels, surveys, users, customer reviews (responses), solicitations (email/SMS outreach), events, and statistics. Reconstructed by API Evangelist from the per-endpoint OpenAPI fragments published on the Goodays ReadMe docs.'
  version: v2
servers:
- url: https://api.goodays.co/v2
security:
- tokenAuth: []
tags:
- name: events
paths:
  /events:
    get:
      operationId: events_list
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Event_read'
      tags:
      - events
  /events/{id}/sample_delegated:
    get:
      operationId: events_sample_delegated
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/EventSampleResponse_read'
      parameters:
      - name: id
        required: true
        in: path
        description: ''
        schema:
          type: string
      tags:
      - events
  /events/{id}/sample_message:
    get:
      operationId: events_sample_message
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/EventSampleMessage_read'
      parameters:
      - name: id
        required: true
        in: path
        description: ''
        schema:
          type: string
      tags:
      - events
  /events/{id}/sample_reply:
    get:
      operationId: events_sample_reply
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/EventSampleResponse_read'
      parameters:
      - name: id
        required: true
        in: path
        description: ''
        schema:
          type: string
      tags:
      - events
  /events/{id}/sample_response:
    get:
      operationId: events_sample_response
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/EventSampleResponse_read'
      parameters:
      - name: id
        required: true
        in: path
        description: ''
        schema:
          type: string
      tags:
      - events
components:
  schemas:
    Event_read:
      type: object
      properties:
        samples:
          type: string
      additionalProperties:
        type: string
    EventSampleMessage_read:
      type: object
      properties:
        event_type:
          type: string
        response:
          type: object
          properties:
            id:
              type: string
            token:
              type: string
            created_date:
              type: string
              format: date-time
            updated_date:
              type: string
              format: date-time
            source:
              type: string
              enum:
              - email
              - sms_trans
              - sms_conv
              - sms_text
              - plv
              - receipt
              - google
              - google_messaging
              - critizr
              - tripadvisor
              - pagesjaunes
              - sdk
              - facebook
              - facebook_reviews
              - facebook_messenger
              - widget
              - terminal
              - outbound_call
              - wifi
              - sms
              - api
              - undefined
              - merci
              - google_play_store
              - apple_app_store
              - uber_eats
              - whatsapp
            survey:
              type: object
              properties:
                id:
                  type: string
                slug:
                  type: string
                label:
                  type: string
                enabled:
                  type: boolean
                detail_url:
                  type: string
              additionalProperties:
                type: string
            answers:
              type: array
              items:
                type: object
                properties:
                  id:
                    type: string
                  value:
                    type: string
                  question:
                    type: object
                    properties:
                      id:
                        type: string
                      title:
                        type: string
                      type:
                        type: string
                        enum:
                        - none
                        - stars
                        - yesno
                        - choices
                        - nps
                        - emoji
                        - text
                        - multiple_answers
                        - csat
                      enabled:
                        type: boolean
                    additionalProperties:
                      type: string
                additionalProperties:
                  type: string
            message:
              type: object
              properties:
                id:
                  type: string
                created_date:
                  type: string
                  format: date-time
                type:
                  type: string
                  enum:
                  - Question
                  - Idea
                  - Problem
                  - Praise
                  - Message
                  - NoType
                content:
                  type: string
                attachment:
                  type: string
                sender:
                  type: object
                  properties:
                    email:
                      type: string
                    first_name:
                      type: string
                    last_name:
                      type: string
                  additionalProperties:
                    type: string
              additionalProperties:
                type: string
            reply:
              type: object
              properties:
                id:
                  type: string
                created_date:
                  type: string
                  format: date-time
                type:
                  type: string
                  enum:
                  - call
                  - text
                content:
                  type: string
                attachment:
                  type: string
                sender:
                  type: object
                  properties:
                    email:
                      type: string
                    first_name:
                      type: string
                    last_name:
                      type: string
                  additionalProperties:
                    type: string
              additionalProperties:
                type: string
            user:
              type: object
              properties:
                email:
                  type: string
                first_name:
                  type: string
                last_name:
                  type: string
                opt_in:
                  type: object
                  properties:
                    newsletter:
                      type: boolean
                    email:
                      type: boolean
                    sms:
                      type: boolean
                  additionalProperties:
                    type: string
              additionalProperties:
                type: string
            context:
              type: string
            place:
              type: object
              properties:
                id:
                  type: string
                partner_id:
                  type: string
                name:
                  type: string
                enabled:
                  type: boolean
                detail_url:
                  type: string
              additionalProperties:
                type: string
            delegated_to:
              type: object
              properties:
                id:
                  type: string
                partner_id:
                  type: string
                name:
                  type: string
                enabled:
                  type: boolean
                detail_url:
                  type: string
              additionalProperties:
                type: string
            attached_messages:
              type: array
              items:
                type: object
                properties:
                  id:
                    type: string
                  created_date:
                    type: string
                    format: date-time
                  type:
                    type: string
                    enum:
                    - Question
                    - Idea
                    - Problem
                    - Praise
                    - Message
                    - NoType
                  content:
                    type: string
                  attachment:
                    type: string
                  sender:
                    type: object
                    properties:
                      email:
                        type: string
                      first_name:
                        type: string
                      last_name:
                        type: string
                    additionalProperties:
                      type: string
                additionalProperties:
                  type: string
            state:
              type: string
              enum:
              - open
              - closed
              - spam
            thread:
              type: string
            actions:
              type: object
              additionalProperties:
                type: string
            alert_triggered:
              type: boolean
          additionalProperties:
            type: string
        message:
          type: object
          properties:
            id:
              type: string
            created_date:
              type: string
              format: date-time
            type:
              type: string
              enum:
              - Question
              - Idea
              - Problem
              - Praise
              - Message
              - NoType
            content:
              type: string
            attachment:
              type: string
            sender:
              type: object
              properties:
                email:
                  type: string
                first_name:
                  type: string
                last_name:
                  type: string
              additionalProperties:
                type: string
          additionalProperties:
            type: string
      additionalProperties:
        type: string
    EventSampleResponse_read:
      type: object
      properties:
        event_type:
          type: string
        response:
          type: object
          properties:
            id:
              type: string
            token:
              type: string
            created_date:
              type: string
              format: date-time
            updated_date:
              type: string
              format: date-time
            source:
              type: string
              enum:
              - email
              - sms_trans
              - sms_conv
              - sms_text
              - plv
              - receipt
              - google
              - google_messaging
              - critizr
              - tripadvisor
              - pagesjaunes
              - sdk
              - facebook
              - facebook_reviews
              - facebook_messenger
              - widget
              - terminal
              - outbound_call
              - wifi
              - sms
              - api
              - undefined
              - merci
              - google_play_store
              - apple_app_store
              - uber_eats
              - whatsapp
            survey:
              type: object
              properties:
                id:
                  type: string
                slug:
                  type: string
                label:
                  type: string
                enabled:
                  type: boolean
                detail_url:
                  type: string
              additionalProperties:
                type: string
            answers:
              type: array
              items:
                type: object
                properties:
                  id:
                    type: string
                  value:
                    type: string
                  question:
                    type: object
                    properties:
                      id:
                        type: string
                      title:
                        type: string
                      type:
                        type: string
                        enum:
                        - none
                        - stars
                        - yesno
                        - choices
                        - nps
                        - emoji
                        - text
                        - multiple_answers
                        - csat
                      enabled:
                        type: boolean
                    additionalProperties:
                      type: string
                additionalProperties:
                  type: string
            message:
              type: object
              properties:
                id:
                  type: string
                created_date:
                  type: string
                  format: date-time
                type:
                  type: string
                  enum:
                  - Question
                  - Idea
                  - Problem
                  - Praise
                  - Message
                  - NoType
                content:
                  type: string
                attachment:
                  type: string
                sender:
                  type: object
                  properties:
                    email:
                      type: string
                    first_name:
                      type: string
                    last_name:
                      type: string
                  additionalProperties:
                    type: string
              additionalProperties:
                type: string
            reply:
              type: object
              properties:
                id:
                  type: string
                created_date:
                  type: string
                  format: date-time
                type:
                  type: string
                  enum:
                  - call
                  - text
                content:
                  type: string
                attachment:
                  type: string
                sender:
                  type: object
                  properties:
                    email:
                      type: string
                    first_name:
                      type: string
                    last_name:
                      type: string
                  additionalProperties:
                    type: string
              additionalProperties:
                type: string
            user:
              type: object
              properties:
                email:
                  type: string
                first_name:
                  type: string
                last_name:
                  type: string
                opt_in:
                  type: object
                  properties:
                    newsletter:
                      type: boolean
                    email:
                      type: boolean
                    sms:
                      type: boolean
                  additionalProperties:
                    type: string
              additionalProperties:
                type: string
            context:
              type: string
            place:
              type: object
              properties:
                id:
                  type: string
                partner_id:
                  type: string
                name:
                  type: string
                enabled:
                  type: boolean
                detail_url:
                  type: string
              additionalProperties:
                type: string
            delegated_to:
              type: object
              properties:
                id:
                  type: string
                partner_id:
                  type: string
                name:
                  type: string
                enabled:
                  type: boolean
                detail_url:
                  type: string
              additionalProperties:
                type: string
            attached_messages:
              type: array
              items:
                type: object
                properties:
                  id:
                    type: string
                  created_date:
                    type: string
                    format: date-time
                  type:
                    type: string
                    enum:
                    - Question
                    - Idea
                    - Problem
                    - Praise
                    - Message
                    - NoType
                  content:
                    type: string
                  attachment:
                    type: string
                  sender:
                    type: object
                    properties:
                      email:
                        type: string
                      first_name:
                        type: string
                      last_name:
                        type: string
                    additionalProperties:
                      type: string
                additionalProperties:
                  type: string
            state:
              type: string
              enum:
              - open
              - closed
              - spam
            thread:
              type: string
            actions:
              type: object
              additionalProperties:
                type: string
            alert_triggered:
              type: boolean
          additionalProperties:
            type: string
      additionalProperties:
        type: string
  securitySchemes:
    tokenAuth:
      type: apiKey
      in: header
      name: Authorization
      description: Personal access token supplied verbatim in the Authorization header (no Bearer prefix). Obtain from your Goodays account manager.