immich/mobile/openapi

openapi

Immich API

This Dart package is automatically generated by the OpenAPI Generator project:

• API version: 1.139.3
• Generator version: 7.8.0
• Build package: org.openapitools.codegen.languages.DartClientCodegen

Requirements

Dart 2.12 or later

Installation & Usage

Github

If this Dart package is published to Github, add the following dependency to your pubspec.yaml

dependencies:
  openapi:
    git: https://github.com/GIT_USER_ID/GIT_REPO_ID.git

Local

To use the package in your local drive, add the following dependency to your pubspec.yaml

dependencies:
  openapi:
    path: /path/to/openapi

Tests

TODO

Getting Started

Please follow the installation procedure and then run the following:

import 'package:openapi/api.dart';

// TODO Configure API key authorization: cookie
//defaultApiClient.getAuthentication<ApiKeyAuth>('cookie').apiKey = 'YOUR_API_KEY';
// uncomment below to setup prefix (e.g. Bearer) for API key, if needed
//defaultApiClient.getAuthentication<ApiKeyAuth>('cookie').apiKeyPrefix = 'Bearer';
// TODO Configure API key authorization: api_key
//defaultApiClient.getAuthentication<ApiKeyAuth>('api_key').apiKey = 'YOUR_API_KEY';
// uncomment below to setup prefix (e.g. Bearer) for API key, if needed
//defaultApiClient.getAuthentication<ApiKeyAuth>('api_key').apiKeyPrefix = 'Bearer';
// TODO Configure HTTP Bearer authorization: bearer
// Case 1. Use String Token
//defaultApiClient.getAuthentication<HttpBearerAuth>('bearer').setAccessToken('YOUR_ACCESS_TOKEN');
// Case 2. Use Function which generate token.
// String yourTokenGeneratorFunction() { ... }
//defaultApiClient.getAuthentication<HttpBearerAuth>('bearer').setAccessToken(yourTokenGeneratorFunction);

final api_instance = APIKeysApi();
final aPIKeyCreateDto = APIKeyCreateDto(); // APIKeyCreateDto | 

try {
    final result = api_instance.createApiKey(aPIKeyCreateDto);
    print(result);
} catch (e) {
    print('Exception when calling APIKeysApi->createApiKey: $e\n');
}

Documentation for API Endpoints

All URIs are relative to /api

