action daniweb_post_users_id_messages {
  label: "post_users_ID_messages"
  description: "Initiate a conversation with a user who exists within the current access token's bubble by sending them an introductory message. If you aren't already in a conversation with them, this endpoint meets them first, and then sends the message. Note that if you aren't in an existing conversation, you still must meet the criteria to meet them, meaning the user must currently be free for you to meet. You will receive an error message unless it is currently free for you to meet the user. You can use the users/{:IDS}/synergies endpoint to first determine if the user isn't already in a conversation with you and is free for you to meet and, if they aren't, how to pay to meet them. If you don't specify a message, it defaults to your custom introductory message defined in your settings."
  provider: daniweb
  method: POST
  path: "/users/{ID}/messages"
  encoding: json
  input: {
    type: "object"
    properties: {
      ID: {
        type: "integer"
        format: "int32"
      }
    }
    required: ["ID"]
    additionalProperties: false
  }
  output: {
    type: "object"
    properties: {
      data: {
        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"
          }
        }
      }
      success: {
        type: "boolean"
      }
    }
  }
}