Skip to main content

stages_invitation_invitations_create

POST 
/api/v3//stages/invitation/invitations/

Invitation Viewset

Request​

Body

required

    name stringrequired

    Possible values: non-empty and <= 50 characters, Value must match regular expression ^[-a-zA-Z0-9_]+$

    expires date-timenullable

    fixed_data

    object

    property name* any
    single_use boolean

    When enabled, the invitation will be deleted after usage.

    flow uuidnullable

    When set, only the configured flow can use this invitation.

Responses​

Schema

    pk uuidrequired
    name stringrequired

    Possible values: <= 50 characters, Value must match regular expression ^[-a-zA-Z0-9_]+$

    expires date-timenullable

    fixed_data

    object

    property name* any

    created_by

    object

    required

    Stripped down user serializer to show relevant users for groups

    pk ID (integer)required
    username stringrequired

    Required. 150 characters or fewer. Letters, digits and @/./+/-/_ only.

    Possible values: <= 150 characters, Value must match regular expression ^[\w.@+-]+$

    name stringrequired

    User's display name.

    is_active Active (boolean)

    Designates whether this user should be treated as active. Unselect this instead of deleting accounts.

    last_login date-timenullable
    email email

    Possible values: <= 254 characters

    attributes object
    uid stringrequired
    single_use boolean

    When enabled, the invitation will be deleted after usage.

    flow uuidnullable

    When set, only the configured flow can use this invitation.

    flow_obj

    object

    required

    Flow Serializer

    pk uuidrequired
    policybindingmodel_ptr_id uuidrequired
    name stringrequired
    slug stringrequired

    Visible in the URL.

    Possible values: <= 50 characters, Value must match regular expression ^[-a-zA-Z0-9_]+$

    title stringrequired

    Shown as the Title in Flow pages.

    designation FlowDesignationEnum (string)required

    Decides what this Flow is used for. For example, the Authentication flow is redirect to when an un-authenticated user visits authentik.

    Possible values: [authentication, authorization, invalidation, enrollment, unenrollment, recovery, stage_configuration]

    background stringrequired

    Get the URL to the background image. If the name is /static or starts with http it is returned as-is

    stages uuid[]required
    policies uuid[]required
    cache_count integerrequired

    Get count of cached flows

    policy_engine_mode PolicyEngineMode (string)

    Possible values: [all, any]

    compatibility_mode boolean

    Enable compatibility mode, increases compatibility with password managers on mobile devices.

    export_url stringrequired

    Get export URL for flow

    layout FlowLayoutEnum (string)

    Possible values: [stacked, content_left, content_right, sidebar_left, sidebar_right]

    denied_action DeniedActionEnum (string)

    Configure what should happen when a flow denies access to a user.

    Possible values: [message_continue, message, continue]

    authentication AuthenticationEnum (string)

    Required level of authentication and authorization to access a flow.

    Possible values: [none, require_authenticated, require_unauthenticated, require_superuser, require_outpost]

Authorization: http

name: authentiktype: httpscheme: bearer
var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Post, "/api/v3/stages/invitation/invitations/");
request.Headers.Add("Accept", "application/json");
request.Headers.Add("Authorization", "Bearer <TOKEN>");
var content = new StringContent("{\n  \"name\": \"string\",\n  \"expires\": \"2024-07-29T15:51:28.071Z\",\n  \"fixed_data\": {},\n  \"single_use\": true,\n  \"flow\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n}", null, "application/json");
request.Content = content;
var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
Console.WriteLine(await response.Content.ReadAsStringAsync());
Request Collapse all
Base URL
/api/v3
Auth
Body required
{
  "name": "string",
  "expires": "2024-07-29T15:51:28.071Z",
  "fixed_data": {},
  "single_use": true,
  "flow": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}