Class	Method	HTTP request	Description
APIKeysApi	createApiKey	POST /api-keys
APIKeysApi	deleteApiKey	DELETE /api-keys/{id}
APIKeysApi	getApiKey	GET /api-keys/{id}
APIKeysApi	getApiKeys	GET /api-keys
APIKeysApi	getMyApiKey	GET /api-keys/me
APIKeysApi	updateApiKey	PUT /api-keys/{id}
ActivitiesApi	createActivity	POST /activities
ActivitiesApi	deleteActivity	DELETE /activities/{id}
ActivitiesApi	getActivities	GET /activities
ActivitiesApi	getActivityStatistics	GET /activities/statistics
AlbumsApi	addAssetsToAlbum	PUT /albums/{id}/assets
AlbumsApi	addAssetsToAlbums	PUT /albums/assets
AlbumsApi	addUsersToAlbum	PUT /albums/{id}/users
AlbumsApi	createAlbum	POST /albums
AlbumsApi	deleteAlbum	DELETE /albums/{id}
AlbumsApi	getAlbumInfo	GET /albums/{id}
AlbumsApi	getAlbumStatistics	GET /albums/statistics
AlbumsApi	getAllAlbums	GET /albums
AlbumsApi	removeAssetFromAlbum	DELETE /albums/{id}/assets
AlbumsApi	removeUserFromAlbum	DELETE /albums/{id}/user/{userId}
AlbumsApi	updateAlbumInfo	PATCH /albums/{id}
AlbumsApi	updateAlbumUser	PUT /albums/{id}/user/{userId}
AssetsApi	checkBulkUpload	POST /assets/bulk-upload-check	checkBulkUpload
AssetsApi	checkExistingAssets	POST /assets/exist	checkExistingAssets
AssetsApi	deleteAssets	DELETE /assets
AssetsApi	downloadAsset	GET /assets/{id}/original
AssetsApi	getAllUserAssetsByDeviceId	GET /assets/device/{deviceId}	getAllUserAssetsByDeviceId
AssetsApi	getAssetInfo	GET /assets/{id}
AssetsApi	getAssetStatistics	GET /assets/statistics
AssetsApi	getRandom	GET /assets/random
AssetsApi	playAssetVideo	GET /assets/{id}/video/playback
AssetsApi	replaceAsset	PUT /assets/{id}/original	replaceAsset
AssetsApi	runAssetJobs	POST /assets/jobs
AssetsApi	updateAsset	PUT /assets/{id}
AssetsApi	updateAssets	PUT /assets
AssetsApi	uploadAsset	POST /assets
AssetsApi	viewAsset	GET /assets/{id}/thumbnail
AuthAdminApi	unlinkAllOAuthAccountsAdmin	POST /admin/auth/unlink-all
AuthenticationApi	changePassword	POST /auth/change-password
AuthenticationApi	changePinCode	PUT /auth/pin-code
AuthenticationApi	getAuthStatus	GET /auth/status
AuthenticationApi	lockAuthSession	POST /auth/session/lock
AuthenticationApi	login	POST /auth/login
AuthenticationApi	logout	POST /auth/logout
AuthenticationApi	resetPinCode	DELETE /auth/pin-code
AuthenticationApi	setupPinCode	POST /auth/pin-code
AuthenticationApi	signUpAdmin	POST /auth/admin-sign-up
AuthenticationApi	unlockAuthSession	POST /auth/session/unlock
AuthenticationApi	validateAccessToken	POST /auth/validateToken
DeprecatedApi	getRandom	GET /assets/random
DownloadApi	downloadArchive	POST /download/archive
DownloadApi	getDownloadInfo	POST /download/info
DuplicatesApi	deleteDuplicate	DELETE /duplicates/{id}
DuplicatesApi	deleteDuplicates	DELETE /duplicates
DuplicatesApi	getAssetDuplicates	GET /duplicates
FacesApi	createFace	POST /faces
FacesApi	deleteFace	DELETE /faces/{id}
FacesApi	getFaces	GET /faces
FacesApi	reassignFacesById	PUT /faces/{id}
JobsApi	createJob	POST /jobs
JobsApi	getAllJobsStatus	GET /jobs
JobsApi	sendJobCommand	PUT /jobs/{id}
LibrariesApi	createLibrary	POST /libraries
LibrariesApi	deleteLibrary	DELETE /libraries/{id}
LibrariesApi	getAllLibraries	GET /libraries
LibrariesApi	getLibrary	GET /libraries/{id}
LibrariesApi	getLibraryStatistics	GET /libraries/{id}/statistics
LibrariesApi	scanLibrary	POST /libraries/{id}/scan
LibrariesApi	updateLibrary	PUT /libraries/{id}
LibrariesApi	validate	POST /libraries/{id}/validate
MapApi	getMapMarkers	GET /map/markers
MapApi	reverseGeocode	GET /map/reverse-geocode
MemoriesApi	addMemoryAssets	PUT /memories/{id}/assets
MemoriesApi	createMemory	POST /memories
MemoriesApi	deleteMemory	DELETE /memories/{id}
MemoriesApi	getMemory	GET /memories/{id}
MemoriesApi	memoriesStatistics	GET /memories/statistics
MemoriesApi	removeMemoryAssets	DELETE /memories/{id}/assets
MemoriesApi	searchMemories	GET /memories
MemoriesApi	updateMemory	PUT /memories/{id}
NotificationsApi	deleteNotification	DELETE /notifications/{id}
NotificationsApi	deleteNotifications	DELETE /notifications
NotificationsApi	getNotification	GET /notifications/{id}
NotificationsApi	getNotifications	GET /notifications
NotificationsApi	updateNotification	PUT /notifications/{id}
NotificationsApi	updateNotifications	PUT /notifications
NotificationsAdminApi	createNotification	POST /admin/notifications
NotificationsAdminApi	getNotificationTemplateAdmin	POST /admin/notifications/templates/{name}
NotificationsAdminApi	sendTestEmailAdmin	POST /admin/notifications/test-email
OAuthApi	finishOAuth	POST /oauth/callback
OAuthApi	linkOAuthAccount	POST /oauth/link
OAuthApi	redirectOAuthToMobile	GET /oauth/mobile-redirect
OAuthApi	startOAuth	POST /oauth/authorize
OAuthApi	unlinkOAuthAccount	POST /oauth/unlink
PartnersApi	createPartner	POST /partners/{id}
PartnersApi	getPartners	GET /partners
PartnersApi	removePartner	DELETE /partners/{id}
PartnersApi	updatePartner	PUT /partners/{id}
PeopleApi	createPerson	POST /people
PeopleApi	deletePeople	DELETE /people
PeopleApi	deletePerson	DELETE /people/{id}
PeopleApi	getAllPeople	GET /people
PeopleApi	getPerson	GET /people/{id}
PeopleApi	getPersonStatistics	GET /people/{id}/statistics
PeopleApi	getPersonThumbnail	GET /people/{id}/thumbnail
PeopleApi	mergePerson	POST /people/{id}/merge
PeopleApi	reassignFaces	PUT /people/{id}/reassign
PeopleApi	updatePeople	PUT /people
PeopleApi	updatePerson	PUT /people/{id}
SearchApi	getAssetsByCity	GET /search/cities
SearchApi	getExploreData	GET /search/explore
SearchApi	getSearchSuggestions	GET /search/suggestions
SearchApi	searchAssetStatistics	POST /search/statistics
SearchApi	searchAssets	POST /search/metadata
SearchApi	searchLargeAssets	POST /search/large-assets
SearchApi	searchPerson	GET /search/person
SearchApi	searchPlaces	GET /search/places
SearchApi	searchRandom	POST /search/random
SearchApi	searchSmart	POST /search/smart
ServerApi	deleteServerLicense	DELETE /server/license
ServerApi	getAboutInfo	GET /server/about
ServerApi	getApkLinks	GET /server/apk-links
ServerApi	getServerConfig	GET /server/config
ServerApi	getServerFeatures	GET /server/features
ServerApi	getServerLicense	GET /server/license
ServerApi	getServerStatistics	GET /server/statistics
ServerApi	getServerVersion	GET /server/version
ServerApi	getStorage	GET /server/storage
ServerApi	getSupportedMediaTypes	GET /server/media-types
ServerApi	getTheme	GET /server/theme
ServerApi	getVersionCheck	GET /server/version-check
ServerApi	getVersionHistory	GET /server/version-history
ServerApi	pingServer	GET /server/ping
ServerApi	setServerLicense	PUT /server/license
SessionsApi	createSession	POST /sessions
SessionsApi	deleteAllSessions	DELETE /sessions
SessionsApi	deleteSession	DELETE /sessions/{id}
SessionsApi	getSessions	GET /sessions
SessionsApi	lockSession	POST /sessions/{id}/lock
SessionsApi	updateSession	PUT /sessions/{id}
SharedLinksApi	addSharedLinkAssets	PUT /shared-links/{id}/assets
SharedLinksApi	createSharedLink	POST /shared-links
SharedLinksApi	getAllSharedLinks	GET /shared-links
SharedLinksApi	getMySharedLink	GET /shared-links/me
SharedLinksApi	getSharedLinkById	GET /shared-links/{id}
SharedLinksApi	removeSharedLink	DELETE /shared-links/{id}
SharedLinksApi	removeSharedLinkAssets	DELETE /shared-links/{id}/assets
SharedLinksApi	updateSharedLink	PATCH /shared-links/{id}
StacksApi	createStack	POST /stacks
StacksApi	deleteStack	DELETE /stacks/{id}
StacksApi	deleteStacks	DELETE /stacks
StacksApi	getStack	GET /stacks/{id}
StacksApi	removeAssetFromStack	DELETE /stacks/{id}/assets/{assetId}
StacksApi	searchStacks	GET /stacks
StacksApi	updateStack	PUT /stacks/{id}
SyncApi	deleteSyncAck	DELETE /sync/ack
SyncApi	getDeltaSync	POST /sync/delta-sync
SyncApi	getFullSyncForUser	POST /sync/full-sync
SyncApi	getSyncAck	GET /sync/ack
SyncApi	getSyncStream	POST /sync/stream
SyncApi	sendSyncAck	POST /sync/ack
SystemConfigApi	getConfig	GET /system-config
SystemConfigApi	getConfigDefaults	GET /system-config/defaults
SystemConfigApi	getStorageTemplateOptions	GET /system-config/storage-template-options
SystemConfigApi	updateConfig	PUT /system-config
SystemMetadataApi	getAdminOnboarding	GET /system-metadata/admin-onboarding
SystemMetadataApi	getReverseGeocodingState	GET /system-metadata/reverse-geocoding-state
SystemMetadataApi	getVersionCheckState	GET /system-metadata/version-check-state
SystemMetadataApi	updateAdminOnboarding	POST /system-metadata/admin-onboarding
TagsApi	bulkTagAssets	PUT /tags/assets
TagsApi	createTag	POST /tags
TagsApi	deleteTag	DELETE /tags/{id}
TagsApi	getAllTags	GET /tags
TagsApi	getTagById	GET /tags/{id}
TagsApi	tagAssets	PUT /tags/{id}/assets
TagsApi	untagAssets	DELETE /tags/{id}/assets
TagsApi	updateTag	PUT /tags/{id}
TagsApi	upsertTags	PUT /tags
TimelineApi	getTimeBucket	GET /timeline/bucket
TimelineApi	getTimeBuckets	GET /timeline/buckets
TrashApi	emptyTrash	POST /trash/empty
TrashApi	restoreAssets	POST /trash/restore/assets
TrashApi	restoreTrash	POST /trash/restore
UsersApi	createProfileImage	POST /users/profile-image
UsersApi	deleteProfileImage	DELETE /users/profile-image
UsersApi	deleteUserLicense	DELETE /users/me/license
UsersApi	deleteUserOnboarding	DELETE /users/me/onboarding
UsersApi	getMyPreferences	GET /users/me/preferences
UsersApi	getMyUser	GET /users/me
UsersApi	getProfileImage	GET /users/{id}/profile-image
UsersApi	getUser	GET /users/{id}
UsersApi	getUserLicense	GET /users/me/license
UsersApi	getUserOnboarding	GET /users/me/onboarding
UsersApi	searchUsers	GET /users
UsersApi	setUserLicense	PUT /users/me/license
UsersApi	setUserOnboarding	PUT /users/me/onboarding
UsersApi	updateMyPreferences	PUT /users/me/preferences
UsersApi	updateMyUser	PUT /users/me
UsersAdminApi	createUserAdmin	POST /admin/users
UsersAdminApi	deleteUserAdmin	DELETE /admin/users/{id}
UsersAdminApi	getUserAdmin	GET /admin/users/{id}
UsersAdminApi	getUserPreferencesAdmin	GET /admin/users/{id}/preferences
UsersAdminApi	getUserStatisticsAdmin	GET /admin/users/{id}/statistics
UsersAdminApi	restoreUserAdmin	POST /admin/users/{id}/restore
UsersAdminApi	searchUsersAdmin	GET /admin/users
UsersAdminApi	updateUserAdmin	PUT /admin/users/{id}
UsersAdminApi	updateUserPreferencesAdmin	PUT /admin/users/{id}/preferences
ViewApi	getAssetsByOriginalPath	GET /view/folder
ViewApi	getUniqueOriginalPaths	GET /view/folder/unique-paths

