| 1 | /****************************************************************************** |
| 2 | * THIS FILE IS GENERATED - ANY EDITS WILL BE OVERWRITTEN |
| 3 | */ |
| 4 | |
| 5 | #pragma once |
| 6 | |
| 7 | #include <Quotient/jobs/basejob.h> |
| 8 | |
| 9 | namespace Quotient { |
| 10 | |
| 11 | /*! \brief Invite a user to participate in a particular room. |
| 12 | * |
| 13 | * *Note that there are two forms of this API, which are documented separately. |
| 14 | * This version of the API requires that the inviter knows the Matrix |
| 15 | * identifier of the invitee. The other is documented in the |
| 16 | * [third-party invites](/client-server-api/#third-party-invites) section.* |
| 17 | * |
| 18 | * This API invites a user to participate in a particular room. |
| 19 | * They do not start participating in the room until they actually join the |
| 20 | * room. |
| 21 | * |
| 22 | * Only users currently in a particular room can invite other users to |
| 23 | * join that room. |
| 24 | * |
| 25 | * If the user was invited to the room, the homeserver will append a |
| 26 | * `m.room.member` event to the room. |
| 27 | */ |
| 28 | class QUOTIENT_API InviteUserJob : public BaseJob { |
| 29 | public: |
| 30 | /*! \brief Invite a user to participate in a particular room. |
| 31 | * |
| 32 | * \param roomId |
| 33 | * The room identifier (not alias) to which to invite the user. |
| 34 | * |
| 35 | * \param userId |
| 36 | * The fully qualified user ID of the invitee. |
| 37 | * |
| 38 | * \param reason |
| 39 | * Optional reason to be included as the `reason` on the subsequent |
| 40 | * membership event. |
| 41 | */ |
| 42 | explicit InviteUserJob(const QString& roomId, const QString& userId, |
| 43 | const QString& reason = {}); |
| 44 | }; |
| 45 | |
| 46 | } // namespace Quotient |
| 47 | |