openapi

package
v1.0.25 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Jul 17, 2026 License: Apache-2.0 Imports: 16 Imported by: 1

Documentation

Overview

Package openapi provides http request and response structs

Index

Constants

View Source
const (
	// MinImpersonationReasonLength is the minimum length for impersonation reason
	MinImpersonationReasonLength = 10
	// MaxImpersonationReasonLength is the maximum length for impersonation reason
	MaxImpersonationReasonLength = 500
)

Variables

View Source
var ExampleAccountAccessResponse = AccountAccessResponse{
	Reply:   rout.Reply{Success: true},
	Allowed: true,
}

ExampleAccountAccessResponse is an example of a successful `/account/access` response for OpenAPI documentation

View Source
var ExampleAccountRolesResponse = AccountRolesResponse{
	Reply: rout.Reply{Success: true},
	Roles: []string{"can_view", "can_edit", "audit_log_viewer"},
}

ExampleAccountRolesResponse is an example of a successful `/account/roles` response for OpenAPI documentation

View Source
var ExampleAcmeSolverRequest = AcmeSolverRequest{
	Path: "01J4HMNDSZCCQBTY93BF9CBF5D",
}

ExampleAcmeSolverRequest is an example ACME solver request for OpenAPI documentation

View Source
var ExampleAvailableAuthTypeSuccessResponse = AvailableAuthTypeResponse{
	Reply: rout.Reply{
		Success: true,
	},
	Methods: []enums.AuthProvider{
		enums.AuthProviderCredentials,
		enums.AuthProviderWebauthn,
	},
}

ExampleAvailableAuthTypeSuccessResponse is an example of a successful available auth methods check response for OpenAPI documentation

View Source
var ExampleConfigureIntegrationRequest = ConfigureIntegrationRequest{
	DefinitionID: "def_01K0GCPSCC00000000000000001",
	Body:         json.RawMessage(`{"organizationId":"123456789","serviceAccountKey":"{\"type\":\"service_account\",\"project_id\":\"my-project\"}"}`),
}

ExampleConfigureIntegrationRequest is an example configuration payload for OpenAPI documentation.

View Source
var ExampleCreateTrustCenterAnonymousJWTResponse = CreateTrustCenterAnonymousJWTResponse{
	AuthData: AuthData{
		AccessToken:  "access_token_here",
		RefreshToken: "refresh_token_here",
	},
}

ExampleCreateTrustCenterAnonymousJWTResponse is an example trust center anonymous JWT response for OpenAPI documentation

View Source
var ExampleEndImpersonationRequest = EndImpersonationRequest{
	SessionID: exampleULID("session"),
	Reason:    "Support task completed",
}

ExampleEndImpersonationRequest is an example request for OpenAPI documentation

View Source
var ExampleEndImpersonationResponse = EndImpersonationResponse{
	Reply:   rout.Reply{Success: true},
	Message: "Impersonation session ended successfully",
}

ExampleEndImpersonationResponse is an example response for OpenAPI documentation

View Source
var ExampleExampleCSVRequest = ExampleCSVRequest{
	Filename: "actionplan",
}

ExampleLoginSuccessRequest is an example of a successful tfa validation request for OpenAPI documentation

View Source
var ExampleFileDownloadRequest = FileDownload{
	Token: "token",
}

ExampleVerifySuccessRequest is an example of a successful verify request for OpenAPI documentation

View Source
var ExampleIntegrationAuthStartRequest = IntegrationAuthStartRequest{
	DefinitionID: "def_01K0SLACK000000000000000001",
}

ExampleIntegrationAuthStartRequest is an example auth start request for OpenAPI documentation.

View Source
var ExampleOAuthFlowResponse = OAuthFlowResponse{
	Reply:         rout.Reply{Success: true},
	AuthURL:       "https://github.com/login/oauth/authorize?client_id=...&state=eyJvcmdJRCI6IjAxSE...",
	State:         "eyJvcmdJRCI6IjAxSE...",
	Message:       "",
	RequiresLogin: false,
}

ExampleOAuthFlowResponse is an example OAuth flow response for OpenAPI documentation

View Source
var ExampleOauthTokenRequest = OauthTokenRequest{
	Name:             "Jon Snow",
	Email:            "jsnow@example.com",
	AuthProvider:     "google",
	ExternalUserID:   "1234567890",
	ExternalUserName: "jsnow",
	ClientToken:      "example-client-token-12345",
	Image:            "https://example.com/avatar.jpg",
}

ExampleOauthTokenRequest is an example OAuth token request for OpenAPI documentation

View Source
var ExampleRolesResponse = RolesResponse{
	Reply: rout.Reply{Success: true},
	Roles: []OrganizationRole{
		{
			ID:          "policy_manager",
			Name:        "Policy Manager",
			Description: "Can manage all policies and procedures",
		},
		{
			ID:          "risk_manager",
			Name:        "Risk Manager",
			Description: "Can manage risks, vulnerabilities, and findings",
		},
	},
}

ExampleRolesResponse is an example of a successful `/roles` response for OpenAPI documentation

View Source
var ExampleRunIntegrationOperationRequest = RunIntegrationOperationRequest{
	IntegrationID: "01J4HMNDSZCCQBTY93BF9CBF5D",
	Body: RunIntegrationOperationBody{
		Operation: "HealthCheck",
	},
}

ExampleRunIntegrationOperationRequest is an example operation payload for OpenAPI documentation.

View Source
var ExampleSSOCallbackRequest = SSOCallbackRequest{
	Code:           "code",
	State:          "state",
	OrganizationID: exampleULID("organization"),
}

ExampleSSOCallbackRequest is an example request for OpenAPI documentation

View Source
var ExampleSSOLoginRequest = SSOLoginRequest{
	OrganizationID: exampleULID("organization"),
	ReturnURL:      "https://app.sitb.com",
}

ExampleSSOLoginRequest is an example request for OpenAPI documentation

View Source
var ExampleSSOStatusRequest = SSOStatusRequest{
	Resource: "acct:mitb@theopenlane.io",
}

ExampleSSOStatusRequest is an example request for OpenAPI documentation

View Source
var ExampleSSOStatusResponse = SSOStatusResponse{
	Reply:          rout.Reply{Success: true},
	Enforced:       true,
	Provider:       enums.SSOProviderOkta,
	DiscoveryURL:   "https://id.example.com/.well-known/openid-configuration",
	SAMLSignInURL:  "https://id.example.com/saml/signin",
	OrganizationID: exampleULID("organization_alt"),
	OrgTFAEnforced: true,
	UserTFAEnabled: false,
}

ExampleSSOStatusResponse is an example response for OpenAPI documentation

View Source
var ExampleSSOTokenAuthorizeRequest = SSOTokenAuthorizeRequest{
	OrganizationID: exampleULID("organization"),
	TokenID:        exampleULID("token"),
	TokenType:      "api",
}

ExampleSSOTokenAuthorizeRequest is an example request for OpenAPI documentation

View Source
var ExampleSSOTokenAuthorizeResponse = SSOTokenAuthorizeResponse{
	Reply:          rout.Reply{Success: true},
	OrganizationID: exampleULID("organization"),
	TokenID:        exampleULID("token"),
	Message:        "success",
}

ExampleSSOTokenAuthorizeResponse is an example response for OpenAPI documentation

View Source
var ExampleSSOTokenCallbackRequest = SSOTokenCallbackRequest{
	Code:  "code",
	State: "state",
}

ExampleSSOTokenCallbackRequest is an example request for OpenAPI documentation

View Source
var ExampleScopesResponse = ScopesResponse{
	Reply: rout.Reply{Success: true},
	Scopes: map[string][]string{
		"internal_policy": {"read", "write", "delete"},
		"procedure":       {"read", "write", "delete"},
		"control":         {"read", "write", "delete"},
	},
}

ExampleScopesResponse is an example of a successful `/scopes` response for OpenAPI documentation

View Source
var ExampleSnapshotSuccessRequest = SnapshotRequest{
	URL:             "https://www.example.com",
	WaitForSelector: "img#main-image",
}

ExampleSnapshotSuccessRequest is an example of a successful snapshot request for OpenAPI documentation

View Source
var ExampleSnapshotSuccessResponse = SnapshotResponse{
	Reply:    rout.Reply{Success: true},
	Message:  "Snapshot taken successfully",
	Image:    "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mP8/x8AAwMCAO3Zf6kAAAAASUVORK5CYII=",
	MIMEType: "image/png",
}

ExampleSnapshotSuccessResponse is an example of a successful snapshot response for OpenAPI documentation

View Source
var ExampleStartImpersonationRequest = StartImpersonationRequest{
	TargetUserID: exampleULID("user_alt"),
	Type:         "support",
	Reason:       "Customer support assistance for account recovery",
	Duration:     nil,
}

ExampleStartImpersonationRequest is an example request for OpenAPI documentation

View Source
var ExampleStartImpersonationResponse = StartImpersonationResponse{
	Reply:     rout.Reply{Success: true},
	Token:     "imp_" + exampleULID("token"),
	ExpiresAt: exampleTime(time.Hour),
	SessionID: exampleULID("session"),
	Message:   "Impersonation session started successfully",
}

ExampleStartImpersonationResponse is an example response for OpenAPI documentation

View Source
var ExampleSupportAccessResponse = SupportAccessResponse{
	Reply:     rout.Reply{Success: true},
	AuthData:  AuthData{Session: "session"},
	Token:     "imp_" + exampleULID("token"),
	ExpiresAt: exampleTime(time.Hour),
	SessionID: exampleULID("session"),
	Message:   "Support access session started successfully",
}

ExampleSupportAccessResponse is an example response for OpenAPI documentation

View Source
var ExampleSupportCallbackRequest = SupportCallbackRequest{
	Code:  "authcode123",
	State: "state123",
}

ExampleSupportCallbackRequest is an example request for OpenAPI documentation

View Source
var ExampleTFASSuccessResponse = TFAResponse{
	Reply: rout.Reply{
		Success: true,
	},
}

ExampleLoginSuccessResponse is an example of a successful tfa validation response for OpenAPI documentation

View Source
var ExampleTFASuccessRequest = TFARequest{
	TOTPCode: "113371",
}

ExampleLoginSuccessRequest is an example of a successful tfa validation request for OpenAPI documentation

View Source
var ExampleUploadFileRequest = UploadFilesRequest{
	UploadFile: multipart.FileHeader{
		Filename: "file.txt",
		Size:     1024,
		Header: textproto.MIMEHeader{
			"Content-Type": []string{"text/plain"},
		},
	},
}

ExampleUploadFileRequest is an example of a successful upload request for OpenAPI documentation

View Source
var ExampleUploadFilesSuccessResponse = UploadFilesResponse{
	Reply: rout.Reply{
		Success: true,
	},
	Message:   "file(s) uploaded successfully",
	FileCount: 1,
	Files: []File{
		{
			ID:           "1234",
			OriginalName: "file.txt",
			MD5:          []byte("1234"),
			CreatedAt:    exampleTime(-time.Hour),
			UpdatedAt:    exampleTime(0),
		},
	},
}

ExampleUploadFilesSuccessResponse is an example of a successful upload response for OpenAPI documentation

View Source
var ExampleUserInfoSuccessResponse = UserInfoResponse{
	Reply:           rout.Reply{Success: true},
	ID:              "01J4EXD5MM60CX4YNYN0DEE3Y1",
	Email:           "jsnow@example.com",
	FirstName:       "Jon",
	LastName:        "Snow",
	DisplayName:     "Jon Snow",
	AvatarRemoteURL: stringPtr("https://example.com/avatar.jpg"),
	LastSeen:        stringPtr("2023-01-01T00:00:00Z"),
	Role:            "ADMIN",
	Sub:             "user123",
}

ExampleUserInfoSuccessResponse is an example of a successful userinfo response for OpenAPI documentation

View Source
var ExampleWebauthnBeginLoginResponse = WebauthnBeginLoginResponse{
	Reply:   rout.Reply{Success: true},
	Session: "session123",
}

ExampleWebauthnBeginLoginResponse is an example WebAuthn begin login response for OpenAPI documentation

