Verify credentials by calling flickr.test.login. Returns the logged-in user's id and username, or a clear error if auth is not set up.

List the authenticated user's albums (photosets): id, title, photo count, and primary photo id. Use list_album_photos to drill into one.

List photos in an album. Each photo includes id, title, and a ready-to-use 1024px static URL for embedding.

Search photos. By default restricted to the authenticated user's own photos (mine_only). Provide text and/or comma-separated tags.

Full metadata for one photo: title, description, tags, dates, visibility, and the Flickr page URL.

Authoritative list of available sizes for a photo, each with its direct source URL and pixel dimensions. This is the reliable source for embed URLs.

Upload a local image file to Flickr. Defaults to PRIVATE so nothing goes public by accident. Returns the new photo id.

Create a new album (photoset). Flickr requires an existing photo id to be the album cover (primary_photo_id). Returns the new album id.

Add an existing photo to an existing album.

Update a photo's title and/or description. Flickr's setMeta requires the title, so an existing title is fetched when only description is supplied.

Permanently delete a photo from Flickr. IRREVERSIBLE. Needs the token to carry 'delete' permission — re-run authorize.py if you only granted 'write'.

Delete an album (photoset). Removes only the album — the photos it held are NOT deleted, they stay in your photostream. Needs 'delete' permission.