Skip to main content

failed_invitations

Creates, updates, deletes, gets or lists a failed_invitations resource.

Overview

Namefailed_invitations
TypeResource
Idgithub.orgs.failed_invitations

Fields

The following fields are returned by SELECT queries:

Response

NameDatatypeDescription
idinteger (int64)
node_idstring (example: "MDIyOk9yZ2FuaXphdGlvbkludml0YXRpb24x")
created_atstring
emailstring
failed_atstring
failed_reasonstring
invitation_sourcestring (example: "member")
invitation_teams_urlstring (example: "https://api.github.com/organizations/16/invitations/1/teams")
inviterobjectA GitHub user. (title: Simple User)
loginstring
rolestring
team_countinteger

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
list_failed_invitationsselectorgper_page, pageThe return hash contains failed_at and failed_reason fields which represent the time at which the invitation failed and the reason for the failure.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
orgstringThe organization name. The name is not case sensitive.
pageintegerThe page number of the results to fetch. For more information, see "Using pagination in the REST API."
per_pageintegerThe number of results per page (max 100). For more information, see "Using pagination in the REST API."

SELECT examples

The return hash contains failed_at and failed_reason fields which represent the time at which the invitation failed and the reason for the failure.

SELECT
id,
node_id,
created_at,
email,
failed_at,
failed_reason,
invitation_source,
invitation_teams_url,
inviter,
login,
role,
team_count
FROM github.orgs.failed_invitations
WHERE org = '{{ org }}' -- required
AND per_page = '{{ per_page }}'
AND page = '{{ page }}'
;