View Source
var ExampleWebauthnBeginRegistrationRequest = WebauthnRegistrationRequest{
	Email: "sarahisthebest@sarahsthebest.com",
	Name:  "Sarah Funk",
}
View Source
var ExampleWebauthnBeginRegistrationResponse = WebauthnBeginRegistrationResponse{
	Reply: rout.Reply{Success: true},
	CredentialCreation: &protocol.CredentialCreation{
		Response: protocol.PublicKeyCredentialCreationOptions{
			RelyingParty: protocol.RelyingPartyEntity{
				CredentialEntity: protocol.CredentialEntity{
					Name: "Openlane",
				},
				ID: "theopenlane.io",
			},
			User: protocol.UserEntity{
				CredentialEntity: protocol.CredentialEntity{
					Name: "Sarah Funk",
				},
				DisplayName: "sarahfunk",
				ID:          []byte("user-id-12345"),
			},
			Challenge: protocol.URLEncodedBase64("cmFuZG9tLWNoYWxsZW5nZS1zdHJpbmc="),
			Timeout:   60000,
		}},
	Session: "example-session-id",
}
View Source
var ExampleWebauthnLoginFinishRequest = WebauthnLoginFinishRequest{
	ID:                      "JBqvfKoo_U-McTi9NxkpDTncmL2Lg6fczz6PD7WesCHQPg",
	RawID:                   "JBqvfKoo_U-McTi9NxkpDTncmL2Lg6fczz6PD7WesCHQPg",
	Type:                    "public-key",
	AuthenticatorAttachment: "platform",
	ClientExtensionResults:  map[string]interface{}{},
	Response: struct {
		AuthenticatorData string `json:"authenticatorData" description:"The authenticator data"`
		ClientDataJSON    string `json:"clientDataJSON" description:"The client data JSON"`
		Signature         string `json:"signature" description:"The assertion signature"`
		UserHandle        string `json:"userHandle,omitempty" description:"The user handle"`
	}{
		AuthenticatorData: "SZYN5YgOjGh0NBcPZHZgW4_krrmihjLHmVzzuoMdl2NdAAAAALraVWanqkAfvZZFYZpVEg0AIiQar3yqKP1PjHE4vTcZKQ053Ji9i4On3M8-jw-1nrAh0D6lAQIDJiABIVggldWfMY_HYjHCZuSgBcDj-Zqcnipy1SJVNlhvmZBxvpciWCDh1UJNz9Uyr6jqeQhApJ3krQCvDNoeXaH0ffa9KapYdw",
		ClientDataJSON:    "eyJ0eXBlIjoid2ViYXV0aG4uZ2V0IiwiY2hhbGxlbmdlIjoiTWZlN1l6aS0zUU9rMDM4VHh3dVVvaTBaaURIZEdaOGlGNVhXc09UTTVnbyIsIm9yaWdpbiI6Imh0dHA6Ly9sb2NhbGhvc3Q6MzAwMSIsImNyb3NzT3JpZ2luIjpmYWxzZX0",
		Signature:         "MEUCIQDKIueQAhZmGtPTmzp7QQRjZU_XLUqHdGj3QKRMOxRNbwIgF1hkJJ5y7cA3RGZe9x4n9vXq_L9x8eR1r9cE4w1uJ_A",
		UserHandle:        "dXNlci1pZC0xMjM0NQ",
	},
}

ExampleWebauthnLoginFinishRequest is an example WebAuthn login finish request for OpenAPI documentation

View Source
var ExampleWebauthnLoginRequest = WebauthnLoginRequest{
	Email: "",
}

ExampleWebauthnLoginRequest is an example WebAuthn login request for OpenAPI documentation

View Source
var ExampleWebauthnLoginResponse = WebauthnLoginResponse{
	Reply:   rout.Reply{Success: true},
	Message: "Authentication successful",
	AuthData: AuthData{
		AccessToken:  "access_token_here",
		RefreshToken: "refresh_token_here",
	},
}

ExampleWebauthnLoginResponse is an example WebAuthn login response for OpenAPI documentation

View Source
var ExampleWebauthnRegistrationFinishRequest = WebauthnRegistrationFinishRequest{
	ID:                      "JBqvfKoo_U-McTi9NxkpDTncmL2Lg6fczz6PD7WesCHQPg",
	RawID:                   "JBqvfKoo_U-McTi9NxkpDTncmL2Lg6fczz6PD7WesCHQPg",
	Type:                    "public-key",
	AuthenticatorAttachment: "platform",
	ClientExtensionResults:  map[string]interface{}{},
	Response: struct {
		AttestationObject  string   `json:"attestationObject" description:"The attestation object"`
		ClientDataJSON     string   `json:"clientDataJSON" description:"The client data JSON"`
		PublicKey          string   `json:"publicKey,omitempty" description:"The public key"`
		PublicKeyAlgorithm int      `json:"publicKeyAlgorithm,omitempty" description:"The public key algorithm"`
		Transports         []string `json:"transports,omitempty" description:"Available transports"`
		AuthenticatorData  string   `json:"authenticatorData,omitempty" description:"The authenticator data"`
	}{
		AttestationObject:  "o2NmbXRkbm9uZWdhdHRTdG10oGhhdXRoRGF0YVimSZYN5YgOjGh0NBcPZHZgW4_krrmihjLHmVzzuoMdl2NdAAAAALraVWanqkAfvZZFYZpVEg0AIiQar3yqKP1PjHE4vTcZKQ053Ji9i4On3M8-jw-1nrAh0D6lAQIDJiABIVggldWfMY_HYjHCZuSgBcDj-Zqcnipy1SJVNlhvmZBxvpciWCDh1UJNz9Uyr6jqeQhApJ3krQCvDNoeXaH0ffa9KapYdw",
		ClientDataJSON:     "eyJ0eXBlIjoid2ViYXV0aG4uY3JlYXRlIiwiY2hhbGxlbmdlIjoiTWZlN1l6aS0zUU9rMDM4VHh3dVVvaTBaaURIZEdaOGlGNVhXc09UTTVnbyIsIm9yaWdpbiI6Imh0dHA6Ly9sb2NhbGhvc3Q6MzAwMSIsImNyb3NzT3JpZ2luIjpmYWxzZX0",
		PublicKey:          "MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEldWfMY_HYjHCZuSgBcDj-Zqcnipy1SJVNlhvmZBxvpfh1UJNz9Uyr6jqeQhApJ3krQCvDNoeXaH0ffa9KapYdw",
		PublicKeyAlgorithm: -7,
		Transports:         []string{"internal", "hybrid"},
		AuthenticatorData:  "SZYN5YgOjGh0NBcPZHZgW4_krrmihjLHmVzzuoMdl2NdAAAAALraVWanqkAfvZZFYZpVEg0AIiQar3yqKP1PjHE4vTcZKQ053Ji9i4On3M8-jw-1nrAh0D6lAQIDJiABIVggldWfMY_HYjHCZuSgBcDj-Zqcnipy1SJVNlhvmZBxvpciWCDh1UJNz9Uyr6jqeQhApJ3krQCvDNoeXaH0ffa9KapYdw",
	},
}

ExampleWebauthnRegistrationFinishRequest is an example WebAuthn registration finish request for OpenAPI documentation

View Source
var ExampleWebauthnRegistrationResponse = WebauthnRegistrationResponse{
	Reply:   rout.Reply{Success: true},
	Message: "Registration successful",
	AuthData: AuthData{
		AccessToken:  "access_token_here",
		RefreshToken: "refresh_token_here",
	},
}

ExampleWebauthnRegistrationResponse is an example WebAuthn registration response for OpenAPI documentation

View Source
var ExampleWebfingerRequest = WebfingerRequest{
	Resource: "acct:sarah@funkyhous.info",
}

ExampleWebfingerRequest is an example request for OpenAPI documentation

Functions

This section is empty.

Types

type AccountAccessReply deprecated

type AccountAccessReply = AccountAccessResponse

AccountAccessReply is an alias for AccountAccessResponse

Deprecated: use AccountAccessResponse

type AccountAccessRequest

type AccountAccessRequest struct {
	// ObjectID is the object_id value.
	ObjectID string `json:"object_id" description:"The ID of the object to check access for" example:"01J4EXD5MM60CX4YNYN0DEE3Y1"`
	// ObjectType is the object_type value.
	ObjectType string `` /* 138-byte string literal not displayed */
	// Relation is the relation value.
	Relation string `json:"relation" description:"The relation to check access for, e.g. can_view, can_edit" example:"can_view"`
	// SubjectType is the subject_type value.
	SubjectType string `json:"subject_type,omitempty" description:"The type of subject to check access for, e.g. service, user" example:"user"`
}

AccountAccessRequest contains organization ID for checking access permissions

func (AccountAccessRequest) ExampleSet added in v1.0.25

func (AccountAccessRequest) ExampleSet() map[string]any

ExampleSet returns the curated named examples published for AccountAccessRequest in the OpenAPI spec

func (*AccountAccessRequest) Validate

func (r *AccountAccessRequest) Validate() error

Validate ensures the required fields are set on the AccountAccessRequest

type AccountAccessResponse added in v1.0.25

type AccountAccessResponse struct {
	// Reply is the reply value.
	rout.Reply
	// Allowed is the allowed value.
	Allowed bool `json:"allowed"`
}

AccountAccessResponse holds the fields that are sent on a response to the `/account/access` endpoint

func (*AccountAccessResponse) ExampleResponse added in v1.0.25

func (r *AccountAccessResponse) ExampleResponse() any

ExampleResponse returns an example AccountAccessResponse for OpenAPI documentation

type AccountFeaturesReply deprecated

type AccountFeaturesReply = AccountFeaturesResponse

AccountFeaturesReply is an alias for AccountFeaturesResponse

Deprecated: use AccountFeaturesResponse

type AccountFeaturesRequest

type AccountFeaturesRequest struct {
	// ID is the id value.
	ID string `param:"id" description:"The ID of the organization to check roles for" example:"01J4HMNDSZCCQBTY93BF9CBF5D"`
}

AccountFeaturesRequest contains organization ID for retrieving available features

func (AccountFeaturesRequest) ExampleSet added in v1.0.25

func (AccountFeaturesRequest) ExampleSet() map[string]any

ExampleSet returns the curated named examples published for AccountFeaturesRequest in the OpenAPI spec

func (*AccountFeaturesRequest) Validate

func (r *AccountFeaturesRequest) Validate() error

Validate ensures the required fields are set on the AccountFeaturesRequest

type AccountFeaturesResponse added in v1.0.25

type AccountFeaturesResponse struct {
	// Reply is the reply value.
	rout.Reply
	// Features is the features value.
	Features []string `` /* 138-byte string literal not displayed */
	// OrganizationID is the organization_id value.
	OrganizationID string `json:"organization_id" description:"The ID of the organization the user has features in" example:"01J4HMNDSZCCQBTY93BF9CBF5D"`
}

AccountFeaturesResponse holds the fields that are sent on a response to the `/account/features` endpoint

func (*AccountFeaturesResponse) ExampleResponse added in v1.0.25

func (r *AccountFeaturesResponse) ExampleResponse() any

ExampleResponse returns an example AccountFeaturesResponse for OpenAPI documentation

func (AccountFeaturesResponse) ExampleSet added in v1.0.25

func (AccountFeaturesResponse) ExampleSet() map[string]any

ExampleSet returns the curated named examples published for AccountFeaturesResponse in the OpenAPI spec

type AccountRolesMeReply deprecated added in v1.0.25

type AccountRolesMeReply = AccountRolesMeResponse

AccountRolesMeReply is an alias for AccountRolesMeResponse

Deprecated: use AccountRolesMeResponse

type AccountRolesMeRequest added in v1.0.25

type AccountRolesMeRequest struct{}

AccountRolesMeRequest contains no input; it uses the authenticated caller.

func (AccountRolesMeRequest) ExampleSet added in v1.0.25

func (AccountRolesMeRequest) ExampleSet() map[string]any

ExampleSet returns the curated named examples published for AccountRolesMeRequest in the OpenAPI spec

func (*AccountRolesMeRequest) Validate added in v1.0.25

func (r *AccountRolesMeRequest) Validate() error

type AccountRolesMeResponse added in v1.0.25

type AccountRolesMeResponse struct {
	rout.Reply
	Roles          []OrganizationRole `json:"roles" description:"Organization responsibility roles assigned to the authenticated caller"`
	OrganizationID string             `json:"organization_id" description:"The ID of the organization the roles apply to" example:"01J4HMNDSZCCQBTY93BF9CBF5D"`
}

AccountRolesMeResponse holds the organization responsibility roles assigned to the authenticated caller.

func (AccountRolesMeResponse) ExampleSet added in v1.0.25

func (AccountRolesMeResponse) ExampleSet() map[string]any

ExampleSet returns the curated named examples published for AccountRolesMeResponse in the OpenAPI spec

type AccountRolesOrganizationReply deprecated

type AccountRolesOrganizationReply = AccountRolesOrganizationResponse

AccountRolesOrganizationReply is an alias for AccountRolesOrganizationResponse

Deprecated: use AccountRolesOrganizationResponse

type AccountRolesOrganizationRequest

type AccountRolesOrganizationRequest struct {
	// ID is the id value.
	ID string `param:"id" description:"The ID of the organization to check roles for" example:"01J4HMNDSZCCQBTY93BF9CBF5D"`
}

AccountRolesOrganizationRequest contains organization ID for retrieving organization-specific roles

func (AccountRolesOrganizationRequest) ExampleSet added in v1.0.25

func (AccountRolesOrganizationRequest) ExampleSet() map[string]any

ExampleSet returns the curated named examples published for AccountRolesOrganizationRequest in the OpenAPI spec

func (*AccountRolesOrganizationRequest) Validate

func (r *AccountRolesOrganizationRequest) Validate() error

Validate ensures the required fields are set on the AccountRolesOrganizationRequest

type AccountRolesOrganizationResponse added in v1.0.25

