action daniweb_post_users_invites {
  label: "post_users_invites"
  description: "Invite users to into your current access token's bubble by having Dazah send out email invitations on your behalf. The invitation sends users to begin the OAuth flow for the current application (based on the settings specified in the application's profile), and therefore they will be redirected to the application upon signing up / logging in. Upon doing so, if they aren't already, they will automatically be connected with you as well. If your current access token does not escape the bubble, the invitation will specify you wish to connect within the application's name. If your current access token escapes the bubble, the invitation will specify you wish to connect within Dazah. Submit either a list of emails, or a LinkedIn or Outlook CSV file. You can retrieve your LinkedIn CSV file by exporting your LinkedIn Connections at https://www.linkedin.com/people/export-settings. You can retrieve your Outlook CSV file by using the Outlook Import and Export Wizard. This endpoint buckets the invitations into four categories: Existing invites are existing users who are already connected with you within the current bubble, and are therefore not emailed; Discovered invites are existing Dazah users who are available to be connected with within the current bubble, and are therefore not emailed. Now that they have been discovered, the users/{:ID}/meet API endpoint may be used to connect with them; Invalid invites are existing Dazah users who are unavailable to be connected with, because they have deactivated accounts, are muting you, etc., and are therefore not emailed; Emailed invites are queued to receive an invitation within approximately 1 hour. Note that if you are attempting to invite an existing Dazah user who does not currently exist within your current access token's bubble, they will fall within the Discovered bucket if your current access token escapes the bubble, but will be emailed an invitation to join the application if your current access token does not escape the bubble."
  provider: daniweb
  method: POST
  path: "/users/invites"
  encoding: json
  output: {
    type: "object"
    properties: {
      data: {
        type: "object"
        properties: {
          discovered: {
            type: "object"
            properties: {
              users: {
                type: "array"
                items: {
                  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"
                        }
                      }
                    }
                  }
                }
              }
            }
          }
          emailed: {
            type: "object"
            properties: {
              emails: {
                type: "array"
                items: {
                  type: "string"
                }
              }
            }
          }
          existing: {
            type: "object"
            properties: {
              conversations: {
                type: "array"
                items: {
                  type: "object"
                  additionalProperties: true
                }
              }
            }
          }
          invalid: {
            type: "object"
            properties: {
              emails: {
                type: "array"
                items: {
                  type: "string"
                }
              }
            }
          }
        }
      }
      success: {
        type: "boolean"
      }
    }
  }
}