action daniweb_get_conversations_id_messages {
  label: "get_conversations_ID_messages"
  description: "Retrieve the last {limit} messages in the conversation, provided the conversations exist within the current access token's bubble. If a timeout is 0 or greater, the batch is sorted oldest first. Otherwise, if timeout is a negative number, the transcript is paginated and sorted newest first. Specify a timeout for long polling (which delays the server sending back results for up to n seconds or until results are available, whichever comes first), or default to 0 for immediate results. Optionally record your status as online along with sharing the latest message you've seen with the other conversation participant. Optionally specify a gt_message_id to retrieve only messages with an ID greater than that specified (such as greater than the latest message ID received in the last poll). Optionally only poll for messages authored by the other person in the conversation, and echo messages authored by you when sending, for a perceived increase in performance. Optionally only retrieve messages that were posted from within the current access token's bubble. Optionally specify a date formatted as YYYY-MM-DD to retrieve a transcript of messages from a single day. When record_seen is set to true, the new message count for the conversation is reset to zero."
  provider: daniweb
  method: GET
  path: "/conversations/{ID}/messages"
  encoding: json
  input: {
    type: "object"
    properties: {
      ID: {
        type: "integer"
        format: "int32"
      }
      bubbled: {
        type: "boolean"
      }
      date: {
        type: "string"
      }
      exclude_self: {
        type: "boolean"
      }
      gt_message_id: {
        type: "integer"
        format: "int32"
      }
      limit: {
        type: "integer"
        format: "int32"
      }
      offset: {
        type: "integer"
        format: "int32"
      }
      record_seen: {
        type: "boolean"
      }
      timeout: {
        type: "integer"
        format: "int32"
      }
    }
    required: ["ID"]
    additionalProperties: false
  }
  output: {
    type: "object"
    properties: {
      data: {
        type: "array"
        items: {
          type: "object"
          required: ["id"]
          properties: {
            author: {
              type: "object"
              required: ["id"]
              properties: {
                business_card: {
                  type: "object"
                  properties: {
                    company_name: {
                      type: "string"
                    }
                    company_size: {
                      type: "string"
                    }
                    headline: {
                      type: "string"
                    }
                    industry: {
                      type: "string"
                    }
                    interest_tags: {
                      type: "array"
                      items: {
                        type: "string"
                      }
                    }
                    job_position: {
                      type: "string"
                    }
                    summary: {
                      type: "string"
                    }
                    website: {
                      type: "object"
                      properties: {
                        thumbshot_uri: {
                          type: "string"
                          format: "uri"
                        }
                        url: {
                          type: "string"
                          format: "uri"
                        }
                      }
                    }
                  }
                }
                community_persona: {
                  type: "object"
                  required: ["id"]
                  properties: {
                    id: {
                      type: "number"
                      format: "int32"
                    }
                    identity: {
                      type: "object"
                      properties: {
                        avatar_uri: {
                          type: "string"
                          format: "uri"
                        }
                        badge: {
                          type: "string"
                        }
                        profile_url: {
                          type: "string"
                          format: "uri"
                        }
                        username: {
                          type: "string"
                        }
                      }
                    }
                    location: {
                      type: "object"
                      properties: {
                        free_form: {
                          type: "string"
                        }
                      }
                    }
                    personal: {
                      type: "object"
                      properties: {
                        about_me: {
                          type: "string"
                        }
                        birthday: {
                          type: "string"
                        }
                        interests: {
                          type: "string"
                        }
                        pc_specs: {
                          type: "string"
                        }
                      }
                    }
                    signature: {
                      type: "object"
                      properties: {
                        parsed: {
                          type: "string"
                        }
                        raw: {
                          type: "string"
                        }
                      }
                    }
                    stats: {
                      type: "object"
                      properties: {
                        answered_count: {
                          type: "number"
                          format: "int32"
                        }
                        endorsements_count: {
                          type: "number"
                          format: "int32"
                        }
                        posts_count: {
                          type: "number"
                          format: "int32"
                        }
                        reputation_count: {
                          type: "number"
                          format: "int32"
                        }
                      }
                    }
                  }
                }
                id: {
                  type: "number"
                  format: "int32"
                }
                profile: {
                  type: "object"
                  properties: {
                    first_name: {
                      type: "string"
                    }
                    last_name: {
                      type: "string"
                    }
                  }
                }
                usage: {
                  type: "object"
                  properties: {
                    available_status: {
                      type: "boolean"
                    }
                    joined_timestamp: {
                      type: "string"
                      format: "date-time"
                    }
                    last_activity_timestamp: {
                      type: "string"
                      format: "date-time"
                    }
                    online_status: {
                      type: "boolean"
                    }
                  }
                }
              }
            }
            conversation: {
              type: "object"
              required: ["id"]
              properties: {
                first_message: {
                  type: "object"
                  properties: {
                    author: {
                      type: "object"
                      additionalProperties: true
                    }
                    timestamp: {
                      type: "string"
                      format: "date-time"
                    }
                  }
                }
                id: {
                  type: "number"
                  format: "int32"
                }
                latest_message: {
                  type: "object"
                  additionalProperties: true
                }
                user_a: {
                  type: "object"
                  additionalProperties: true
                }
                user_b: {
                  type: "object"
                  additionalProperties: true
                }
              }
            }
            id: {
              type: "number"
              format: "int32"
            }
            last_seen: {
              type: "object"
              properties: {
                timestamp: {
                  type: "string"
                  format: "date-time"
                }
                user: {
                  type: "object"
                  additionalProperties: true
                }
              }
            }
            text: {
              type: "object"
              properties: {
                parsed: {
                  type: "string"
                }
              }
            }
            timestamp: {
              type: "string"
              format: "date-time"
            }
          }
        }
      }
      pagination: {
        type: "object"
        properties: {
          limit: {
            type: "number"
            format: "int32"
          }
          offset: {
            type: "number"
            format: "int32"
          }
          total_records: {
            type: "number"
            format: "int32"
          }
        }
      }
    }
  }
}