type AccountRolesOrganizationResponse struct {
	// Reply is the reply value.
	rout.Reply
	// Roles is the roles value.
	Roles []string `json:"roles" description:"The roles the user has in the organization, e.g. can_view, can_edit"`
	// OrganizationID is the organization_id value.
	OrganizationID string `json:"organization_id" description:"The ID of the organization the user has roles in" example:"01J4HMNDSZCCQBTY93BF9CBF5D"`
}

AccountRolesOrganizationResponse holds the fields that are sent on a response to the `/account/roles/organization` endpoint

func (*AccountRolesOrganizationResponse) ExampleResponse added in v1.0.25

func (r *AccountRolesOrganizationResponse) ExampleResponse() any

ExampleResponse returns an example AccountRolesOrganizationResponse for OpenAPI documentation

func (AccountRolesOrganizationResponse) ExampleSet added in v1.0.25

func (AccountRolesOrganizationResponse) ExampleSet() map[string]any

ExampleSet returns the curated named examples published for AccountRolesOrganizationResponse in the OpenAPI spec

type AccountRolesReply deprecated

type AccountRolesReply = AccountRolesResponse

AccountRolesReply is an alias for AccountRolesResponse

Deprecated: use AccountRolesResponse

type AccountRolesRequest

type AccountRolesRequest struct {
	// @deprecated use ObjectIDs instead, may be removed in a future release
	ObjectID string `` /* 153-byte string literal not displayed */
	// ObjectIDs is the object_ids value.
	ObjectIDs []string `` // example:"["01J4EXD5MM60CX4YNYN0DEE3Y1", "01J4EXD5MM60CX4YNYN0DEE3Y2"]"
	/* 132-byte string literal not displayed */
	// ObjectType is the object_type value.
	ObjectType string `` /* 137-byte string literal not displayed */
	// SubjectType is the subject_type value.
	SubjectType string `json:"subject_type,omitempty" description:"The type of subject to check roles for, e.g. service, user" example:"user"`
	// Relations is the relations value.
	Relations []string `json:"relations,omitempty" description:"The relations to check roles for, e.g. can_view, can_edit"`
}

AccountRolesRequest contains object IDs for retrieving roles associated with them

func (AccountRolesRequest) ExampleSet added in v1.0.25

func (AccountRolesRequest) ExampleSet() map[string]any

ExampleSet returns the curated named examples published for AccountRolesRequest in the OpenAPI spec

func (*AccountRolesRequest) Validate

func (r *AccountRolesRequest) Validate() error

Validate ensures the required fields are set on the AccountAccessRequest

type AccountRolesResponse added in v1.0.25

type AccountRolesResponse struct {
	// Reply is the reply value.
	rout.Reply
	// Roles is a list of roles the user has for the specified object(s)
	// @deprecated use ObjectRoles instead, may be removed in a future release
	Roles []string `json:"roles" description:" @deprecated use ObjectRoles instead. A list of roles the subject has for the specified object"`
	// ObjectRoles is a map of object IDs to the roles the user has for each object ID
	ObjectRoles map[string][]string `json:"object_roles,omitempty" description:"A map of object IDs to the roles the subject has for each object ID"`
}

AccountRolesResponse holds the fields that are sent on a response to the `/account/roles` endpoint

func (*AccountRolesResponse) ExampleResponse added in v1.0.25

func (r *AccountRolesResponse) ExampleResponse() any

ExampleResponse returns an example AccountRolesResponse for OpenAPI documentation

type AcmeSolverRequest

type AcmeSolverRequest struct {
	// Path is the path value.
	Path string `param:"path" description:"The path to the acme challenge" example:"01J4HMNDSZCCQBTY93BF9CBF5D"`
}

AcmeSolverRequest is the request to solve an acme challenge

type AuthData

type AuthData struct {
	// AccessToken is the access_token value.
	AccessToken string `json:"access_token" description:"The access token to be used for authentication"`
	// RefreshToken is the refresh_token value.
	RefreshToken string `json:"refresh_token,omitempty" description:"The refresh token to be used to refresh the access token after it expires"`
	// Session is the session value.
	Session string `json:"session,omitempty" description:"The short-lived session token required for authentication"`
	// TokenType is the token_type value.
	TokenType string `json:"token_type,omitempty" description:"The type of token being returned" example:"bearer"`
}

type AvailableAuthTypeLoginRequest

type AvailableAuthTypeLoginRequest struct {
	// Username is the username value.
	Username string `json:"username" description:"The email address associated with the existing account" example:"jsnow@example.com"`
}

AvailableAuthTypeLoginRequest holds the payload for checking the auth types available to a user passkeys? or both passkeys and credentials or just credentials

func (*AvailableAuthTypeLoginRequest) Validate

func (r *AvailableAuthTypeLoginRequest) Validate() error

Validate ensures the required fields are set on the AvailableAuthTypeLoginRequest request

type AvailableAuthTypeReply deprecated

type AvailableAuthTypeReply = AvailableAuthTypeResponse

AvailableAuthTypeReply is an alias for AvailableAuthTypeResponse

Deprecated: use AvailableAuthTypeResponse

type AvailableAuthTypeResponse added in v1.0.25

type AvailableAuthTypeResponse struct {
	// Reply is the reply value.
	rout.Reply
	// Methods is the methods value.
	Methods []enums.AuthProvider `json:"methods,omitempty"`
}

AvailableAuthTypeResponse holds the response to AvailableAuthTypeLoginRequest

func (*AvailableAuthTypeResponse) ExampleResponse added in v1.0.25

func (r *AvailableAuthTypeResponse) ExampleResponse() any

ExampleResponse returns an example AvailableAuthTypeResponse for OpenAPI documentation

type ConfigureIntegrationRequest added in v1.0.18

type ConfigureIntegrationRequest struct {
	// DefinitionID is the canonical integration definition ID from the path.
	DefinitionID string `param:"definitionID" description:"Integration definition ID" example:"def_01K0GCPSCC00000000000000001"`
	// IntegrationID is the optional existing installation to update credentials on; when omitted we create a new integration.
	IntegrationID string `json:"integrationId,omitempty"`
	// CredentialRef selects which credential slot is being configured.
	CredentialRef string `json:"credentialRef"`
	// Body holds the provider-specific credential fields as a raw JSON object.
	Body json.RawMessage `json:"body"`
	// UserInput holds optional installation-scoped provider configuration.
	UserInput json.RawMessage `json:"userInput,omitempty"`
}

ConfigureIntegrationRequest is the request type for configuring a non-OAuth provider.

func (ConfigureIntegrationRequest) HasCredentialBody added in v1.0.18

func (r ConfigureIntegrationRequest) HasCredentialBody() bool

HasCredentialBody reports whether the request includes a meaningful credential payload.

func (*ConfigureIntegrationRequest) Validate added in v1.0.18

func (r *ConfigureIntegrationRequest) Validate() error

Validate validates the ConfigureIntegrationRequest.

type ConfigureIntegrationResponse added in v1.0.18

type ConfigureIntegrationResponse struct {
	rout.Reply
	// Provider is the configured definition ID.
	Provider string `json:"provider"`
	// IntegrationID is the installation record ID that was created or updated.
	IntegrationID string `json:"integrationId"`
	// HealthStatus is the result of the inline validation health check.
	HealthStatus string `json:"healthStatus,omitempty"`
	// HealthSummary is a human-readable description of the health check result.
	HealthSummary string `json:"healthSummary,omitempty"`
	// InstallationMetadata is the provider-specific installation identity metadata resolved during configuration (e.g. Slack team name, GitHub org, AWS account).
	InstallationMetadata json.RawMessage `json:"installationMetadata,omitempty"`
	// WebhookEndpointURL is the user-facing webhook or SCIM endpoint URL when the definition declares webhooks.
	WebhookEndpointURL string `json:"webhookEndpointUrl,omitempty"`
	// WebhookSecret is the shared secret for authenticating inbound webhook or SCIM deliveries.
	// This value is only populated on initial creation and should be captured by the caller.
	WebhookSecret string `json:"webhookSecret,omitempty"`
}

ConfigureIntegrationResponse is the response after successfully configuring a provider.

type CreateTrustCenterAnonymousJWTResponse

type CreateTrustCenterAnonymousJWTResponse struct {
	// AuthData is the authdata value.
	AuthData
}

CreateTrustCenterAnonymousJWTResponse is the response to a request to create a trust center anonymous JWT

func (*CreateTrustCenterAnonymousJWTResponse) ExampleResponse

func (r *CreateTrustCenterAnonymousJWTResponse) ExampleResponse() any

ExampleResponse returns an example CreateTrustCenterAnonymousJWTResponse for OpenAPI documentation

type DeleteIntegrationRequest

type DeleteIntegrationRequest struct {
	// ID is the id value.
	ID string `param:"id" description:"Integration ID" example:"01J4HMNDSZCCQBTY93BF9CBF5D"`
}

DeleteIntegrationRequest is the request for deleting an integration

func (*DeleteIntegrationRequest) Validate

func (r *DeleteIntegrationRequest) Validate() error

Validate validates the DeleteIntegrationRequest

type DeleteIntegrationResponse

type DeleteIntegrationResponse struct {
	// Reply is the reply value
	rout.Reply
	// Message is a user-facing summary of the disconnect action
	Message string `json:"message"`
	// DeletedID is the installation record ID that was removed
	DeletedID string `json:"deletedId,omitempty"`
	// RedirectURL is a provider URL the user should visit to complete external teardown
	RedirectURL string `json:"redirectUrl,omitempty"`
	// Details is an opaque provider-specific payload describing teardown actions taken or required
	Details json.RawMessage `json:"details,omitempty"`
}

DeleteIntegrationResponse is the response for deleting an integration

type DisconnectIntegrationRequest

type DisconnectIntegrationRequest struct {
	// IntegrationID is the integration ID to disconnect
	IntegrationID string `param:"integrationID" description:"Integration ID to disconnect" example:"01J4HMNDSZCCQBTY93BF9CBF5D"`
}

DisconnectIntegrationRequest is the request payload for disconnecting an integration

func (DisconnectIntegrationRequest) ExampleSet added in v1.0.25

func (DisconnectIntegrationRequest) ExampleSet() map[string]any

ExampleSet returns the curated named examples published for DisconnectIntegrationRequest in the OpenAPI spec

type EndImpersonationReply deprecated

type EndImpersonationReply = EndImpersonationResponse

EndImpersonationReply is an alias for EndImpersonationResponse

Deprecated: use EndImpersonationResponse

type EndImpersonationRequest

type EndImpersonationRequest struct {
	// SessionID is the session_id value.
	SessionID string `json:"session_id" validate:"required" description:"The session ID to end"`
	// Reason is the reason value.
	Reason string `json:"reason,omitempty" description:"Optional reason for ending the session"`
}

EndImpersonationRequest represents a request to end an impersonation session

func (*EndImpersonationRequest) Validate

func (r *EndImpersonationRequest) Validate() error

Validate ensures the required fields are set on the EndImpersonationRequest

type EndImpersonationResponse added in v1.0.25

type EndImpersonationResponse struct {
	// Reply is the reply value.
	rout.Reply
	// Message is the message value.
	Message string `json:"message" description:"Success message"`
}

EndImpersonationResponse represents the response when ending impersonation

func (*EndImpersonationResponse) ExampleResponse added in v1.0.25

func (r *EndImpersonationResponse) ExampleResponse() any

ExampleResponse returns an example EndImpersonationResponse for OpenAPI documentation

type ExampleCSVRequest

type ExampleCSVRequest struct {
	// Filename is the filename value.
	Filename string `json:"filename" description:"the file name to check for" example:"actionplan"`
}

ExampleCSVRequest holds the payload for serving example CSV files

func (*ExampleCSVRequest) Validate

func (r *ExampleCSVRequest) Validate() error

Validate ensures the required fields are set on the ExampleCSVRequest request

type ExampleProvider

type ExampleProvider interface {
	ExampleResponse() any
}

ExampleProvider interface allows response models to provide their own examples This eliminates the need for separate Example* variables and static switch statements

type ExampleSetProvider added in v1.0.25

type ExampleSetProvider interface {
	ExampleSet() map[string]any
}

ExampleSetProvider interface allows models to explicitly register their curated named examples for the OpenAPI spec; it takes precedence over ExampleProvider and supports several examples per model, keyed by the example name published in the spec

type File

type File = storagetypes.File

type FileDownload

type FileDownload struct {
	// ID is the id value.
	ID string `param:"id" description:"the file ID" example:"01J4HMNDSZCCQBTY93BF9CBF5D"`
	// Token is the token value.
	Token string `query:"token" description:"The token to be used to verify the email address, token is sent via email"`
}

func (*FileDownload) Validate

func (r *FileDownload) Validate() error

Validate ensures the required fields are set on the VerifyRequest request

type FileDownloadReply deprecated

type FileDownloadReply = FileDownloadResponse

FileDownloadReply is an alias for FileDownloadResponse

Deprecated: use FileDownloadResponse

type FileDownloadResponse added in v1.0.25

type FileDownloadResponse struct {
	// Reply is the reply value.
	rout.Reply
	// Message is the message value.
	Message string `json:"message,omitempty"`
	// File is the file value.
	File File `json:"file" description:"The files that were uploaded"`
}