Documentation For Models

• APIKeyCreateDto
• APIKeyCreateResponseDto
• APIKeyResponseDto
• APIKeyUpdateDto
• ActivityCreateDto
• ActivityResponseDto
• ActivityStatisticsResponseDto
• AddUsersDto
• AdminOnboardingUpdateDto
• AlbumResponseDto
• AlbumStatisticsResponseDto
• AlbumUserAddDto
• AlbumUserCreateDto
• AlbumUserResponseDto
• AlbumUserRole
• AlbumsAddAssetsDto
• AlbumsAddAssetsResponseDto
• AlbumsResponse
• AlbumsUpdate
• AllJobStatusResponseDto
• AssetBulkDeleteDto
• AssetBulkUpdateDto
• AssetBulkUploadCheckDto
• AssetBulkUploadCheckItem
• AssetBulkUploadCheckResponseDto
• AssetBulkUploadCheckResult
• AssetDeltaSyncDto
• AssetDeltaSyncResponseDto
• AssetFaceCreateDto
• AssetFaceDeleteDto
• AssetFaceResponseDto
• AssetFaceUpdateDto
• AssetFaceUpdateItem
• AssetFaceWithoutPersonResponseDto
• AssetFullSyncDto
• AssetIdsDto
• AssetIdsResponseDto
• AssetJobName
• AssetJobsDto
• AssetMediaResponseDto
• AssetMediaSize
• AssetMediaStatus
• AssetOrder
• AssetResponseDto
• AssetStackResponseDto
• AssetStatsResponseDto
• AssetTypeEnum
• AssetVisibility
• AudioCodec
• AuthStatusResponseDto
• AvatarUpdate
• BulkIdErrorReason
• BulkIdResponseDto
• BulkIdsDto
• CLIPConfig
• CQMode
• CastResponse
• CastUpdate
• ChangePasswordDto
• CheckExistingAssetsDto
• CheckExistingAssetsResponseDto
• Colorspace
• CreateAlbumDto
• CreateLibraryDto
• CreateProfileImageResponseDto
• DatabaseBackupConfig
• DownloadArchiveInfo
• DownloadInfoDto
• DownloadResponse
• DownloadResponseDto
• DownloadUpdate
• DuplicateDetectionConfig
• DuplicateResponseDto
• EmailNotificationsResponse
• EmailNotificationsUpdate
• ExifResponseDto
• FaceDto
• FacialRecognitionConfig
• FoldersResponse
• FoldersUpdate
• ImageFormat
• JobCommand
• JobCommandDto
• JobCountsDto
• JobCreateDto
• JobName
• JobSettingsDto
• JobStatusDto
• LibraryResponseDto
• LibraryStatsResponseDto
• LicenseKeyDto
• LicenseResponseDto
• LogLevel
• LoginCredentialDto
• LoginResponseDto
• LogoutResponseDto
• ManualJobName
• MapMarkerResponseDto
• MapReverseGeocodeResponseDto
• MemoriesResponse
• MemoriesUpdate
• MemoryCreateDto
• MemoryResponseDto
• MemoryStatisticsResponseDto
• MemoryType
• MemoryUpdateDto
• MergePersonDto
• MetadataSearchDto
• NotificationCreateDto
• NotificationDeleteAllDto
• NotificationDto
• NotificationLevel
• NotificationType
• NotificationUpdateAllDto
• NotificationUpdateDto
• OAuthAuthorizeResponseDto
• OAuthCallbackDto
• OAuthConfigDto
• OAuthTokenEndpointAuthMethod
• OnThisDayDto
• OnboardingDto
• OnboardingResponseDto
• PartnerDirection
• PartnerResponseDto
• PeopleResponse
• PeopleResponseDto
• PeopleUpdate
• PeopleUpdateDto
• PeopleUpdateItem
• Permission
• PersonCreateDto
• PersonResponseDto
• PersonStatisticsResponseDto
• PersonUpdateDto
• PersonWithFacesResponseDto
• PinCodeChangeDto
• PinCodeResetDto
• PinCodeSetupDto
• PlacesResponseDto
• PurchaseResponse
• PurchaseUpdate
• QueueStatusDto
• RandomSearchDto
• RatingsResponse
• RatingsUpdate
• ReactionLevel
• ReactionType
• ReverseGeocodingStateResponseDto
• SearchAlbumResponseDto
• SearchAssetResponseDto
• SearchExploreItem
• SearchExploreResponseDto
• SearchFacetCountResponseDto
• SearchFacetResponseDto
• SearchResponseDto
• SearchStatisticsResponseDto
• SearchSuggestionType
• ServerAboutResponseDto
• ServerApkLinksDto
• ServerConfigDto
• ServerFeaturesDto
• ServerMediaTypesResponseDto
• ServerPingResponse
• ServerStatsResponseDto
• ServerStorageResponseDto
• ServerThemeDto
• ServerVersionHistoryResponseDto
• ServerVersionResponseDto
• SessionCreateDto
• SessionCreateResponseDto
• SessionResponseDto
• SessionUnlockDto
• SessionUpdateDto
• SharedLinkCreateDto
• SharedLinkEditDto
• SharedLinkResponseDto
• SharedLinkType
• SharedLinksResponse
• SharedLinksUpdate
• SignUpDto
• SmartSearchDto
• SourceType
• StackCreateDto
• StackResponseDto
• StackUpdateDto
• StatisticsSearchDto
• SyncAckDeleteDto
• SyncAckDto
• SyncAckSetDto
• SyncAlbumDeleteV1
• SyncAlbumToAssetDeleteV1
• SyncAlbumToAssetV1
• SyncAlbumUserDeleteV1
• SyncAlbumUserV1
• SyncAlbumV1
• SyncAssetDeleteV1
• SyncAssetExifV1
• SyncAssetFaceDeleteV1
• SyncAssetFaceV1
• SyncAssetV1
• SyncAuthUserV1
• SyncEntityType
• SyncMemoryAssetDeleteV1
• SyncMemoryAssetV1
• SyncMemoryDeleteV1
• SyncMemoryV1
• SyncPartnerDeleteV1
• SyncPartnerV1
• SyncPersonDeleteV1
• SyncPersonV1
• SyncRequestType
• SyncStackDeleteV1
• SyncStackV1
• SyncStreamDto
• SyncUserDeleteV1
• SyncUserMetadataDeleteV1
• SyncUserMetadataV1
• SyncUserV1
• SystemConfigBackupsDto
• SystemConfigDto
• SystemConfigFFmpegDto
• SystemConfigFacesDto
• SystemConfigGeneratedFullsizeImageDto
• SystemConfigGeneratedImageDto
• SystemConfigImageDto
• SystemConfigJobDto
• SystemConfigLibraryDto
• SystemConfigLibraryScanDto
• SystemConfigLibraryWatchDto
• SystemConfigLoggingDto
• SystemConfigMachineLearningDto
• SystemConfigMapDto
• SystemConfigMetadataDto
• SystemConfigNewVersionCheckDto
• SystemConfigNightlyTasksDto
• SystemConfigNotificationsDto
• SystemConfigOAuthDto
• SystemConfigPasswordLoginDto
• SystemConfigReverseGeocodingDto
• SystemConfigServerDto
• SystemConfigSmtpDto
• SystemConfigSmtpTransportDto
• SystemConfigStorageTemplateDto
• SystemConfigTemplateEmailsDto
• SystemConfigTemplateStorageOptionDto
• SystemConfigTemplatesDto
• SystemConfigThemeDto
• SystemConfigTrashDto
• SystemConfigUserDto
• TagBulkAssetsDto
• TagBulkAssetsResponseDto
• TagCreateDto
• TagResponseDto
• TagUpdateDto
• TagUpsertDto
• TagsResponse
• TagsUpdate
• TemplateDto
• TemplateResponseDto
• TestEmailResponseDto
• TimeBucketAssetResponseDto
• TimeBucketsResponseDto
• ToneMapping
• TranscodeHWAccel
• TranscodePolicy
• TrashResponseDto
• UpdateAlbumDto
• UpdateAlbumUserDto
• UpdateAssetDto
• UpdateLibraryDto
• UpdatePartnerDto
• UsageByUserDto
• UserAdminCreateDto
• UserAdminDeleteDto
• UserAdminResponseDto
• UserAdminUpdateDto
• UserAvatarColor
• UserLicense
• UserMetadataKey
• UserPreferencesResponseDto
• UserPreferencesUpdateDto
• UserResponseDto
• UserStatus
• UserUpdateMeDto
• ValidateAccessTokenResponseDto
• ValidateLibraryDto
• ValidateLibraryImportPathResponseDto
• ValidateLibraryResponseDto
• VersionCheckStateResponseDto
• VideoCodec
• VideoContainer

Documentation For Authorization

Authentication schemes defined for the API:

bearer

• Type: HTTP Bearer authentication

cookie

• Type: API key
• API key parameter name: immich_access_token
• Location:

api_key

• Type: API key
• API key parameter name: x-api-key
• Location: HTTP header

Author