immich/mobile/openapi/README.md

openapi

Immich API

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

• API version: 1.57.1
• 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 = APIKeyApi();
final aPIKeyCreateDto = APIKeyCreateDto(); // APIKeyCreateDto | 

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

Documentation for API Endpoints

All URIs are relative to /api

Class	Method	HTTP request	Description
APIKeyApi	createKey	POST /api-key
APIKeyApi	deleteKey	DELETE /api-key/{id}
APIKeyApi	getKey	GET /api-key/{id}
APIKeyApi	getKeys	GET /api-key
APIKeyApi	updateKey	PUT /api-key/{id}
AlbumApi	addAssetsToAlbum	PUT /album/{id}/assets
AlbumApi	addUsersToAlbum	PUT /album/{id}/users
AlbumApi	createAlbum	POST /album
AlbumApi	createAlbumSharedLink	POST /album/create-shared-link
AlbumApi	deleteAlbum	DELETE /album/{id}
AlbumApi	downloadArchive	GET /album/{id}/download
AlbumApi	getAlbumCountByUserId	GET /album/count-by-user-id
AlbumApi	getAlbumInfo	GET /album/{id}
AlbumApi	getAllAlbums	GET /album
AlbumApi	removeAssetFromAlbum	DELETE /album/{id}/assets
AlbumApi	removeUserFromAlbum	DELETE /album/{id}/user/{userId}
AlbumApi	updateAlbumInfo	PATCH /album/{id}
AssetApi	addAssetsToSharedLink	PATCH /asset/shared-link/add
AssetApi	bulkUploadCheck	POST /asset/bulk-upload-check
AssetApi	checkDuplicateAsset	POST /asset/check
AssetApi	checkExistingAssets	POST /asset/exist
AssetApi	createAssetsSharedLink	POST /asset/shared-link
AssetApi	deleteAsset	DELETE /asset
AssetApi	downloadFile	GET /asset/download/{assetId}
AssetApi	downloadFiles	POST /asset/download-files
AssetApi	downloadLibrary	GET /asset/download-library
AssetApi	getAllAssets	GET /asset
AssetApi	getArchivedAssetCountByUserId	GET /asset/stat/archive
AssetApi	getAssetById	GET /asset/assetById/{assetId}
AssetApi	getAssetByTimeBucket	POST /asset/time-bucket
AssetApi	getAssetCountByTimeBucket	POST /asset/count-by-time-bucket
AssetApi	getAssetCountByUserId	GET /asset/count-by-user-id
AssetApi	getAssetSearchTerms	GET /asset/search-terms
AssetApi	getAssetThumbnail	GET /asset/thumbnail/{assetId}
AssetApi	getCuratedLocations	GET /asset/curated-locations
AssetApi	getCuratedObjects	GET /asset/curated-objects
AssetApi	getMapMarkers	GET /asset/map-marker
AssetApi	getUserAssetsByDeviceId	GET /asset/{deviceId}
AssetApi	removeAssetsFromSharedLink	PATCH /asset/shared-link/remove
AssetApi	searchAsset	POST /asset/search
AssetApi	serveFile	GET /asset/file/{assetId}
AssetApi	updateAsset	PUT /asset/{assetId}
AssetApi	uploadFile	POST /asset/upload
AuthenticationApi	adminSignUp	POST /auth/admin-sign-up
AuthenticationApi	changePassword	POST /auth/change-password
AuthenticationApi	getAuthDevices	GET /auth/devices
AuthenticationApi	login	POST /auth/login
AuthenticationApi	logout	POST /auth/logout
AuthenticationApi	logoutAuthDevice	DELETE /auth/devices/{id}
AuthenticationApi	logoutAuthDevices	DELETE /auth/devices
AuthenticationApi	validateAccessToken	POST /auth/validateToken
JobApi	getAllJobsStatus	GET /jobs
JobApi	sendJobCommand	PUT /jobs/{jobId}
OAuthApi	callback	POST /oauth/callback
OAuthApi	generateConfig	POST /oauth/config
OAuthApi	link	POST /oauth/link
OAuthApi	mobileRedirect	GET /oauth/mobile-redirect
OAuthApi	unlink	POST /oauth/unlink
PartnerApi	createPartner	POST /partner/{id}
PartnerApi	getPartners	GET /partner
PartnerApi	removePartner	DELETE /partner/{id}
PersonApi	getAllPeople	GET /person
PersonApi	getPerson	GET /person/{id}
PersonApi	getPersonAssets	GET /person/{id}/assets
PersonApi	getPersonThumbnail	GET /person/{id}/thumbnail
PersonApi	updatePerson	PUT /person/{id}
SearchApi	getExploreData	GET /search/explore
SearchApi	getSearchConfig	GET /search/config
SearchApi	search	GET /search
ServerInfoApi	getServerInfo	GET /server-info
ServerInfoApi	getServerVersion	GET /server-info/version
ServerInfoApi	getStats	GET /server-info/stats
ServerInfoApi	pingServer	GET /server-info/ping
ShareApi	editSharedLink	PATCH /share/{id}
ShareApi	getAllSharedLinks	GET /share
ShareApi	getMySharedLink	GET /share/me
ShareApi	getSharedLinkById	GET /share/{id}
ShareApi	removeSharedLink	DELETE /share/{id}
SystemConfigApi	getConfig	GET /system-config
SystemConfigApi	getDefaults	GET /system-config/defaults
SystemConfigApi	getStorageTemplateOptions	GET /system-config/storage-template-options
SystemConfigApi	updateConfig	PUT /system-config
TagApi	create	POST /tag
TagApi	delete	DELETE /tag/{id}
TagApi	findAll	GET /tag
TagApi	findOne	GET /tag/{id}
TagApi	update	PATCH /tag/{id}
UserApi	createProfileImage	POST /user/profile-image
UserApi	createUser	POST /user
UserApi	deleteUser	DELETE /user/{userId}
UserApi	getAllUsers	GET /user
UserApi	getMyUserInfo	GET /user/me
UserApi	getProfileImage	GET /user/profile-image/{userId}
UserApi	getUserById	GET /user/info/{userId}
UserApi	getUserCount	GET /user/count
UserApi	restoreUser	POST /user/{userId}/restore
UserApi	updateUser	PUT /user