UploadFilesResponse holds the fields that are sent on a response to the `/upload` endpoint

func (*FileDownloadResponse) ExampleResponse added in v1.0.25

func (r *FileDownloadResponse) ExampleResponse() any

ExampleResponse returns an example UploadFilesResponse for OpenAPI documentation

type ForgotPasswordReply deprecated

type ForgotPasswordReply = ForgotPasswordResponse

ForgotPasswordReply is an alias for ForgotPasswordResponse

Deprecated: use ForgotPasswordResponse

type ForgotPasswordRequest

type ForgotPasswordRequest struct {
	// Email is the email value.
	Email string `` /* 136-byte string literal not displayed */
}

ForgotPasswordRequest contains fields for a forgot password request

func (ForgotPasswordRequest) ExampleSet added in v1.0.25

func (ForgotPasswordRequest) ExampleSet() map[string]any

ExampleSet returns the curated named examples published for ForgotPasswordRequest in the OpenAPI spec

func (*ForgotPasswordRequest) Validate

func (r *ForgotPasswordRequest) Validate() error

Validate ensures the required fields are set on the ForgotPasswordRequest request

type ForgotPasswordResponse added in v1.0.25

type ForgotPasswordResponse struct {
	// Reply is the reply value.
	rout.Reply
	// Message is the message value.
	Message string `json:"message,omitempty"`
}

ForgotPasswordResponse contains fields for a forgot password response

func (*ForgotPasswordResponse) ExampleResponse added in v1.0.25

func (r *ForgotPasswordResponse) ExampleResponse() any

ExampleResponse returns an example ForgotPasswordResponse for OpenAPI documentation

func (ForgotPasswordResponse) ExampleSet added in v1.0.25

func (ForgotPasswordResponse) ExampleSet() map[string]any

ExampleSet returns the curated named examples published for ForgotPasswordResponse in the OpenAPI spec

type GetIntegrationStatusRequest

type GetIntegrationStatusRequest struct {
	// Provider is the provider value.
	Provider string `param:"provider" description:"OAuth provider (github, slack, etc.)" example:"github"`
}

GetIntegrationStatusRequest is the request for checking integration status

func (*GetIntegrationStatusRequest) Validate

func (r *GetIntegrationStatusRequest) Validate() error

Validate validates the GetIntegrationStatusRequest

type GetIntegrationTokenRequest

type GetIntegrationTokenRequest struct {
	// Provider is the provider value.
	Provider string `param:"provider" description:"OAuth provider (github, slack, etc.)" example:"github"`
}

GetIntegrationTokenRequest is the request for getting integration tokens

func (*GetIntegrationTokenRequest) Validate

func (r *GetIntegrationTokenRequest) Validate() error

Validate validates the GetIntegrationTokenRequest

type GetQuestionnaireResponse

type GetQuestionnaireResponse struct {
	// Jsonconfig is the jsonconfig value.
	Jsonconfig map[string]any `json:"jsonconfig,omitempty"`
	// UISchema is the uischema value.
	UISchema map[string]any `json:"uischema,omitempty"`
	// SavedData is the previously saved draft data, if any.
	SavedData map[string]any `json:"saved_data,omitempty"`
}

GetQuestionnaireResponse is the response containing the questionnaire template's JSON configuration

func (*GetQuestionnaireResponse) ExampleResponse

func (r *GetQuestionnaireResponse) ExampleResponse() any

ExampleResponse returns an example GetQuestionnaireResponse for OpenAPI documentation

func (GetQuestionnaireResponse) ExampleSet added in v1.0.25

func (GetQuestionnaireResponse) ExampleSet() map[string]any

ExampleSet returns the curated named examples published for GetQuestionnaireResponse in the OpenAPI spec

type GitHubAppWebhookResponse added in v1.0.9

type GitHubAppWebhookResponse struct {
	// Reply is the reply value.
	rout.Reply
	// Persisted is the persisted value.
	Persisted map[string]any `json:"persisted,omitempty" description:"Summary of persisted alerts"`
}

GitHubAppWebhookResponse acknowledges GitHub App webhooks.

func (*GitHubAppWebhookResponse) ExampleResponse added in v1.0.9

func (r *GitHubAppWebhookResponse) ExampleResponse() any

ExampleResponse returns an example GitHubAppWebhookResponse.

type IntegrationAuthStartRequest added in v1.0.18

type IntegrationAuthStartRequest struct {
	// DefinitionID is the canonical integration definition identifier.
	DefinitionID string `json:"definitionId" description:"Integration definition ID" example:"def_01K0SLACK000000000000000001"`
	// IntegrationID is the existing installation to start the auth flow for; when omitted a new installation is created.
	IntegrationID string `json:"integrationId,omitempty"`
	// CredentialRef selects which credential-schema-defined connection is being activated.
	CredentialRef string `json:"credentialRef"`
	// UserInput holds optional installation-scoped provider configuration.
	UserInput json.RawMessage `json:"userInput,omitempty"`
}

IntegrationAuthStartRequest is the request type for starting an integration auth flow.

func (*IntegrationAuthStartRequest) Validate added in v1.0.18

func (r *IntegrationAuthStartRequest) Validate() error

Validate validates the IntegrationAuthStartRequest.

type IntegrationConfig added in v1.0.8

type IntegrationConfig struct {
	// ClientConfig is the client configuration JSON
	ClientConfig json.RawMessage `json:"clientConfig,omitempty"`
}

IntegrationConfig is the per-installation runtime configuration stored as a typed JSON field

type IntegrationInstallationIdentity added in v1.0.16

type IntegrationInstallationIdentity struct {
	// ExternalName is the human-readable name of the external entity
	// (e.g. Slack workspace name, Azure tenant display name, Google Workspace domain)
	ExternalName string `json:"externalName,omitempty"`
	// ExternalID is the machine identifier for the external entity
	// (e.g. Slack team ID, Azure tenant ID, AWS account ID, GitHub installation ID)
	ExternalID string `json:"externalId,omitempty"`
	// CredentialRef is the credential method used to set up the integration
	CredentialRef string `json:"credentialRef,omitempty"`
	// LastSuccessfulHealthCheck is the RFC3339 timestamp of the last successful validation operation
	LastSuccessfulHealthCheck string `json:"lastSuccessfulHealthCheck,omitempty"`
}

IntegrationInstallationIdentity is the normalized, provider-agnostic installation identity surfaced in the GraphQL metadata field for UI display

type IntegrationInstallationMetadata added in v1.0.16

type IntegrationInstallationMetadata struct {
	// Attributes is the provider-defined installation metadata payload
	Attributes json.RawMessage `json:"attributes,omitempty"`
	// Display is the normalized installation identity for UI rendering
	Display IntegrationInstallationIdentity `json:"display,omitzero"`
}

IntegrationInstallationMetadata stores stable, non-secret installation identity metadata

type IntegrationProviderMetadata

type IntegrationProviderMetadata struct {
	// Name is the provider's unique name
	Name string `json:"name"`
	// DisplayName is the human-readable provider name
	DisplayName string `json:"displayName"`
	// Category is the provider category
	Category string `json:"category"`
	// Description is the provider description
	Description string `json:"description,omitempty"`
	// AuthType is the authentication type
	AuthType string `json:"authType"`
	// AuthStartPath is the path to start authentication
	AuthStartPath string `json:"authStartPath,omitempty"`
	// AuthCallbackPath is the path for authentication callback
	AuthCallbackPath string `json:"authCallbackPath,omitempty"`
	// Active indicates if the provider is active
	Active bool `json:"active"`
	// Visible indicates if the provider is visible
	Visible bool `json:"visible"`
	// Tags is a list of provider tags
	Tags []string `json:"tags,omitempty"`
	// LogoURL is the URL to the provider logo
	LogoURL string `json:"logoUrl,omitempty"`
	// DocsURL is the URL to the provider documentation
	DocsURL string `json:"docsUrl,omitempty"`
	// EnvironmentCredentials is the environment credentials JSON
	EnvironmentCredentials json.RawMessage `json:"environmentCredentials,omitempty"`
	// CredentialsSchema is the credentials schema JSON
	CredentialsSchema json.RawMessage `json:"credentialsSchema,omitempty"`
	// Persistence is the persistence configuration
	Persistence map[string]any `json:"persistence,omitempty"`
	// Labels is a set of provider labels
	Labels map[string]string `json:"labels,omitempty"`
}

IntegrationProviderMetadata is a snapshot of definition metadata captured on installation

type IntegrationProviderState added in v1.0.8

type IntegrationProviderState struct {
	// Providers is a map of provider keys to raw state JSON
	Providers map[string]json.RawMessage `json:"providers,omitempty"`
}

IntegrationProviderState stores provider-specific integration state captured during auth and config

type InviteReply deprecated

type InviteReply = InviteResponse

InviteReply is an alias for InviteResponse

Deprecated: use InviteResponse

type InviteRequest

type InviteRequest struct {
	// Token is the token value.
	Token string `query:"token" description:"The token to be used to accept the invitation, token is sent via email"`
}

InviteRequest contains invitation token for organization membership

func (InviteRequest) ExampleSet added in v1.0.25

func (InviteRequest) ExampleSet() map[string]any

ExampleSet returns the curated named examples published for InviteRequest in the OpenAPI spec

func (*InviteRequest) Validate

func (r *InviteRequest) Validate() error

Validate ensures the required fields are set on the InviteRequest request

type InviteResponse added in v1.0.25

type InviteResponse struct {
	// Reply is the reply value.
	rout.Reply
	// ID is the user_id value.
	ID string `json:"user_id" description:"The ID of the user that was created" example:"01J4EXD5MM60CX4YNYN0DEE3Y1"`
	// Email is the email value.
	Email string `json:"email" description:"The email address of the user" example:"jsnow@example.com"`
	// Message is the message value.
	Message string `json:"message"`
	// JoinedOrgID is the joined_org_id value.
	JoinedOrgID string `json:"joined_org_id" description:"The ID of the organization the user joined" example:"01JJFVMGENQS9ZG3GVA50QVX5E"`
	// Role is the role value.
	Role string `json:"role" description:"The role the user has in the organization" example:"admin"`
	// NeedsSSO is the needs_sso value.
	NeedsSSO bool `json:"needs_sso,omitempty"`
	// AuthData is the authdata value.
	AuthData
}

InviteResponse holds the fields that are sent on a response to an accepted invitation

func (*InviteResponse) ExampleResponse added in v1.0.25

func (r *InviteResponse) ExampleResponse() any

ExampleResponse returns an example InviteResponse for OpenAPI documentation

func (InviteResponse) ExampleSet added in v1.0.25

func (InviteResponse) ExampleSet() map[string]any

ExampleSet returns the curated named examples published for InviteResponse in the OpenAPI spec

type JobRunnerRegistrationReply deprecated

type JobRunnerRegistrationReply struct {
	// Reply is the reply value.
	Reply rout.Reply
	// Message is the message value.
	Message string `json:"message"`
}

JobRunnerRegistrationReply is the response to a job runner registration; the endpoint was removed on this branch and the type remains only for released consumers

Deprecated: the job runner registration endpoint no longer exists

type JobRunnerRegistrationRequest deprecated

type JobRunnerRegistrationRequest struct {
	// IPAddress is the ip_address value.
	IPAddress string `json:"ip_address" description:"The IP address of the node being registered"`
	// Token is the token value.
	Token string `json:"token" description:"Your agent registration token"`
	// Name is the name value.
	Name string `json:"name" description:"the name of your job runner node"`
	// Tags is the tags value.
	Tags []string `json:"tags" description:"The tags for your runner node"`
}

JobRunnerRegistrationRequest is the request to register a new node; the endpoint was removed on this branch and the type remains only for released consumers

Deprecated: the job runner registration endpoint no longer exists

func (*JobRunnerRegistrationRequest) Validate deprecated

func (r *JobRunnerRegistrationRequest) Validate() error

Validate ensures the required fields are set on the JobRunnerRegistrationRequest

Deprecated: the job runner registration endpoint no longer exists

type ListIntegrationsResponse

type ListIntegrationsResponse struct {
	// Reply is the reply value.
	rout.Reply
	// Integrations is the integrations value.
	Integrations any `json:"integrations"` // Will be []*ent.Integration
}

ListIntegrationsResponse is the response for listing integrations

type LoginReply deprecated

type LoginReply = LoginResponse

LoginReply is an alias for LoginResponse

Deprecated: use LoginResponse

type LoginRequest

type LoginRequest struct {
	// Username is the username value.
	Username string `json:"username" description:"The email address associated with the existing account" example:"jsnow@example.com"`
	// Password is the password value.
	Password string `json:"password" description:"The password associated with the account" example:"Wint3rIsC0ming123!"`
	// TargetOrganizationID is only used for the Openlane support login path to scope the support session
	TargetOrganizationID string `json:"target_organization_id,omitempty" description:"For Openlane support login only: the organization to access"`
	// Reason is only used for the Openlane support login path to record why support is accessing the org
	Reason string `json:"reason,omitempty" description:"For Openlane support login only: the reason for accessing the organization"`
}

