mirror of
https://github.com/immich-app/immich.git
synced 2025-10-23 23:12:06 -04:00
openapi
Immich API
This Dart package is automatically generated by the OpenAPI Generator project:
- API version: 1.110.0
- Generator version: 7.5.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 | 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 | addUsersToAlbum | PUT /albums/{id}/users | |
| AlbumsApi | createAlbum | POST /albums | |
| AlbumsApi | deleteAlbum | DELETE /albums/{id} | |
| AlbumsApi | getAlbumCount | GET /albums/count | |
| AlbumsApi | getAlbumInfo | GET /albums/{id} | |
| 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 | |
| AssetsApi | checkExistingAssets | POST /assets/exist | |
| AssetsApi | deleteAssets | DELETE /assets | |
| AssetsApi | downloadAsset | GET /assets/{id}/original | |
| AssetsApi | getAllUserAssetsByDeviceId | GET /assets/device/{deviceId} | |
| AssetsApi | getAssetInfo | GET /assets/{id} | |
| AssetsApi | getAssetStatistics | GET /assets/statistics | |
| AssetsApi | getMemoryLane | GET /assets/memory-lane | |
| AssetsApi | getRandom | GET /assets/random | |
| AssetsApi | playAssetVideo | GET /assets/{id}/video/playback | |
| AssetsApi | replaceAsset | PUT /assets/{id}/original | |
| AssetsApi | runAssetJobs | POST /assets/jobs | |
| AssetsApi | updateAsset | PUT /assets/{id} | |
| AssetsApi | updateAssets | PUT /assets | |
| AssetsApi | updateStackParent | PUT /assets/stack/parent | |
| AssetsApi | uploadAsset | POST /assets | |
| AssetsApi | viewAsset | GET /assets/{id}/thumbnail | |
| AuditApi | getAuditDeletes | GET /audit/deletes | |
| AuthenticationApi | changePassword | POST /auth/change-password | |
| AuthenticationApi | login | POST /auth/login | |
| AuthenticationApi | logout | POST /auth/logout | |
| AuthenticationApi | signUpAdmin | POST /auth/admin-sign-up | |
| AuthenticationApi | validateAccessToken | POST /auth/validateToken | |
| DeprecatedApi | getAboutInfo | GET /server-info/about | |
| DeprecatedApi | getServerConfig | GET /server-info/config | |
| DeprecatedApi | getServerFeatures | GET /server-info/features | |
| DeprecatedApi | getServerStatistics | GET /server-info/statistics | |
| DeprecatedApi | getServerVersion | GET /server-info/version | |
| DeprecatedApi | getStorage | GET /server-info/storage | |
| DeprecatedApi | getSupportedMediaTypes | GET /server-info/media-types | |
| DeprecatedApi | getTheme | GET /server-info/theme | |
| DeprecatedApi | pingServer | GET /server-info/ping | |
| DownloadApi | downloadArchive | POST /download/archive | |
| DownloadApi | getDownloadInfo | POST /download/info | |
| DuplicatesApi | getAssetDuplicates | GET /duplicates | |
| FacesApi | getFaces | GET /faces | |
| FacesApi | reassignFacesById | PUT /faces/{id} | |
| FileReportsApi | fixAuditFiles | POST /reports/fix | |
| FileReportsApi | getAuditFiles | GET /reports | |
| FileReportsApi | getFileChecksums | POST /reports/checksum | |
| 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 | removeOfflineFiles | POST /libraries/{id}/removeOffline | |
| LibrariesApi | scanLibrary | POST /libraries/{id}/scan | |
| LibrariesApi | updateLibrary | PUT /libraries/{id} | |
| LibrariesApi | validate | POST /libraries/{id}/validate | |
| MapApi | getMapMarkers | GET /map/markers | |
| MapApi | getMapStyle | GET /map/style.json | |
| MemoriesApi | addMemoryAssets | PUT /memories/{id}/assets | |
| MemoriesApi | createMemory | POST /memories | |
| MemoriesApi | deleteMemory | DELETE /memories/{id} | |
| MemoriesApi | getMemory | GET /memories/{id} | |
| MemoriesApi | removeMemoryAssets | DELETE /memories/{id}/assets | |
| MemoriesApi | searchMemories | GET /memories | |
| MemoriesApi | updateMemory | PUT /memories/{id} | |
| NotificationsApi | sendTestEmail | POST /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 | getAllPeople | GET /people | |
| PeopleApi | getPerson | GET /people/{id} | |
| PeopleApi | getPersonAssets | GET /people/{id}/assets | |
| 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 | searchMetadata | POST /search/metadata | |
| SearchApi | searchPerson | GET /search/person | |
| SearchApi | searchPlaces | GET /search/places | |
| SearchApi | searchSmart | POST /search/smart | |
| ServerApi | deleteServerLicense | DELETE /server/license | |
| ServerApi | getServerLicense | GET /server/license | |
| ServerApi | setServerLicense | PUT /server/license | |
| ServerInfoApi | getAboutInfo | GET /server-info/about | |
| ServerInfoApi | getServerConfig | GET /server-info/config | |
| ServerInfoApi | getServerFeatures | GET /server-info/features | |
| ServerInfoApi | getServerStatistics | GET /server-info/statistics | |
| ServerInfoApi | getServerVersion | GET /server-info/version | |
| ServerInfoApi | getStorage | GET /server-info/storage | |
| ServerInfoApi | getSupportedMediaTypes | GET /server-info/media-types | |
| ServerInfoApi | getTheme | GET /server-info/theme | |
| ServerInfoApi | pingServer | GET /server-info/ping | |
| SessionsApi | deleteAllSessions | DELETE /sessions | |
| SessionsApi | deleteSession | DELETE /sessions/{id} | |
| SessionsApi | getSessions | GET /sessions | |
| 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} | |
| SyncApi | getDeltaSync | POST /sync/delta-sync | |
| SyncApi | getFullSyncForUser | POST /sync/full-sync | |
| 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 | updateAdminOnboarding | POST /system-metadata/admin-onboarding | |
| TagsApi | createTag | POST /tags | |
| TagsApi | deleteTag | DELETE /tags/{id} | |
| TagsApi | getAllTags | GET /tags | |
| TagsApi | getTagAssets | GET /tags/{id}/assets | |
| TagsApi | getTagById | GET /tags/{id} | |
| TagsApi | tagAssets | PUT /tags/{id}/assets | |
| TagsApi | untagAssets | DELETE /tags/{id}/assets | |
| TagsApi | updateTag | PATCH /tags/{id} | |
| 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 | 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 | searchUsers | GET /users | |
| UsersApi | setUserLicense | PUT /users/me/license | |
| 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 | restoreUserAdmin | POST /admin/users/{id}/restore | |
| UsersAdminApi | searchUsersAdmin | GET /admin/users | |
| UsersAdminApi | updateUserAdmin | PUT /admin/users/{id} | |
| UsersAdminApi | updateUserPreferencesAdmin | PUT /admin/users/{id}/preferences |
Documentation For Models
- APIKeyCreateDto
- APIKeyCreateResponseDto
- APIKeyResponseDto
- APIKeyUpdateDto
- ActivityCreateDto
- ActivityResponseDto
- ActivityStatisticsResponseDto
- AddUsersDto
- AdminOnboardingUpdateDto
- AlbumCountResponseDto
- AlbumResponseDto
- AlbumUserAddDto
- AlbumUserCreateDto
- AlbumUserResponseDto
- AlbumUserRole
- AllJobStatusResponseDto
- AssetBulkDeleteDto
- AssetBulkUpdateDto
- AssetBulkUploadCheckDto
- AssetBulkUploadCheckItem
- AssetBulkUploadCheckResponseDto
- AssetBulkUploadCheckResult
- AssetDeltaSyncDto
- AssetDeltaSyncResponseDto
- AssetFaceResponseDto
- AssetFaceUpdateDto
- AssetFaceUpdateItem
- AssetFaceWithoutPersonResponseDto
- AssetFullSyncDto
- AssetIdsDto
- AssetIdsResponseDto
- AssetJobName
- AssetJobsDto
- AssetMediaResponseDto
- AssetMediaSize
- AssetMediaStatus
- AssetOrder
- AssetResponseDto
- AssetStatsResponseDto
- AssetTypeEnum
- AudioCodec
- AuditDeletesResponseDto
- AvatarResponse
- AvatarUpdate
- BulkIdResponseDto
- BulkIdsDto
- CLIPConfig
- CQMode
- ChangePasswordDto
- CheckExistingAssetsDto
- CheckExistingAssetsResponseDto
- Colorspace
- CreateAlbumDto
- CreateLibraryDto
- CreateProfileImageResponseDto
- CreateTagDto
- DownloadArchiveInfo
- DownloadInfoDto
- DownloadResponse
- DownloadResponseDto
- DownloadUpdate
- DuplicateDetectionConfig
- DuplicateResponseDto
- EmailNotificationsResponse
- EmailNotificationsUpdate
- EntityType
- ExifResponseDto
- FaceDto
- FacialRecognitionConfig
- FileChecksumDto
- FileChecksumResponseDto
- FileReportDto
- FileReportFixDto
- FileReportItemDto
- ImageFormat
- JobCommand
- JobCommandDto
- JobCountsDto
- JobName
- JobSettingsDto
- JobStatusDto
- LibraryResponseDto
- LibraryStatsResponseDto
- LicenseKeyDto
- LicenseResponseDto
- LogLevel
- LoginCredentialDto
- LoginResponseDto
- LogoutResponseDto
- MapMarkerResponseDto
- MapTheme
- MemoryCreateDto
- MemoryLaneResponseDto
- MemoryResponse
- MemoryResponseDto
- MemoryType
- MemoryUpdate
- MemoryUpdateDto
- MergePersonDto
- MetadataSearchDto
- OAuthAuthorizeResponseDto
- OAuthCallbackDto
- OAuthConfigDto
- OnThisDayDto
- PartnerDirection
- PartnerResponseDto
- PathEntityType
- PathType
- PeopleResponseDto
- PeopleUpdateDto
- PeopleUpdateItem
- PersonCreateDto
- PersonResponseDto
- PersonStatisticsResponseDto
- PersonUpdateDto
- PersonWithFacesResponseDto
- PlacesResponseDto
- PurchaseResponse
- PurchaseUpdate
- QueueStatusDto
- ReactionLevel
- ReactionType
- ReverseGeocodingStateResponseDto
- ScanLibraryDto
- SearchAlbumResponseDto
- SearchAssetResponseDto
- SearchExploreItem
- SearchExploreResponseDto
- SearchFacetCountResponseDto
- SearchFacetResponseDto
- SearchResponseDto
- SearchSuggestionType
- ServerAboutResponseDto
- ServerConfigDto
- ServerFeaturesDto
- ServerMediaTypesResponseDto
- ServerPingResponse
- ServerStatsResponseDto
- ServerStorageResponseDto
- ServerThemeDto
- ServerVersionResponseDto
- SessionResponseDto
- SharedLinkCreateDto
- SharedLinkEditDto
- SharedLinkResponseDto
- SharedLinkType
- SignUpDto
- SmartInfoResponseDto
- SmartSearchDto
- SystemConfigDto
- SystemConfigFFmpegDto
- SystemConfigImageDto
- SystemConfigJobDto
- SystemConfigLibraryDto
- SystemConfigLibraryScanDto
- SystemConfigLibraryWatchDto
- SystemConfigLoggingDto
- SystemConfigMachineLearningDto
- SystemConfigMapDto
- SystemConfigNewVersionCheckDto
- SystemConfigNotificationsDto
- SystemConfigOAuthDto
- SystemConfigPasswordLoginDto
- SystemConfigReverseGeocodingDto
- SystemConfigServerDto
- SystemConfigSmtpDto
- SystemConfigSmtpTransportDto
- SystemConfigStorageTemplateDto
- SystemConfigTemplateStorageOptionDto
- SystemConfigThemeDto
- SystemConfigTrashDto
- SystemConfigUserDto
- TagResponseDto
- TagTypeEnum
- TimeBucketResponseDto
- TimeBucketSize
- ToneMapping
- TranscodeHWAccel
- TranscodePolicy
- UpdateAlbumDto
- UpdateAlbumUserDto
- UpdateAssetDto
- UpdateLibraryDto
- UpdatePartnerDto
- UpdateStackParentDto
- UpdateTagDto
- UsageByUserDto
- UserAdminCreateDto
- UserAdminDeleteDto
- UserAdminResponseDto
- UserAdminUpdateDto
- UserAvatarColor
- UserLicense
- UserPreferencesResponseDto
- UserPreferencesUpdateDto
- UserResponseDto
- UserStatus
- UserUpdateMeDto
- ValidateAccessTokenResponseDto
- ValidateLibraryDto
- ValidateLibraryImportPathResponseDto
- ValidateLibraryResponseDto
- 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