Documentation For Models

• APIKeyCreateDto
• APIKeyCreateResponseDto
• APIKeyResponseDto
• APIKeyUpdateDto
• AddAssetsDto
• AddAssetsResponseDto
• AddUsersDto
• AdminSignupResponseDto
• AlbumCountResponseDto
• AlbumResponseDto
• AllJobStatusResponseDto
• AssetBulkUploadCheckDto
• AssetBulkUploadCheckItem
• AssetBulkUploadCheckResponseDto
• AssetBulkUploadCheckResult
• AssetCountByTimeBucket
• AssetCountByTimeBucketResponseDto
• AssetCountByUserIdResponseDto
• AssetFileUploadResponseDto
• AssetResponseDto
• AssetTypeEnum
• AuthDeviceResponseDto
• ChangePasswordDto
• CheckDuplicateAssetDto
• CheckDuplicateAssetResponseDto
• CheckExistingAssetsDto
• CheckExistingAssetsResponseDto
• CreateAlbumDto
• CreateAlbumShareLinkDto
• CreateAssetsShareLinkDto
• CreateProfileImageResponseDto
• CreateTagDto
• CreateUserDto
• CuratedLocationsResponseDto
• CuratedObjectsResponseDto
• DeleteAssetDto
• DeleteAssetResponseDto
• DeleteAssetStatus
• DownloadFilesDto
• EditSharedLinkDto
• ExifResponseDto
• GetAssetByTimeBucketDto
• GetAssetCountByTimeBucketDto
• JobCommand
• JobCommandDto
• JobCountsDto
• JobName
• JobStatusDto
• LoginCredentialDto
• LoginResponseDto
• LogoutResponseDto
• MapMarkerResponseDto
• OAuthCallbackDto
• OAuthConfigDto
• OAuthConfigResponseDto
• PersonResponseDto
• PersonUpdateDto
• QueueStatusDto
• RemoveAssetsDto
• SearchAlbumResponseDto
• SearchAssetDto
• SearchAssetResponseDto
• SearchConfigResponseDto
• SearchExploreItem
• SearchExploreResponseDto
• SearchFacetCountResponseDto
• SearchFacetResponseDto
• SearchResponseDto
• ServerInfoResponseDto
• ServerPingResponse
• ServerStatsResponseDto
• ServerVersionReponseDto
• SharedLinkResponseDto
• SharedLinkType
• SignUpDto
• SmartInfoResponseDto
• SystemConfigDto
• SystemConfigFFmpegDto
• SystemConfigOAuthDto
• SystemConfigPasswordLoginDto
• SystemConfigStorageTemplateDto
• SystemConfigTemplateStorageOptionDto
• TagResponseDto
• TagTypeEnum
• ThumbnailFormat
• TimeGroupEnum
• UpdateAlbumDto
• UpdateAssetDto
• UpdateTagDto
• UpdateUserDto
• UsageByUserDto
• UserCountResponseDto
• UserResponseDto
• ValidateAccessTokenResponseDto

Documentation For Authorization

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