LoginRequest contains credentials for user authentication

func (LoginRequest) ExampleSet added in v1.0.25

func (LoginRequest) ExampleSet() map[string]any

ExampleSet returns the curated named examples published for LoginRequest in the OpenAPI spec

func (*LoginRequest) Validate

func (r *LoginRequest) Validate() error

Validate ensures the required fields are set on the LoginRequest request

type LoginResponse added in v1.0.25

type LoginResponse struct {
	// Reply is the reply value.
	rout.Reply
	// AuthData is the authdata value.
	AuthData
	// TFAEnabled is the tfa_enabled value.
	TFAEnabled bool `json:"tfa_enabled,omitempty"`
	// TFASetupRequired is the tfa_required value.
	TFASetupRequired bool `json:"tfa_required,omitempty"`
	// RedirectURI directs the caller to a second factor identity provider; set for the Openlane support login path
	RedirectURI string `json:"redirect_uri,omitempty"`
	// Message is the message value.
	Message string `json:"message"`
}

LoginResponse contains authentication tokens and user information after successful login

func (*LoginResponse) ExampleResponse added in v1.0.25

func (r *LoginResponse) ExampleResponse() any

ExampleResponse returns an example LoginResponse for OpenAPI documentation

func (LoginResponse) ExampleSet added in v1.0.25

func (LoginResponse) ExampleSet() map[string]any

ExampleSet returns the curated named examples published for LoginResponse in the OpenAPI spec

type LogoutReply deprecated added in v1.0.25

type LogoutReply = LogoutResponse

LogoutReply is an alias for LogoutResponse

Deprecated: use LogoutResponse

type LogoutRequest added in v1.0.25

type LogoutRequest struct {
	// RefreshToken is an optional refresh_token value for API clients that do not use cookies.
	RefreshToken string `json:"refresh_token,omitempty" description:"Optional refresh token to revoke when not provided via cookie"`
}

LogoutRequest optionally carries the refresh token to revoke when it is not supplied via cookie

func (LogoutRequest) ExampleSet added in v1.0.25

func (LogoutRequest) ExampleSet() map[string]any

ExampleSet returns the curated named examples published for LogoutRequest in the OpenAPI spec

func (*LogoutRequest) Validate added in v1.0.25

func (r *LogoutRequest) Validate() error

Validate ensures the LogoutRequest is well formed; all fields are optional since tokens are normally read from cookies

type LogoutResponse added in v1.0.25

type LogoutResponse struct {
	// Reply is the reply value.
	rout.Reply
	// Message is the message value.
	Message string `json:"message,omitempty"`
}

LogoutResponse confirms the session and tokens were revoked

func (*LogoutResponse) ExampleResponse added in v1.0.25

func (r *LogoutResponse) ExampleResponse() any

ExampleResponse returns an example LogoutResponse for OpenAPI documentation

func (LogoutResponse) ExampleSet added in v1.0.25

func (LogoutResponse) ExampleSet() map[string]any

ExampleSet returns the curated named examples published for LogoutResponse in the OpenAPI spec

type OAuthFlowRequest

type OAuthFlowRequest struct {
	// Provider is the provider value.
	Provider string `json:"provider" description:"OAuth provider (github, slack, etc.)" example:"github"`
	// IntegrationID scopes the OAuth callback credential save to a specific integration record.
	IntegrationID string `` /* 136-byte string literal not displayed */
	// RedirectURI is the redirectUri value.
	RedirectURI string `` /* 126-byte string literal not displayed */
	// Scopes is the scopes value.
	Scopes []string `json:"scopes,omitempty" description:"Additional OAuth scopes to request"` // example: ["repo", "gist"]
}

OAuthFlowRequest represents the initial OAuth flow request

func (*OAuthFlowRequest) Validate

func (r *OAuthFlowRequest) Validate() error

Validate ensures the required fields are set on the OAuthFlowRequest

type OAuthFlowResponse

type OAuthFlowResponse struct {
	// Reply is the reply value.
	rout.Reply
	// AuthURL is the authUrl value.
	AuthURL string `` /* 141-byte string literal not displayed */
	// State is the state value.
	State string `json:"state,omitempty" description:"OAuth state parameter for security" example:"eyJvcmdJRCI6IjAxSE..."`
	// Message is the message value.
	Message string `` /* 146-byte string literal not displayed */
	// RequiresLogin is the requiresLogin value.
	RequiresLogin bool `json:"requiresLogin,omitempty" description:"Whether user needs to login before OAuth flow"`
}

OAuthFlowResponse contains the OAuth authorization URL

func (*OAuthFlowResponse) ExampleResponse

func (r *OAuthFlowResponse) ExampleResponse() any

ExampleResponse returns an example OAuthFlowResponse for OpenAPI documentation

type OauthTokenRequest

type OauthTokenRequest struct {
	// Name is the name value.
	Name string `json:"name" description:"The name of the user" example:"Jon Snow"`
	// Email is the email value.
	Email string `json:"email" description:"The email address of the user" example:"jsnow@example.com"`
	// AuthProvider is the authProvider value.
	AuthProvider string `json:"authProvider" description:"The provider used to authenticate the user, e.g. google, github, etc." example:"google"`
	// ExternalUserID is the externalUserId value.
	ExternalUserID string `json:"externalUserId" description:"The ID of the user from the external provider" example:"1234567890"`
	// ExternalUserName is the externalUserName value.
	ExternalUserName string `json:"externalUserName" description:"The username of the user from the external provider" example:"jsnow"`
	// ClientToken is the clientToken value.
	ClientToken string `json:"clientToken" description:"The token provided by the external provider"`
	// Image is the image value.
	Image string `json:"image,omitempty" description:"The image URL of the user from the external provider"`
	// OrgID is the org_id value.
	OrgID string `json:"org_id,omitempty" description:"the organization id for the sso connection"`
}

OauthTokenRequest to authenticate an oauth user with the Server

type OrganizationRole added in v1.0.25

type OrganizationRole struct {
	ID          string `json:"id" description:"The role relation ID" example:"policy_manager"`
	Name        string `json:"name" description:"The display name for the role" example:"Policy Manager"`
	Description string `json:"description" description:"The role description" example:"Manage all policies and procedures"`
}

OrganizationRole contains certain metadata for a role that can be assigned to users.

type OrganizationRolesReply deprecated added in v1.0.25

type OrganizationRolesReply = OrganizationRolesResponse

OrganizationRolesReply is an alias for OrganizationRolesResponse

Deprecated: use OrganizationRolesResponse

type OrganizationRolesRequest added in v1.0.25

type OrganizationRolesRequest struct {
	OrganizationID string   `` /* 174-byte string literal not displayed */
	Role           string   `json:"role" description:"The organization responsibility role to assign" example:"policy_manager"`
	UserIDs        []string `json:"user_ids,omitempty" description:"User IDs to assign the role to"`
	GroupIDs       []string `json:"group_ids,omitempty" description:"Group IDs to assign the role to"`
}

OrganizationRolesRequest contains functional roles that can be assigned to users or groups in addition to their base level org role such as member, admin, etc.

func (OrganizationRolesRequest) ExampleSet added in v1.0.25

func (OrganizationRolesRequest) ExampleSet() map[string]any

ExampleSet returns the curated named examples published for OrganizationRolesRequest in the OpenAPI spec

func (*OrganizationRolesRequest) Validate added in v1.0.25

func (r *OrganizationRolesRequest) Validate() error

type OrganizationRolesResponse added in v1.0.25

type OrganizationRolesResponse struct {
	rout.Reply
	OrganizationID string `json:"organization_id" description:"The ID of the organization the role was applied to" example:"01J4HMNDSZCCQBTY93BF9CBF5D"`
	Role           string `json:"role" description:"The organization responsibility role" example:"policy_manager"`
}

OrganizationRolesResponse contains the newly assigned/removed role.

func (OrganizationRolesResponse) ExampleSet added in v1.0.25

func (OrganizationRolesResponse) ExampleSet() map[string]any

ExampleSet returns the curated named examples published for OrganizationRolesResponse in the OpenAPI spec

type ProductCatalogReply deprecated

type ProductCatalogReply = ProductCatalogResponse

ProductCatalogReply is an alias for ProductCatalogResponse

Deprecated: use ProductCatalogResponse

type ProductCatalogRequest

type ProductCatalogRequest struct {
	// IncludeBeta is the includebeta value.
	IncludeBeta bool `query:"include_beta" description:"Whether to include beta products in the catalog" example:"false"`
	// IncludePrivate is the includeprivate value.
	IncludePrivate bool `query:"include_private" description:"Whether to include private products in the catalog" example:"false"`
}

ProductCatalogRequest

func (ProductCatalogRequest) ExampleSet added in v1.0.25

func (ProductCatalogRequest) ExampleSet() map[string]any

ExampleSet returns the curated named examples published for ProductCatalogRequest in the OpenAPI spec

func (*ProductCatalogRequest) Validate

func (r *ProductCatalogRequest) Validate() error

Validate ensures the required fields are set on the ProductCatalogRequest

type ProductCatalogResponse added in v1.0.25

type ProductCatalogResponse struct {
	// Reply is the reply value.
	rout.Reply
	// Catalog is the catalog value.
	models.Catalog
}

ProductCatalogResponse holds the fields that are sent on a response to the `/products` endpoint

func (ProductCatalogResponse) ExampleSet added in v1.0.25

func (ProductCatalogResponse) ExampleSet() map[string]any

ExampleSet returns the curated named examples published for ProductCatalogResponse in the OpenAPI spec

type RefreshReply deprecated

type RefreshReply = RefreshResponse

RefreshReply is an alias for RefreshResponse

Deprecated: use RefreshResponse

type RefreshRequest

type RefreshRequest struct {
	// RefreshToken is the refresh_token value.
	RefreshToken string `json:"refresh_token" description:"The token to be used to refresh the access token after expiration"`
}

RefreshRequest contains the refresh token used to obtain new access tokens

func (RefreshRequest) ExampleSet added in v1.0.25

func (RefreshRequest) ExampleSet() map[string]any

ExampleSet returns the curated named examples published for RefreshRequest in the OpenAPI spec

func (*RefreshRequest) Validate

func (r *RefreshRequest) Validate() error

Validate ensures the required fields are set on the RefreshRequest request

type RefreshResponse added in v1.0.25

type RefreshResponse struct {
	// Reply is the reply value.
	rout.Reply
	// Message is the message value.
	Message string `json:"message,omitempty"`
	// AuthData is the authdata value.
	AuthData
}

RefreshResponse contains new authentication tokens after successful refresh

func (*RefreshResponse) ExampleResponse added in v1.0.25

func (r *RefreshResponse) ExampleResponse() any

ExampleResponse returns an example RefreshResponse for OpenAPI documentation

func (RefreshResponse) ExampleSet added in v1.0.25

func (RefreshResponse) ExampleSet() map[string]any

ExampleSet returns the curated named examples published for RefreshResponse in the OpenAPI spec

type RegisterReply deprecated

type RegisterReply = RegisterResponse

RegisterReply is an alias for RegisterResponse

Deprecated: use RegisterResponse

type RegisterRequest

type RegisterRequest struct {
	// FirstName is the first_name value.
	FirstName string `json:"first_name,omitempty" description:"The first name of the user" example:"Jon"`
	// LastName is the last_name value.
	LastName string `json:"last_name,omitempty" description:"The last name of the user" example:"Snow"`
	// Email is the email value.
	Email string `json:"email,omitempty" description:"The email address of the user" example:"jsnow@example.com"`
	// Password is the password value.
	Password string `` /* 130-byte string literal not displayed */
	// Token is the token value.
	Token *string `` /* 126-byte string literal not displayed */
}

RegisterRequest contains user registration information for creating new accounts

func (RegisterRequest) ExampleSet added in v1.0.25

func (RegisterRequest) ExampleSet() map[string]any

ExampleSet returns the curated named examples published for RegisterRequest in the OpenAPI spec

func (*RegisterRequest) Validate

func (r *RegisterRequest) Validate() error

Validate ensures the required fields are set on the RegisterRequest request

type RegisterResponse added in v1.0.25

type RegisterResponse struct {
	// Reply is the reply value.
	rout.Reply
	// ID is the user_id value.
	ID string `json:"user_id" description:"The ID of the user that was created" example:"01J4EXD5MM60CX4YNYN0DEE3Y1"`
	// Email is the email value.
	Email string `json:"email" description:"The email address of the user" example:"jsnow@example.com"`
	// Message is the message value.
	Message string `json:"message"`
	// Token is the token value.
	Token string `json:"token,omitempty" exclude:"true"` // only used for requests against local development, excluded from OpenAPI documentation
}

RegisterResponse contains authentication tokens and user information after successful registration

func (*RegisterResponse) ExampleResponse added in v1.0.25

func (r *RegisterResponse) ExampleResponse() any

ExampleResponse returns an example RegisterResponse for OpenAPI documentation

func (RegisterResponse) ExampleSet added in v1.0.25

func (RegisterResponse) ExampleSet() map[string]any

ExampleSet returns the curated named examples published for RegisterResponse in the OpenAPI spec

