canonical: https://jentic.com/apis/logoraisr.com/logoraisr-api

# Logoraisr API docs | logoraisr.com

Jentic publishes the only available OpenAPI specification for API docs | logoraisr.com, keeping it validated and agent-ready. Logoraisr is an image-processing service that takes uploaded logos and brand assets and runs them through configurable processes such as cleanup, vectorisation, and analysis. The API exposes ten operations covering image upload, process catalogue listing, project and report creation, and retrieval of preview and result files.

## For AI agents

Upload logo images, run processing operations such as vectorisation or cleanup, and download the resulting files via the logoraisr API.

## Scope

Does not handle logo hosting, CDN delivery, or template-based marketing image generation - use for running processes on uploaded logos and retrieving the result files only.

## Capabilities

- Upload an image for processing via POST /uploads
- List the available processing processes through GET /processes
- Create a project that runs one of those processes on an uploaded image
- Poll project status and retrieve outputs with GET /projects/{project_number}
- Generate analysis reports for an uploaded image via POST /reports
- Download processed result files by id through /results/{result_file_id}

## Use cases

### Logo Vectorisation

Convert raster logos to clean vectors by uploading the source via POST /uploads, creating a project on POST /projects with the vectorise process, and downloading the SVG result. The async project model lets large files process without keeping the HTTP connection open.

Example prompt: POST /uploads with the source PNG, then POST /projects referencing the upload id and the vectorise process.

### Brand Asset Cleanup Batch

Run noise removal and background cleanup across a batch of uploaded brand assets by creating one project per asset. Each project runs independently so a failure on one asset does not block the rest of the batch from completing.

Example prompt: For each asset, POST /uploads, then POST /projects with process='cleanup', then GET /projects/{project_number} until complete.

### Logo Quality Reporting

Audit logo quality by calling POST /reports with the upload id. Reports surface issues such as low resolution or wrong colour space and are retrieved via GET /reports/{report_number} for design-team review.

Example prompt: POST /reports with the upload id, then GET /reports/{report_number} to read the analysis.

### AI Agent Logo Pipeline via Jentic

An agent that handles design-team requests can chain the upload, project, and result endpoints to clean and return logos automatically. Jentic exposes them as MCP tools so the agent invokes the right operation by intent.

Example prompt: Through Jentic, search 'vectorise a logo', load logoraisr POST /uploads, then chain POST /projects and GET /projects/{project_number}.

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| POST | /uploads | Upload a new image |
| GET | /processes | List available processes |
| POST | /projects | Create a new project |
| GET | /projects/{project_number} | Get project details |
| POST | /reports | Create an analysis report |
| GET | /reports/{report_number} | Get report details |
| GET | /results/{result_file_id} | Download a processed file |
| GET | /previews/{file_id} | Get a preview of an uploaded file |

## Key resources

- **Uploads** — Upload images for processing
- **Processes** — List the catalogue of available processes
- **Projects** — Create and inspect processing projects
- **Reports** — Generate and retrieve analysis reports
- **Previews** — Get preview images of uploaded files
- **Results** — Download processed output files

## Why Jentic

- **Setup:** Wiring the logoraisr API by hand means setting up its API token, attaching it to each call against api.logoraisr.com, and chaining the multipart upload, process, and result-file requests yourself. Through Jentic you install once, import logoraisr from the API Directory, store the token once, and your agent calls it.
- **Permission scoping:** logoraisr creates projects through request bodies rather than an account id in the URL path, so scoping is by operation: limit the agent to the operations it needs, such as uploading a logo and retrieving its result files, and leave out report creation if the agent does not need it.
- **Credential handling:** Your logoraisr API token is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'vectorise a logo' or 'download a processed logo', and Jentic returns the matching logoraisr operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **remove.bg API** — Single-purpose background removal for images and logos
- **Cloudinary Upload API** — Image hosting, transformation, and CDN delivery
- **Bannerbear API** — Template-based image and video generation
- **Placid API** — Programmatic image generation from design templates

## FAQ

### Why is there no official OpenAPI spec for API docs | logoraisr.com?

Logoraisr does not publish a maintained OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call API docs | logoraisr.com via structured tooling. It is validated against the live API and kept up to date. Get started with Jentic One, the self-hosted execution layer.

### What authentication does the logoraisr API use?

Logoraisr uses a token-based API key (the `Token` security scheme) passed in the Authorization header. Through Jentic the token is held in the encrypted vault and never enters the agent's prompt.

### How do I run a vectorisation pipeline?

Upload the image via POST /uploads, then POST /projects with the upload id and the vectorise process. Poll GET /projects/{project_number} until the result file id appears, then download via /results/{result_file_id}.

### Can I list the available image-processing processes?

Yes. GET /processes returns the catalogue of available operations along with the identifiers you pass to POST /projects.

### How do I process a logo through Jentic?

Run `pip install jentic`, search Jentic for 'process a logo image', load the logoraisr POST /uploads operation, then chain POST /projects with the upload id and process selection.

### What are the rate limits for the logoraisr API?

Numeric rate limits are not declared in the spec. Treat upload and project endpoints as throttled and back off on HTTP 429 responses.

### Can I limit what my agent is allowed to do with the logoraisr API?

Yes. Because logoraisr creates projects through request bodies rather than an account id in the URL path, your self-hosted Jentic One instance scopes access by operation, and your own rules decide which endpoints and credentials the agent may use. You can allow only the operations the agent needs, such as POST /uploads to upload a logo and GET /results/{result_file_id} to retrieve its output, while withholding POST /reports if report creation is not required. The agent can call only the operations you permit, so it cannot invoke anything you have not granted.