invites

type GroupInvitesInput struct {
	GroupID      toolutil.StringOrInt `json:"group_id" jsonschema:"Group ID or URL-encoded path,required"`
	ID           toolutil.StringOrInt `` /* 147-byte string literal not displayed */
	Email        string               `json:"email,omitempty" jsonschema:"Email address to invite (either email or user_id required)"`
	UserID       int64                `json:"user_id,omitempty" jsonschema:"User ID to invite (either email or user_id required)"`
	AccessLevel  int                  `` /* 219-byte string literal not displayed */
	ExpiresAt    string               `json:"expires_at,omitempty" jsonschema:"Expiration date for the invitation (YYYY-MM-DD)"`
	InviteSource string               `json:"invite_source,omitempty" jsonschema:"Source of the invitation that starts the member creation process"`
	MemberRoleID int64                `json:"member_role_id,omitempty" jsonschema:"Custom role to assign the new member (Ultimate only)" tier:"ultimate"`
}

type InviteResultOutput struct {
	toolutil.HintableOutput
	Status  string            `json:"status"`
	Message map[string]string `json:"message,omitempty"`
	// QueuedUsers is what GitLab answers with instead of inviting outright when
	// the instance has member promotion management enabled: the username of
	// each invitee whose promotion an administrator has to approve, against the
	// reason it was queued. That setting is Ultimate on GitLab Self-Managed and
	// GitLab Dedicated only, hence the tier tag. Documented in invitations.md
	// and absent from gl.InvitesResult, so it arrives through the raw request
	// the handlers issue.
	QueuedUsers map[string]string `json:"queued_users,omitempty" tier:"ultimate"`
}

type ListPendingGroupInvitationsInput struct {
	GroupID toolutil.StringOrInt `json:"group_id" jsonschema:"Group ID or URL-encoded path,required"`
	Query   string               `json:"query,omitempty" jsonschema:"Filter invitations by email or name"`
	OrderBy string               `json:"order_by,omitempty" jsonschema:"Column to order keyset-paginated results by"`
	Sort    string               `json:"sort,omitempty" jsonschema:"Sort order for keyset-paginated results: 'asc' or 'desc'"`
	toolutil.PaginationInput
	toolutil.KeysetPaginationInput
}

type ListPendingInvitationsOutput struct {
	toolutil.HintableOutput
	Invitations []PendingInviteOutput     `json:"invitations"`
	Pagination  toolutil.PaginationOutput `json:"pagination"`
}

type ListPendingProjectInvitationsInput struct {
	ProjectID toolutil.StringOrInt `json:"project_id" jsonschema:"Project ID or URL-encoded path,required"`
	Query     string               `json:"query,omitempty" jsonschema:"Filter invitations by email or name"`
	OrderBy   string               `json:"order_by,omitempty" jsonschema:"Column to order keyset-paginated results by"`
	Sort      string               `json:"sort,omitempty" jsonschema:"Sort order for keyset-paginated results: 'asc' or 'desc'"`
	toolutil.PaginationInput
	toolutil.KeysetPaginationInput
}

type PendingInviteOutput struct {
	InviteEmail string `json:"invite_email"`
	// InviteToken is what lib/api/entities/invitation.rb sends beside the
	// address and client-go's PendingInvite does not model: the token the
	// invitation URL is built from, exposed under no condition. It is carried
	// in the JSON and deliberately left out of the Markdown, where a rendered
	// table would paste a live credential into the conversation.
	//
	// Keeping it in the JSON is a decision rather than an oversight, taken
	// after a security review asked for its removal. GitLab sends it to any
	// caller whose token can list invitations, so dropping it here would not
	// deny anyone the value; it would only make this server misreport what the
	// endpoint returns, which this project treats as a defect of its own. The
	// Markdown exclusion is where the line is drawn: the transcript is the
	// surface a person reads without asking for it.
	InviteToken   string `json:"invite_token,omitempty"`
	CreatedAt     string `json:"created_at,omitempty"`
	AccessLevel   int    `json:"access_level"`
	ExpiresAt     string `json:"expires_at,omitempty"`
	UserName      string `json:"user_name,omitempty"`
	CreatedByName string `json:"created_by_name,omitempty"`
}

type ProjectInvitesInput struct {
	ProjectID    toolutil.StringOrInt `json:"project_id" jsonschema:"Project ID or URL-encoded path,required"`
	ID           toolutil.StringOrInt `` /* 151-byte string literal not displayed */
	Email        string               `json:"email,omitempty" jsonschema:"Email address to invite (either email or user_id required)"`
	UserID       int64                `json:"user_id,omitempty" jsonschema:"User ID to invite (either email or user_id required)"`
	AccessLevel  int                  `` /* 219-byte string literal not displayed */
	ExpiresAt    string               `json:"expires_at,omitempty" jsonschema:"Expiration date for the invitation (YYYY-MM-DD)"`
	InviteSource string               `json:"invite_source,omitempty" jsonschema:"Source of the invitation that starts the member creation process"`
	MemberRoleID int64                `json:"member_role_id,omitempty" jsonschema:"Custom role to assign the new member (Ultimate only)" tier:"ultimate"`
}