type ResendQuestionnaireRequest added in v1.0.10

type ResendQuestionnaireRequest struct {
	// Email is the email address associated with the assessment response
	Email string `json:"email" description:"The email address associated with the assessment response"`
	// AssessmentID is the ID of the assessment
	AssessmentID string `json:"assessment_id" description:"The ID of the assessment"`
}

ResendQuestionnaireRequest contains fields for requesting a new questionnaire auth email

func (ResendQuestionnaireRequest) ExampleSet added in v1.0.25

func (ResendQuestionnaireRequest) ExampleSet() map[string]any

ExampleSet returns the curated named examples published for ResendQuestionnaireRequest in the OpenAPI spec

func (*ResendQuestionnaireRequest) Validate added in v1.0.10

func (r *ResendQuestionnaireRequest) Validate() error

Validate ensures the required fields are set on the ResendQuestionnaireRequest

type ResendReply deprecated

type ResendReply = ResendResponse

ResendReply is an alias for ResendResponse

Deprecated: use ResendResponse

type ResendRequest

type ResendRequest struct {
	// Email is the email value.
	Email string `` /* 134-byte string literal not displayed */
}

ResendRequest contains fields for a resend email verification request to the `/resend` endpoint

func (ResendRequest) ExampleSet added in v1.0.25

func (ResendRequest) ExampleSet() map[string]any

ExampleSet returns the curated named examples published for ResendRequest in the OpenAPI spec

func (*ResendRequest) Validate

func (r *ResendRequest) Validate() error

Validate ensures the required fields are set on the ResendRequest request

type ResendResponse added in v1.0.25

type ResendResponse struct {
	// Reply is the reply value.
	rout.Reply
	// Message is the message value.
	Message string `json:"message"`
}

ResendResponse holds the fields that are sent on a response to the `/resend` endpoint

func (*ResendResponse) ExampleResponse added in v1.0.25

func (r *ResendResponse) ExampleResponse() any

ExampleResponse returns an example ResendResponse for OpenAPI documentation

func (ResendResponse) ExampleSet added in v1.0.25

func (ResendResponse) ExampleSet() map[string]any

ExampleSet returns the curated named examples published for ResendResponse in the OpenAPI spec; the reply is shared by the resend email and resend questionnaire endpoints

type ResetPasswordReply deprecated

type ResetPasswordReply = ResetPasswordResponse

ResetPasswordReply is an alias for ResetPasswordResponse

Deprecated: use ResetPasswordResponse

type ResetPasswordRequest

type ResetPasswordRequest struct {
	// Password is the password value.
	Password string `json:"password" description:"The new password to be used for authentication"`
	// Token is the token value.
	Token string `json:"token" description:"The token to be used to reset the password, token is sent via email"`
}

ResetPasswordRequest contains user input required to reset a user's password using /password-reset endpoint

func (ResetPasswordRequest) ExampleSet added in v1.0.25

func (ResetPasswordRequest) ExampleSet() map[string]any

ExampleSet returns the curated named examples published for ResetPasswordRequest in the OpenAPI spec

func (*ResetPasswordRequest) Validate

func (r *ResetPasswordRequest) Validate() error

Validate ensures the required fields are set on the ResetPasswordRequest request

type ResetPasswordResponse added in v1.0.25

type ResetPasswordResponse struct {
	// Reply is the reply value.
	rout.Reply
	// Message is the message value.
	Message string `json:"message"`
}

ResetPasswordResponse is the response returned from a non-successful password reset request on success, no content is returned (204)

func (*ResetPasswordResponse) ExampleResponse added in v1.0.25

func (r *ResetPasswordResponse) ExampleResponse() any

ExampleResponse returns an example ResetPasswordResponse for OpenAPI documentation

func (ResetPasswordResponse) ExampleSet added in v1.0.25

func (ResetPasswordResponse) ExampleSet() map[string]any

ExampleSet returns the curated named examples published for ResetPasswordResponse in the OpenAPI spec

type RolesReply deprecated added in v1.0.24

type RolesReply = RolesResponse

RolesReply is an alias for RolesResponse

Deprecated: use RolesResponse

type RolesRequest added in v1.0.24

type RolesRequest struct{}

RolesRequest contains roles that can be assigned to users on top of org roles

func (RolesRequest) ExampleSet added in v1.0.25

func (RolesRequest) ExampleSet() map[string]any

ExampleSet returns the curated named examples published for RolesRequest in the OpenAPI spec

func (*RolesRequest) Validate added in v1.0.25

func (r *RolesRequest) Validate() error

Validate ensures the required fields are set on the RolesRequest

type RolesResponse added in v1.0.25

type RolesResponse struct {
	// Reply is the reply value.
	rout.Reply
	// Roles is a list of organization responsibility roles that can be assigned.
	Roles []OrganizationRole `json:"roles,omitempty" description:"Organization roles and responsibilities that can be assigned"`
}

RolesResponse holds the fields that are sent on a response to the `/roles` endpoint

func (*RolesResponse) ExampleResponse added in v1.0.25

func (r *RolesResponse) ExampleResponse() any

ExampleResponse returns an example RolesResponse for OpenAPI documentation

type RunIntegrationOperationBody added in v1.0.18

type RunIntegrationOperationBody struct {
	// Operation is the operation identifier.
	Operation string `json:"operation"`
	// Config holds optional operation-specific configuration as a raw JSON object.
	Config json.RawMessage `json:"config,omitempty"`
}

RunIntegrationOperationBody is the request body for triggering a provider operation.

type RunIntegrationOperationRequest added in v1.0.18

type RunIntegrationOperationRequest struct {
	// IntegrationID is the installation record to run the operation against.
	IntegrationID string `param:"integrationID" description:"Integration installation ID" example:"01J4HMNDSZCCQBTY93BF9CBF5D"`
	// Body holds the operation name and optional configuration.
	Body RunIntegrationOperationBody `json:"body"`
}

RunIntegrationOperationRequest is the request type for running an integration operation.

type RunIntegrationOperationResponse added in v1.0.18

type RunIntegrationOperationResponse struct {
	rout.Reply
	// Provider is the integration definition ID.
	Provider string `json:"provider"`
	// Operation is the operation identifier that was executed.
	Operation string `json:"operation"`
	// Status is the operation result status (e.g. ok, queued, error).
	Status string `json:"status"`
	// Summary is a human-readable description of the result.
	Summary string `json:"summary,omitempty"`
	// Details holds structured result data specific to the operation.
	Details json.RawMessage `json:"details,omitempty"`
}

RunIntegrationOperationResponse is the response after executing or queuing a provider operation.

type SSOCallbackRequest

type SSOCallbackRequest struct {
	// Code is the code value.
	Code string `json:"code" query:"code" description:"authorization code" example:"abc"`
	// State is the state value.
	State string `json:"state" query:"state" description:"state value" example:"state123"`
	// OrganizationID is the organization_id value.
	OrganizationID string `json:"organization_id" query:"organization_id" description:"organization id" example:"01J4EXD5MM60CX4YNYN0DEE3Y1"`
}

SSOCallbackRequest holds the query parameters for completing the SSO login flow

func (*SSOCallbackRequest) Validate

func (r *SSOCallbackRequest) Validate() error

Validate ensures the required fields are set on the SSOCallbackRequest

type SSOInitiateRequest added in v1.0.25

type SSOInitiateRequest struct {
	// SlugName is the organization slug used to resolve which organization's SSO flow to start
	SlugName string `param:"slug_name" description:"the organization slug" example:"acme"`
}

SSOInitiateRequest holds the path parameters for the public, shareable SSO initiation endpoint

func (SSOInitiateRequest) ExampleSet added in v1.0.25

func (SSOInitiateRequest) ExampleSet() map[string]any

ExampleSet returns the curated named examples published for SSOInitiateRequest in the OpenAPI spec

func (*SSOInitiateRequest) Validate added in v1.0.25

func (r *SSOInitiateRequest) Validate() error

Validate ensures the required fields are set on the SSOInitiateRequest

type SSOLoginReply deprecated

type SSOLoginReply = SSOLoginResponse

SSOLoginReply is an alias for SSOLoginResponse

Deprecated: use SSOLoginResponse

type SSOLoginRequest

type SSOLoginRequest struct {
	// OrganizationID is the organization_id value.
	OrganizationID string `json:"organization_id" query:"organization_id" description:"organization id" example:"01J4EXD5MM60CX4YNYN0DEE3Y1"`
	// ReturnURL is the return value.
	ReturnURL string `json:"return" query:"return" description:"return url after authentication" example:"https://app.mitb.com"`
	// IsTest is the is_test value.
	IsTest bool `json:"is_test" query:"is_test" description:"Used when testing the sso was successfully connected"`
}

SSOLoginRequest holds the query parameters for initiating an SSO login flow

func (*SSOLoginRequest) Validate

func (r *SSOLoginRequest) Validate() error

Validate ensures the required fields are set on the SSOLoginRequest

type SSOLoginResponse added in v1.0.25

type SSOLoginResponse struct {
	// Reply is the reply value.
	rout.Reply
	// RedirectURI is the redirect_uri value.
	RedirectURI string `json:"redirect_uri,omitempty"`
}

SSOLoginResponse is the response for the SSO login

type SSOStatusReply deprecated

type SSOStatusReply = SSOStatusResponse

SSOStatusReply is an alias for SSOStatusResponse

Deprecated: use SSOStatusResponse

type SSOStatusRequest

type SSOStatusRequest struct {
	// Resource is the resource value.
	Resource string `query:"resource" description:"organization or user email to check" example:"org:01J4EXD5MM60CX4YNYN0DEE3Y1"`
}

SSOStatusRequest is the request to check if SSO login is enforced for an organization

func (*SSOStatusRequest) Validate

func (r *SSOStatusRequest) Validate() error

Validate ensures the required fields are set on the SSOStatusRequest request

type SSOStatusResponse added in v1.0.25

type SSOStatusResponse struct {
	// Reply is the reply value.
	rout.Reply
	// Enforced is the enforced value.
	Enforced bool `json:"enforced"`
	// Provider is the provider value.
	Provider enums.SSOProvider `json:"provider,omitempty"`
	// DiscoveryURL is the discovery_url value.
	DiscoveryURL string `json:"discovery_url,omitempty"`
	// SAMLSignInURL is the saml_signin_url value.
	SAMLSignInURL string `json:"saml_signin_url,omitempty"`
	// OrganizationID is the organization_id value.
	OrganizationID string `json:"organization_id,omitempty"`
	// OrgTFAEnforced is the tfa_enforced value.
	OrgTFAEnforced bool `json:"tfa_enforced"`
	// UserTFAEnabled is the user_tfa_enabled value.
	UserTFAEnabled bool `json:"user_tfa_enabled,omitempty"`
	// IsOrgOwner is the is_org_owner value.
	IsOrgOwner bool `json:"is_org_owner,omitempty"`
}

SSOStatusResponse is the response for SSOStatusRequest

func (*SSOStatusResponse) ExampleResponse added in v1.0.25

func (r *SSOStatusResponse) ExampleResponse() any

ExampleResponse returns an example SSOStatusResponse for OpenAPI documentation

type SSOTokenAuthorizeReply deprecated

type SSOTokenAuthorizeReply = SSOTokenAuthorizeResponse

SSOTokenAuthorizeReply is an alias for SSOTokenAuthorizeResponse

Deprecated: use SSOTokenAuthorizeResponse

type SSOTokenAuthorizeRequest

type SSOTokenAuthorizeRequest struct {
	// OrganizationID is the organization_id value.
	OrganizationID string `json:"organization_id" query:"organization_id" description:"organization id" example:"01J4EXD5MM60CX4YNYN0DEE3Y1"`
	// TokenID is the token_id value.
	TokenID string `json:"token_id" query:"token_id" description:"token id to authorize" example:"01JJFVMGENQS9ZG3GVA50QVX5E"`
	// TokenType is the token_type value.
	TokenType string `json:"token_type" query:"token_type" description:"token type: api or personal" example:"api"`
}

SSOTokenAuthorizeRequest is the request for authorizing a token for SSO use with an organization

func (*SSOTokenAuthorizeRequest) Validate

func (r *SSOTokenAuthorizeRequest) Validate() error

Validate ensures required fields are set on the SSOTokenAuthorizeRequest

type SSOTokenAuthorizeResponse added in v1.0.25

type SSOTokenAuthorizeResponse struct {
	// Reply is the reply value.
	rout.Reply
	// OrganizationID is the organization_id value.
	OrganizationID string `json:"organization_id"`
	// TokenID is the token_id value.
	TokenID string `json:"token_id"`
	// Message is the message value.
	Message string `json:"message,omitempty"`
}

SSOTokenAuthorizeResponse is returned when a token has been successfully authorized for SSO

func (*SSOTokenAuthorizeResponse) ExampleResponse added in v1.0.25

func (r *SSOTokenAuthorizeResponse) ExampleResponse() any

ExampleResponse returns an example SSOTokenAuthorizeResponse for OpenAPI documentation

type SSOTokenCallbackRequest

