Documentation
¶
Overview ¶
Package openapi provides http request and response structs
Index ¶
- Constants
- Variables
- type AccountAccessReplydeprecated
- type AccountAccessRequest
- type AccountAccessResponse
- type AccountFeaturesReplydeprecated
- type AccountFeaturesRequest
- type AccountFeaturesResponse
- type AccountRolesMeReplydeprecated
- type AccountRolesMeRequest
- type AccountRolesMeResponse
- type AccountRolesOrganizationReplydeprecated
- type AccountRolesOrganizationRequest
- type AccountRolesOrganizationResponse
- type AccountRolesReplydeprecated
- type AccountRolesRequest
- type AccountRolesResponse
- type AcmeSolverRequest
- type AuthData
- type AvailableAuthTypeLoginRequest
- type AvailableAuthTypeReplydeprecated
- type AvailableAuthTypeResponse
- type ConfigureIntegrationRequest
- type ConfigureIntegrationResponse
- type CreateTrustCenterAnonymousJWTResponse
- type DeleteIntegrationRequest
- type DeleteIntegrationResponse
- type DisconnectIntegrationRequest
- type EndImpersonationReplydeprecated
- type EndImpersonationRequest
- type EndImpersonationResponse
- type ExampleCSVRequest
- type ExampleProvider
- type ExampleSetProvider
- type File
- type FileDownload
- type FileDownloadReplydeprecated
- type FileDownloadResponse
- type ForgotPasswordReplydeprecated
- type ForgotPasswordRequest
- type ForgotPasswordResponse
- type GetIntegrationStatusRequest
- type GetIntegrationTokenRequest
- type GetQuestionnaireResponse
- type GitHubAppWebhookResponse
- type IntegrationAuthStartRequest
- type IntegrationConfig
- type IntegrationInstallationIdentity
- type IntegrationInstallationMetadata
- type IntegrationProviderMetadata
- type IntegrationProviderState
- type InviteReplydeprecated
- type InviteRequest
- type InviteResponse
- type JobRunnerRegistrationReplydeprecated
- type JobRunnerRegistrationRequestdeprecated
- type ListIntegrationsResponse
- type LoginReplydeprecated
- type LoginRequest
- type LoginResponse
- type LogoutReplydeprecated
- type LogoutRequest
- type LogoutResponse
- type OAuthFlowRequest
- type OAuthFlowResponse
- type OauthTokenRequest
- type OrganizationRole
- type OrganizationRolesReplydeprecated
- type OrganizationRolesRequest
- type OrganizationRolesResponse
- type ProductCatalogReplydeprecated
- type ProductCatalogRequest
- type ProductCatalogResponse
- type RefreshReplydeprecated
- type RefreshRequest
- type RefreshResponse
- type RegisterReplydeprecated
- type RegisterRequest
- type RegisterResponse
- type ResendQuestionnaireRequest
- type ResendReplydeprecated
- type ResendRequest
- type ResendResponse
- type ResetPasswordReplydeprecated
- type ResetPasswordRequest
- type ResetPasswordResponse
- type RolesReplydeprecated
- type RolesRequest
- type RolesResponse
- type RunIntegrationOperationBody
- type RunIntegrationOperationRequest
- type RunIntegrationOperationResponse
- type SSOCallbackRequest
- type SSOInitiateRequest
- type SSOLoginReplydeprecated
- type SSOLoginRequest
- type SSOLoginResponse
- type SSOStatusReplydeprecated
- type SSOStatusRequest
- type SSOStatusResponse
- type SSOTokenAuthorizeReplydeprecated
- type SSOTokenAuthorizeRequest
- type SSOTokenAuthorizeResponse
- type SSOTokenCallbackRequest
- type ScopesReplydeprecated
- type ScopesRequest
- type ScopesResponse
- type SnapshotReplydeprecated
- type SnapshotRequest
- type SnapshotResponse
- type StartImpersonationReplydeprecated
- type StartImpersonationRequest
- type StartImpersonationResponse
- type StripeWebhookRequest
- type SubmitQuestionnaireRequest
- type SubmitQuestionnaireResponse
- type SupportAccessReplydeprecated
- type SupportAccessResponse
- type SupportCallbackRequest
- type SwitchOrganizationReplydeprecated
- type SwitchOrganizationRequest
- type SwitchOrganizationResponse
- type TFAReplydeprecated
- type TFARequest
- type TFAResponse
- type UnsubscribeReplydeprecated
- type UnsubscribeRequest
- type UnsubscribeResponse
- type UploadFilesReplydeprecated
- type UploadFilesRequest
- type UploadFilesResponse
- type UserInfoReplydeprecated
- type UserInfoResponse
- type VerifyReplydeprecated
- type VerifyRequest
- type VerifyResponse
- type VerifySubscribeReplydeprecated
- type VerifySubscribeRequest
- type VerifySubscribeResponse
- type WebauthnBeginLoginResponse
- type WebauthnBeginRegistrationResponse
- type WebauthnLoginFinishRequest
- type WebauthnLoginRequest
- type WebauthnLoginResponse
- type WebauthnRegistrationFinishRequest
- type WebauthnRegistrationRequest
- type WebauthnRegistrationResponse
- type WebfingerRequest
Constants ¶
const ( // MinImpersonationReasonLength is the minimum length for impersonation reason MinImpersonationReasonLength = 10 // MaxImpersonationReasonLength is the maximum length for impersonation reason MaxImpersonationReasonLength = 500 )
Variables ¶
var ExampleAccountAccessResponse = AccountAccessResponse{ Reply: rout.Reply{Success: true}, Allowed: true, }
ExampleAccountAccessResponse is an example of a successful `/account/access` response for OpenAPI documentation
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
var ExampleAcmeSolverRequest = AcmeSolverRequest{
Path: "01J4HMNDSZCCQBTY93BF9CBF5D",
}
ExampleAcmeSolverRequest is an example ACME solver request for OpenAPI documentation
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
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.
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
var ExampleEndImpersonationRequest = EndImpersonationRequest{
SessionID: exampleULID("session"),
Reason: "Support task completed",
}
ExampleEndImpersonationRequest is an example request for OpenAPI documentation
var ExampleEndImpersonationResponse = EndImpersonationResponse{ Reply: rout.Reply{Success: true}, Message: "Impersonation session ended successfully", }
ExampleEndImpersonationResponse is an example response for OpenAPI documentation
var ExampleExampleCSVRequest = ExampleCSVRequest{
Filename: "actionplan",
}
ExampleLoginSuccessRequest is an example of a successful tfa validation request for OpenAPI documentation
var ExampleFileDownloadRequest = FileDownload{
Token: "token",
}
ExampleVerifySuccessRequest is an example of a successful verify request for OpenAPI documentation
var ExampleIntegrationAuthStartRequest = IntegrationAuthStartRequest{
DefinitionID: "def_01K0SLACK000000000000000001",
}
ExampleIntegrationAuthStartRequest is an example auth start request for OpenAPI documentation.
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
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
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
var ExampleRunIntegrationOperationRequest = RunIntegrationOperationRequest{ IntegrationID: "01J4HMNDSZCCQBTY93BF9CBF5D", Body: RunIntegrationOperationBody{ Operation: "HealthCheck", }, }
ExampleRunIntegrationOperationRequest is an example operation payload for OpenAPI documentation.
var ExampleSSOCallbackRequest = SSOCallbackRequest{
Code: "code",
State: "state",
OrganizationID: exampleULID("organization"),
}
ExampleSSOCallbackRequest is an example request for OpenAPI documentation
var ExampleSSOLoginRequest = SSOLoginRequest{
OrganizationID: exampleULID("organization"),
ReturnURL: "https://app.sitb.com",
}
ExampleSSOLoginRequest is an example request for OpenAPI documentation
var ExampleSSOStatusRequest = SSOStatusRequest{
Resource: "acct:mitb@theopenlane.io",
}
ExampleSSOStatusRequest is an example request for OpenAPI documentation
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
var ExampleSSOTokenAuthorizeRequest = SSOTokenAuthorizeRequest{
OrganizationID: exampleULID("organization"),
TokenID: exampleULID("token"),
TokenType: "api",
}
ExampleSSOTokenAuthorizeRequest is an example request for OpenAPI documentation
var ExampleSSOTokenAuthorizeResponse = SSOTokenAuthorizeResponse{ Reply: rout.Reply{Success: true}, OrganizationID: exampleULID("organization"), TokenID: exampleULID("token"), Message: "success", }
ExampleSSOTokenAuthorizeResponse is an example response for OpenAPI documentation
var ExampleSSOTokenCallbackRequest = SSOTokenCallbackRequest{
Code: "code",
State: "state",
}
ExampleSSOTokenCallbackRequest is an example request for OpenAPI documentation
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
var ExampleSnapshotSuccessRequest = SnapshotRequest{
URL: "https://www.example.com",
WaitForSelector: "img#main-image",
}
ExampleSnapshotSuccessRequest is an example of a successful snapshot request for OpenAPI documentation
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
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
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
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
var ExampleSupportCallbackRequest = SupportCallbackRequest{
Code: "authcode123",
State: "state123",
}
ExampleSupportCallbackRequest is an example request for OpenAPI documentation
var ExampleTFASSuccessResponse = TFAResponse{ Reply: rout.Reply{ Success: true, }, }
ExampleLoginSuccessResponse is an example of a successful tfa validation response for OpenAPI documentation
var ExampleTFASuccessRequest = TFARequest{
TOTPCode: "113371",
}
ExampleLoginSuccessRequest is an example of a successful tfa validation request for OpenAPI documentation
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
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
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
var ExampleWebauthnBeginLoginResponse = WebauthnBeginLoginResponse{ Reply: rout.Reply{Success: true}, Session: "session123", }
ExampleWebauthnBeginLoginResponse is an example WebAuthn begin login response for OpenAPI documentation
var ExampleWebauthnBeginRegistrationRequest = WebauthnRegistrationRequest{
Email: "sarahisthebest@sarahsthebest.com",
Name: "Sarah Funk",
}
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", }
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
var ExampleWebauthnLoginRequest = WebauthnLoginRequest{
Email: "",
}
ExampleWebauthnLoginRequest is an example WebAuthn login request for OpenAPI documentation
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
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
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
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
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 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