Imgur API

Name: Imgur API
Brand: Imgur API
Availability: InStock

★ Only Publicly Available OpenAPI DocumentMediaImage ProcessingapiKey, oauth224 EndpointsREST

For Agents

Upload, retrieve, edit, and delete images and albums on Imgur, including favourites, comments, and gallery interactions through OAuth or anonymous client ID.

Install Jentic One Beta

Connect the Imgur API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Imgur API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with Imgur API.

Upload an image anonymously with the client ID or as an authenticated user

Retrieve, update, or delete an image by its hash

Favourite and unfavourite an image on the authenticated user's account

Create, update, and delete albums and manage their image membership

GET STARTED

Start building with Imgur API

Explore with Jentic

View OpenAPI Document

Use Cases

Patterns agents use Imgur API for, with concrete tasks.

★ Anonymous Screenshot Sharing

Bug-report tools and chat apps often want a quick way to host a screenshot without asking the user to sign in. Posting an image to /image with the client ID returns a public URL that can be pasted into a ticket. The same flow can later delete the image with the returned deletehash if the user changes their mind.

POST /image with the screenshot bytes and the Authorization: Client-ID header, then surface the returned link to the user.

Community Album Management

Forum and community apps that bundle uploads into albums use the album endpoints to keep submissions tidy. POST /album creates the container, POST /album/{albumHash}/add adds new images, and POST /album/{albumHash}/remove_images prunes ones that fail moderation. The album hash becomes the canonical link for the submission.

POST /album with title and description, then POST /album/{albumHash}/add with the image hashes that belong to the submission.

User-Authenticated Image Library

Apps that let users sign in with Imgur and curate their own gallery use the OAuth 2.0 flow to call /image/{imageHash}/favorite and the album endpoints on the user's behalf. This lets the app render a true mirror of the user's Imgur account inside its own UI without re-implementing the gallery.

Complete the Imgur OAuth flow, then POST /image/{imageHash}/favorite when the user clicks the heart icon in the app.

Agent-Driven Image Hosting

An AI agent that produces an image (a chart, a generated visual, a screenshot of a page) often needs to host it before linking to it from a Slack or email message. Jentic surfaces the Imgur upload operation with the right auth scheme so the agent runs a single execute call and gets back a shareable URL.

Search Jentic for 'upload an image to Imgur', execute /image with the agent's image bytes, and embed the returned URL in the next message.

Key Endpoints

24 endpoints — jentic publishes the only available openapi specification for imgur api, keeping it validated and agent-ready.

METHOD

PATH

DESCRIPTION

POST

/image

Upload an image

GET

/image/{imageHash}

Retrieve an image by hash

DELETE

/image/{imageHash}

Delete an image

POST

/image/{imageHash}/favorite

Favourite or unfavourite an image

POST

/album

Create an album

GET

/album/{albumHash}

Retrieve an album

POST

/album/{albumHash}/add

Add images to an album

POST

/album/{albumHash}/remove_images

Remove images from an album

POST

/image

Upload an image

GET

/image/{imageHash}

Retrieve an image by hash

DELETE

/image/{imageHash}

Delete an image

POST

/image/{imageHash}/favorite

Favourite or unfavourite an image

POST

/album

Create an album

GET

Why Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

Both the Imgur client ID and OAuth tokens are stored encrypted in the Jentic vault. The agent receives scoped access at execute time, so OAuth refresh tokens never reach the model prompt or logs.

Intent-based discovery

Agents search by intent (e.g., 'upload an image to Imgur' or 'add image to album') and Jentic returns the matching operation among the 24 endpoints with its input schema and the correct auth scheme attached.

Time to first call

Direct Imgur integration: 1-2 days to wire OAuth, anonymous uploads, and album management. Through Jentic: under 30 minutes to chain the upload and album operations.

FAQs

Specific to using Imgur API through Jentic.

Why is there no official OpenAPI spec for Imgur API?

Imgur publishes API documentation but no canonical OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Imgur via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.

What authentication does the Imgur API use?

Imgur supports two schemes: a client ID passed as Authorization: Client-ID for anonymous uploads, and OAuth 2.0 for user-authenticated actions like favouriting or managing the user's account. Through Jentic both flows are vaulted - the client ID and the OAuth token never enter the agent context.

Can I upload an image anonymously?

Yes. POST /image with the Authorization: Client-ID header. The response returns the public link plus a deletehash that can later be used to remove the image without OAuth.

How do I add an image to an existing album?

POST /album/{albumHash}/add with the image hashes that should be added. Use POST /album/{albumHash}/remove_images to take them out again. Both calls require OAuth when the album belongs to a signed-in user.

How do I upload an image through Jentic?

Run pip install jentic, search for 'upload an image to Imgur', load the /image POST schema, and execute with the image bytes. Jentic supplies the client ID or OAuth token from the vault depending on which is configured.

What are the rate limits for the Imgur API?

Imgur enforces per-IP and per-application credit limits documented on their developer site. The OpenAPI spec does not encode these limits directly; back off on HTTP 429 responses and check the X-RateLimit headers on each response.

Imgur API

Connect the Imgur API to your agent

Capabilities

Start building with Imgur API

Use Cases

Key Endpoints

Why Jentic?

Related APIs

FAQs