type SSOTokenCallbackRequest struct {
	// Code is the code value.
	Code string `json:"code" query:"code" description:"authorization code" example:"abc"`
	// State is the state value.
	State string `json:"state" query:"state" description:"state value" example:"state123"`
}

SSOTokenCallbackRequest holds the query parameters for completing token SSO authorization

func (*SSOTokenCallbackRequest) Validate

func (r *SSOTokenCallbackRequest) Validate() error

Validate ensures required fields are set on the SSOTokenCallbackRequest

type ScopesReply deprecated added in v1.0.24

type ScopesReply = ScopesResponse

ScopesReply is an alias for ScopesResponse

Deprecated: use ScopesResponse

type ScopesRequest added in v1.0.24

type ScopesRequest struct{}

ScopesRequest contains scopes that can be used for an API token

func (ScopesRequest) ExampleSet added in v1.0.25

func (ScopesRequest) ExampleSet() map[string]any

ExampleSet returns the curated named examples published for ScopesRequest in the OpenAPI spec

func (*ScopesRequest) Validate added in v1.0.24

func (r *ScopesRequest) Validate() error

Validate ensures the required fields are set on the ScopesRequest

type ScopesResponse added in v1.0.25

type ScopesResponse struct {
	// Reply is the reply value.
	rout.Reply
	// Scopes is a map of object types to the scopes
	Scopes map[string][]string `json:"scopes,omitempty" description:"A map of object types to operations that can be set for an API Token"`
}

ScopesResponse holds the fields that are sent on a response to the `/scopes` endpoint

func (*ScopesResponse) ExampleResponse added in v1.0.25

func (r *ScopesResponse) ExampleResponse() any

ExampleResponse returns an example ScopesResponse for OpenAPI documentation

type SnapshotReply deprecated added in v1.0.5

type SnapshotReply = SnapshotResponse

SnapshotReply is an alias for SnapshotResponse

Deprecated: use SnapshotResponse

type SnapshotRequest added in v1.0.5

type SnapshotRequest struct {
	// URL is the url value.
	URL string `json:"url" description:"The URL of the domain to take a snapshot of" example:"https://www.example.com"`
	// WaitForSelector is the waitForSelector value.
	WaitForSelector string `` /* 132-byte string literal not displayed */
}

SnapshotRequest contains fields for a snapshot request to the `/snapshot` endpoint

func (*SnapshotRequest) Validate added in v1.0.5

func (r *SnapshotRequest) Validate() error

Validate ensures the required fields are set on the SnapshotRequest request

type SnapshotResponse added in v1.0.25

type SnapshotResponse struct {
	// Reply is the reply value.
	rout.Reply
	// Message is the message value.
	Message string `json:"message"`
	// Image is the image value.
	Image string `json:"image" description:"Base64-encoded image data of the snapshot"`
	// MIMEType is the mimeType value.
	MIMEType string `json:"mimeType" description:"MIME type of the snapshot image" example:"image/png"`
}

SnapshotResponse holds the fields that are sent on a response to the `/snapshot` endpoint

func (*SnapshotResponse) ExampleResponse added in v1.0.25

func (r *SnapshotResponse) ExampleResponse() any

ExampleResponse returns an example SnapshotResponse for OpenAPI documentation

type StartImpersonationReply deprecated

type StartImpersonationReply = StartImpersonationResponse

StartImpersonationReply is an alias for StartImpersonationResponse

Deprecated: use StartImpersonationResponse

type StartImpersonationRequest

type StartImpersonationRequest struct {
	// TargetUserID is the target_user_id value.
	TargetUserID string `json:"target_user_id" validate:"required" description:"The ID of the user to impersonate"`
	// Type is the type value.
	Type string `json:"type" validate:"required,oneof=support job admin" description:"The type of impersonation (support, job, admin)"`
	// Reason is the reason value.
	Reason string `json:"reason" validate:"required,min=10,max=500" description:"Reason for the impersonation"`
	// Duration is the duration_hours value.
	Duration *int `json:"duration_hours,omitempty" description:"Duration in hours (optional, defaults to 1 hour)"`
	// OrganizationID is the organization_id value.
	OrganizationID string `json:"organization_id,omitempty" description:"Organization context for impersonation"`
}

StartImpersonationRequest represents a request to start impersonating a user

func (*StartImpersonationRequest) Validate

func (r *StartImpersonationRequest) Validate() error

Validate ensures the required fields are set on the StartImpersonationRequest

type StartImpersonationResponse added in v1.0.25

type StartImpersonationResponse struct {
	// Reply is the reply value.
	rout.Reply
	// Token is the token value.
	Token string `json:"token" description:"The impersonation token"`
	// ExpiresAt is the expires_at value.
	ExpiresAt time.Time `json:"expires_at" description:"When the impersonation token expires"`
	// SessionID is the session_id value.
	SessionID string `json:"session_id" description:"The impersonation session ID"`
	// Message is the message value.
	Message string `json:"message" description:"Success message"`
}

StartImpersonationResponse represents the response when starting impersonation

func (*StartImpersonationResponse) ExampleResponse added in v1.0.25

func (r *StartImpersonationResponse) ExampleResponse() any

ExampleResponse returns an example StartImpersonationResponse for OpenAPI documentation

type StripeWebhookRequest

type StripeWebhookRequest struct {
	// APIVersion is the apiversion value.
	APIVersion string `query:"api_version" description:"Stripe API version for this webhook request" example:"2024-11-20.acacia"`
}

StripeWebhookRequest contains the query parameters for Stripe webhook requests

func (*StripeWebhookRequest) Validate

func (r *StripeWebhookRequest) Validate() error

Validate ensures the StripeWebhookRequest is valid

type SubmitQuestionnaireRequest

type SubmitQuestionnaireRequest struct {
	// AssessmentID is the assessment_id value.
	AssessmentID string `json:"assessment_id,omitempty"`
	// Data is the data value.
	Data map[string]any `json:"data" binding:"required"`
	// IsDraft when true saves partial progress without completing the questionnaire.
	IsDraft bool `json:"is_draft,omitempty"`
}

SubmitQuestionnaireRequest is the request to submit questionnaire response data

func (SubmitQuestionnaireRequest) ExampleSet added in v1.0.25

func (SubmitQuestionnaireRequest) ExampleSet() map[string]any

ExampleSet returns the curated named examples published for SubmitQuestionnaireRequest in the OpenAPI spec

type SubmitQuestionnaireResponse

type SubmitQuestionnaireResponse struct {
	// DocumentDataID is the document_data_id value.
	DocumentDataID string `json:"document_data_id"`
	// Status is the status value.
	Status string `json:"status"`
	// CompletedAt is the completed_at value.
	CompletedAt string `json:"completed_at,omitempty"`
}

SubmitQuestionnaireResponse is the response after successfully submitting questionnaire data

func (*SubmitQuestionnaireResponse) ExampleResponse

func (r *SubmitQuestionnaireResponse) ExampleResponse() any

ExampleResponse returns an example SubmitQuestionnaireResponse for OpenAPI documentation

func (SubmitQuestionnaireResponse) ExampleSet added in v1.0.25

func (SubmitQuestionnaireResponse) ExampleSet() map[string]any

ExampleSet returns the curated named examples published for SubmitQuestionnaireResponse in the OpenAPI spec

type SupportAccessReply deprecated added in v1.0.25

type SupportAccessReply = SupportAccessResponse

SupportAccessReply is an alias for SupportAccessResponse

Deprecated: use SupportAccessResponse

type SupportAccessResponse added in v1.0.25

type SupportAccessResponse struct {
	// Reply is the reply value
	rout.Reply
	// AuthData contains the session token required for subsequent authenticated requests
	AuthData
	// Token is the support session token to use as the Impersonation Authorization scheme
	Token string `json:"token" description:"The support access token"`
	// ExpiresAt is when the support token expires
	ExpiresAt time.Time `json:"expires_at" description:"When the support access token expires"`
	// SessionID is the support access session id
	SessionID string `json:"session_id" description:"The support access session ID"`
	// OrganizationID is the organization the support session is scoped to, for the impersonation banner
	OrganizationID string `json:"organization_id" description:"The organization the support session is scoped to"`
	// Impersonator is the individual who completed the second factor, for the impersonation banner and audit
	Impersonator string `json:"impersonator" description:"The individual acting in the support session"`
	// Message is a human readable success message
	Message string `json:"message" description:"Success message"`
}

SupportAccessResponse represents the support session token returned after the second factor completes

func (*SupportAccessResponse) ExampleResponse added in v1.0.25

func (r *SupportAccessResponse) ExampleResponse() any

ExampleResponse returns an example SupportAccessResponse for OpenAPI documentation

type SupportCallbackRequest added in v1.0.25

type SupportCallbackRequest struct {
	// Code is the authorization code returned by the identity provider
	Code string `json:"code" query:"code" description:"authorization code"`
	// State is the state value returned by the identity provider
	State string `json:"state" query:"state" description:"state value"`
}

SupportCallbackRequest carries the second factor identity provider authorization code and state

type SwitchOrganizationReply deprecated

type SwitchOrganizationReply = SwitchOrganizationResponse

SwitchOrganizationReply is an alias for SwitchOrganizationResponse

Deprecated: use SwitchOrganizationResponse

type SwitchOrganizationRequest

type SwitchOrganizationRequest struct {
	// TargetOrganizationID is the target_organization_id value.
	TargetOrganizationID string `json:"target_organization_id" description:"The ID of the organization to switch to" example:"01J4EXD5MM60CX4YNYN0DEE3Y1"`
}

SwitchOrganizationRequest contains the target organization ID being switched to for the /switch endpoint

func (SwitchOrganizationRequest) ExampleSet added in v1.0.25

func (SwitchOrganizationRequest) ExampleSet() map[string]any

ExampleSet returns the curated named examples published for SwitchOrganizationRequest in the OpenAPI spec

func (*SwitchOrganizationRequest) Validate

func (r *SwitchOrganizationRequest) Validate() error

Validate ensures the required fields are set on the SwitchOrganizationRequest request

type SwitchOrganizationResponse added in v1.0.25

type SwitchOrganizationResponse struct {
	// Reply is the reply value.
	rout.Reply
	// AuthData is the authdata value.
	AuthData
	// NeedsSSO is the needs_sso value.
	NeedsSSO bool `json:"needs_sso,omitempty"`
	// NeedsTFA is the needs_tfa value.
	NeedsTFA bool `json:"needs_tfa,omitempty"`
	// RedirectURI is the redirect_uri value.
	RedirectURI string `json:"redirect_uri,omitempty"`
}

SwitchOrganizationResponse holds the new authentication and session information for the user for the new organization

func (*SwitchOrganizationResponse) ExampleResponse added in v1.0.25

func (r *SwitchOrganizationResponse) ExampleResponse() any

ExampleResponse returns an example SwitchOrganizationResponse for OpenAPI documentation

func (SwitchOrganizationResponse) ExampleSet added in v1.0.25

func (SwitchOrganizationResponse) ExampleSet() map[string]any

ExampleSet returns the curated named examples published for SwitchOrganizationResponse in the OpenAPI spec

type TFAReply deprecated

type TFAReply = TFAResponse

TFAReply is an alias for TFAResponse

Deprecated: use TFAResponse

type TFARequest

type TFARequest struct {
	// TOTPCode is the totp_code value.
	TOTPCode string `` /* 127-byte string literal not displayed */
	// RecoveryCode is the recovery_code value.
	RecoveryCode string `` /* 133-byte string literal not displayed */
}

TFARequest holds the payload for verifying the 2fa code (/2fa/validate)

func (*TFARequest) Validate

func (r *TFARequest) Validate() error

Validate ensures the required fields are set on the TFARequest request

type TFAResponse added in v1.0.25

type TFAResponse struct {
	// Reply is the reply value.
	rout.Reply
	// Message is the message value.
	Message string `json:"message"`
}

TFAResponse holds the response to TFARequest

func (*TFAResponse) ExampleResponse added in v1.0.25

func (r *TFAResponse) ExampleResponse() any

ExampleResponse returns an example TFAResponse for OpenAPI documentation

type UnsubscribeReply deprecated added in v1.0.25

type UnsubscribeReply = UnsubscribeResponse

UnsubscribeReply is an alias for UnsubscribeResponse

Deprecated: use UnsubscribeResponse

type UnsubscribeRequest added in v1.0.25

type UnsubscribeRequest struct {
	// Token is the token value.
	Token string `query:"token" description:"The token to be used to unsubscribe, token is sent via email"`
}

UnsubscribeRequest contains the token used to unsubscribe from communications

func (*UnsubscribeRequest) BindsQueryParams added in v1.0.25

func (r *UnsubscribeRequest) BindsQueryParams() bool

BindsQueryParams opts this request into query-param binding on any HTTP method

func (UnsubscribeRequest) ExampleSet added in v1.0.25

func (UnsubscribeRequest) ExampleSet() map[string]any

ExampleSet returns the curated named examples published for UnsubscribeRequest in the OpenAPI spec

func (*UnsubscribeRequest) Validate added in v1.0.25

func (r *UnsubscribeRequest) Validate() error

Validate ensures the required fields are set on the UnsubscribeRequest request

type UnsubscribeResponse added in v1.0.25

type UnsubscribeResponse struct {
	// Reply is the reply value.
	rout.Reply
	// Message is the message value.
	Message string `json:"message,omitempty"`
}

UnsubscribeResponse holds the fields that are sent on a response to the `/unsubscribe` endpoint

func (UnsubscribeResponse) ExampleSet added in v1.0.25

func (UnsubscribeResponse) ExampleSet() map[string]any

ExampleSet returns the curated named examples published for UnsubscribeResponse in the OpenAPI spec

type UploadFilesReply deprecated

type UploadFilesReply = UploadFilesResponse

UploadFilesReply is an alias for UploadFilesResponse

Deprecated: use UploadFilesResponse

type UploadFilesRequest

type UploadFilesRequest struct {
	// UploadFile is the uploadfile value.
	UploadFile multipart.FileHeader `form:"uploadFile" description:"The file to be uploaded"`
}

UploadFilesRequest contains file upload data and metadata

type UploadFilesResponse added in v1.0.25

type UploadFilesResponse struct {
	// Reply is the reply value.
	rout.Reply
	// Message is the message value.
	Message string `json:"message,omitempty"`
	// FileCount is the file_count value.
	FileCount int64 `json:"file_count,omitempty" description:"The number of files uploaded"`
	// Files is the files value.
	Files []File `json:"files,omitempty" description:"The files that were uploaded"`
}

UploadFilesResponse holds the fields that are sent on a response to the `/upload` endpoint

func (*UploadFilesResponse) ExampleResponse added in v1.0.25

func (r *UploadFilesResponse) ExampleResponse() any

ExampleResponse returns an example UploadFilesResponse for OpenAPI documentation

type UserInfoReply deprecated

type UserInfoReply = UserInfoResponse

UserInfoReply is an alias for UserInfoResponse

Deprecated: use UserInfoResponse

type UserInfoResponse added in v1.0.25

type UserInfoResponse struct {
	// Reply is the reply value.
	rout.Reply
	// ID is the id value.
	ID string `json:"id" description:"The ID of the user" example:"01J4EXD5MM60CX4YNYN0DEE3Y1"`
	// Email is the email value.
	Email string `json:"email" description:"The email address of the user" example:"jsnow@example.com"`
	// FirstName is the first_name value.
	FirstName string `json:"first_name,omitempty" description:"The first name of the user" example:"Jon"`
	// LastName is the last_name value.
	LastName string `json:"last_name,omitempty" description:"The last name of the user" example:"Snow"`
	// DisplayName is the display_name value.
	DisplayName string `json:"display_name,omitempty" description:"The display name of the user" example:"Jon Snow"`
	// AvatarRemoteURL is the avatar_remote_url value.
	AvatarRemoteURL *string `json:"avatar_remote_url,omitempty" description:"URL of the user's remote avatar" example:"https://example.com/avatar.jpg"`
	// LastSeen is the last_seen value.
	LastSeen *string `json:"last_seen,omitempty" description:"The time the user was last seen" example:"2023-01-01T00:00:00Z"`
	// Role is the role value.
	Role string `json:"role,omitempty" description:"The user's role" example:"ADMIN"`
	// Sub is the sub value.
	Sub string `json:"sub" description:"The subject of the user JWT" example:"user123"`
}

UserInfoResponse contains user information for authenticated requests

type VerifyReply deprecated

type VerifyReply = VerifyResponse

VerifyReply is an alias for VerifyResponse

Deprecated: use VerifyResponse

type VerifyRequest

type VerifyRequest struct {
	// Token is the token value.
	Token string `query:"token" description:"The token to be used to verify the email address, token is sent via email"`
}

VerifyRequest contains email verification token

func (VerifyRequest) ExampleSet added in v1.0.25

func (VerifyRequest) ExampleSet() map[string]any

ExampleSet returns the curated named examples published for VerifyRequest in the OpenAPI spec

func (*VerifyRequest) Validate

func (r *VerifyRequest) Validate() error

Validate ensures the required fields are set on the VerifyRequest request

type VerifyResponse added in v1.0.25

type VerifyResponse struct {
	// Reply is the reply value.
	rout.Reply
	// ID is the user_id value.
	ID string `json:"user_id" description:"The ID of the user that was created" example:"01J4EXD5MM60CX4YNYN0DEE3Y1"`
	// Email is the email value.
	Email string `json:"email" description:"The email address of the user" example:"jsnow@example.com"`
	// Message is the message value.
	Message string `json:"message,omitempty"`
	// AuthData is the authdata value.
	AuthData
}

VerifyResponse holds the fields that are sent on a response to the `/verify` endpoint

func (*VerifyResponse) ExampleResponse added in v1.0.25

func (r *VerifyResponse) ExampleResponse() any

ExampleResponse returns an example VerifyResponse for OpenAPI documentation

func (VerifyResponse) ExampleSet added in v1.0.25

func (VerifyResponse) ExampleSet() map[string]any

ExampleSet returns the curated named examples published for VerifyResponse in the OpenAPI spec

type VerifySubscribeReply deprecated

type VerifySubscribeReply = VerifySubscribeResponse

VerifySubscribeReply is an alias for VerifySubscribeResponse

Deprecated: use VerifySubscribeResponse

type VerifySubscribeRequest

type VerifySubscribeRequest struct {
	// Token is the token value.
	Token string `query:"token" description:"The token to be used to verify the subscription, token is sent via email"`
}

VerifySubscribeRequest contains subscription verification information

func (*VerifySubscribeRequest) BindsQueryParams added in v1.0.25

func (r *VerifySubscribeRequest) BindsQueryParams() bool

BindsQueryParams opts this request into query-param binding on any HTTP method

func (VerifySubscribeRequest) ExampleSet added in v1.0.25

func (VerifySubscribeRequest) ExampleSet() map[string]any

ExampleSet returns the curated named examples published for VerifySubscribeRequest in the OpenAPI spec

func (*VerifySubscribeRequest) Validate

func (r *VerifySubscribeRequest) Validate() error

Validate ensures the required fields are set on the VerifySubscribeRequest request

type VerifySubscribeResponse added in v1.0.25

type VerifySubscribeResponse struct {
	// Reply is the reply value.
	rout.Reply
	// Message is the message value.
	Message string `json:"message,omitempty"`
}

VerifySubscribeResponse holds the fields that are sent on a response to the `/subscribe/verify` endpoint

func (VerifySubscribeResponse) ExampleSet added in v1.0.25

func (VerifySubscribeResponse) ExampleSet() map[string]any

ExampleSet returns the curated named examples published for VerifySubscribeResponse in the OpenAPI spec

type WebauthnBeginLoginResponse

type WebauthnBeginLoginResponse struct {
	// Reply is the reply value.
	Reply rout.Reply
	// CredentialAssertion is the credentialassertion value.
	*protocol.CredentialAssertion
	// Session is the session value.
	Session string `json:"session,omitempty"`
}

WebauthnBeginLoginResponse is the response to begin a webauthn login this includes the credential assertion options and the session token

func (*WebauthnBeginLoginResponse) ExampleResponse

func (r *WebauthnBeginLoginResponse) ExampleResponse() any

ExampleResponse returns an example WebauthnBeginLoginResponse for OpenAPI documentation

type WebauthnBeginRegistrationResponse

type WebauthnBeginRegistrationResponse struct {
	// Reply is the reply value.
	Reply rout.Reply
	// CredentialCreation is the credentialcreation value.
	*protocol.CredentialCreation
	// Session is the session value.
	Session string `json:"session,omitempty"`
}

WebauthnBeginRegistrationResponse is the response to begin a webauthn login this includes the credential creation options and the session token

func (*WebauthnBeginRegistrationResponse) ExampleResponse

func (r *WebauthnBeginRegistrationResponse) ExampleResponse() any

ExampleResponse returns an example WebauthnBeginRegistrationResponse for OpenAPI documentation

type WebauthnLoginFinishRequest

type WebauthnLoginFinishRequest struct {
	// ID is the id value.
	ID string `json:"id" description:"The credential ID"`
	// RawID is the rawId value.
	RawID string `json:"rawId" description:"The raw credential ID"`
	// Type is the type value.
	Type string `json:"type" description:"The credential type, should be 'public-key'"`
	// AuthenticatorAttachment is the authenticatorAttachment value.
	AuthenticatorAttachment string `json:"authenticatorAttachment,omitempty" description:"How the authenticator is attached"`
	// ClientExtensionResults is the clientExtensionResults value.
	ClientExtensionResults map[string]interface{} `json:"clientExtensionResults,omitempty" description:"Extension results"`
	// Response is the response value.
	Response struct {
		AuthenticatorData string `json:"authenticatorData" description:"The authenticator data"`
		ClientDataJSON    string `json:"clientDataJSON" description:"The client data JSON"`
		Signature         string `json:"signature" description:"The assertion signature"`
		UserHandle        string `json:"userHandle,omitempty" description:"The user handle"`
	} `json:"response" description:"The authenticator response"`
}

WebauthnLoginFinishRequest is the request to finish webauthn login This represents the credential assertion response from the browser's WebAuthn API

type WebauthnLoginRequest

type WebauthnLoginRequest struct {
	// Email is the email value.
	Email string `json:"email,omitempty" description:"The email address associated with the account" example:"jsnow@example.com"`
}

WebauthnLoginRequest is the request to begin a webauthn login

func (*WebauthnLoginRequest) Validate

func (r *WebauthnLoginRequest) Validate() error

Validate ensures the required fields are set on the WebauthnLoginRequest request

type WebauthnLoginResponse

type WebauthnLoginResponse struct {
	// Reply is the reply value.
	rout.Reply
	// Message is the message value.
	Message string `json:"message,omitempty"`
	// AuthData is the authdata value.
	AuthData
}

WebauthnLoginResponse is the response after a successful webauthn login

func (*WebauthnLoginResponse) ExampleResponse

func (r *WebauthnLoginResponse) ExampleResponse() any

ExampleResponse returns an example WebauthnLoginResponse for OpenAPI documentation

type WebauthnRegistrationFinishRequest

type WebauthnRegistrationFinishRequest struct {
	// ID is the id value.
	ID string `json:"id" description:"The credential ID"`
	// RawID is the rawId value.
	RawID string `json:"rawId" description:"The raw credential ID"`
	// Type is the type value.
	Type string `json:"type" description:"The credential type, should be 'public-key'"`
	// AuthenticatorAttachment is the authenticatorAttachment value.
	AuthenticatorAttachment string `json:"authenticatorAttachment,omitempty" description:"How the authenticator is attached"`
	// ClientExtensionResults is the clientExtensionResults value.
	ClientExtensionResults map[string]interface{} `json:"clientExtensionResults,omitempty" description:"Extension results"`
	// Response is the response value.
	Response struct {
		AttestationObject  string   `json:"attestationObject" description:"The attestation object"`
		ClientDataJSON     string   `json:"clientDataJSON" description:"The client data JSON"`
		PublicKey          string   `json:"publicKey,omitempty" description:"The public key"`
		PublicKeyAlgorithm int      `json:"publicKeyAlgorithm,omitempty" description:"The public key algorithm"`
		Transports         []string `json:"transports,omitempty" description:"Available transports"`
		AuthenticatorData  string   `json:"authenticatorData,omitempty" description:"The authenticator data"`
	} `json:"response" description:"The authenticator response"`
}

WebauthnRegistrationFinishRequest is the request to finish webauthn registration This represents the credential creation response from the browser's WebAuthn API

type WebauthnRegistrationRequest

type WebauthnRegistrationRequest struct {
	// Email is the email value.
	Email string `json:"email" description:"The email address associated with the account" example:"jsnow@example.com"`
	// Name is the name value.
	Name string `json:"name,omitempty" description:"The name of the user" example:"Jon Snow"`
}

WebauthnRegistrationRequest is the request to begin a webauthn login

func (*WebauthnRegistrationRequest) Validate

func (r *WebauthnRegistrationRequest) Validate() error

type WebauthnRegistrationResponse

type WebauthnRegistrationResponse struct {
	// Reply is the reply value.
	rout.Reply
	// Message is the message value.
	Message string `json:"message,omitempty"`
	// AuthData is the authdata value.
	AuthData
}

WebauthnRegistrationResponse is the response after a successful webauthn registration

func (*WebauthnRegistrationResponse) ExampleResponse

func (r *WebauthnRegistrationResponse) ExampleResponse() any

ExampleResponse returns an example WebauthnRegistrationResponse for OpenAPI documentation

type WebfingerRequest

type WebfingerRequest struct {
	// Resource is the resource value.
	Resource string `query:"resource" description:"resource identifier prefixed with org: or acct:" example:"acct:meowmeow@kitties.com"`
}

WebfingerRequest represents the query parameters accepted by the `/.well-known/webfinger` endpoint

The `resource` field must be provided and should be prefixed with `org:` for organization lookups or `acct:` for user lookups

func (*WebfingerRequest) Validate

func (r *WebfingerRequest) Validate() error

Validate ensures a valid resource was provided on the WebfingerRequest

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL