# Cats AI integration on Definable

> An API providing access to a vast collection of cat images, breeds, and facts.

## What this connects

An API providing access to a vast collection of cat images, breeds, and facts.

Vendor: https://thecatapi.com/

## Tools available

**18** tools available. First 12:

- `CATS_CREATE_FAVOURITE` — Create Favourite — Tool to save an image as a favourite to your account. Use when you want to mark a cat image as a favourite for later retrieval or filtering by user ID.
- `CATS_CREATE_VOTE` — Create Vote — Tool to vote on a cat image. Send image_id and value (1 for upvote, 0 for downvote) to register your vote. Optionally include sub_id for user tracking.
- `CATS_DELETE_FAVOURITE` — Delete Favourite — Tool to delete a favourite from your account by its ID. Use when you need to remove a previously saved favourite image from your Cat API account.
- `CATS_DELETE_IMAGE` — Delete Image — Delete an uploaded image from your account by its ID. Use this when you need to remove an image you previously uploaded to The Cat API.
- `CATS_DELETE_VOTE` — Delete Vote — Tool to delete a vote from your account by its ID. Use when you need to remove a previously submitted vote for a cat image.
- `CATS_GET_BREED` — Get Cat Breed by ID — Tool to get detailed information about a specific cat breed by its ID. Use when you need comprehensive details about a particular breed including temperament, origin, characteristics, and URLs.
- `CATS_GET_FAVOURITE` — Get Favourite by ID — Tool to retrieve a specific favourite by its unique ID. Returns full favourite details including user ID, image ID, creation timestamp, and associated image data. Use when you need to fetch a particular favourite's information or verify favourite existence.
- `CATS_GET_IMAGE` — Get Cat Image by ID — Tool to retrieve a specific cat image by its unique ID. Returns full image details including URL, dimensions, and breed information if available. Use when you need to fetch a particular image's data or verify image existence.
- `CATS_GET_IMAGE_ANALYSIS` — Get Image Analysis — Get machine learning analysis results for an uploaded image. Returns labels with confidence scores, bounding boxes for detected objects, and content moderation results from ML vendors. Note: GIF images are not supported for analysis.
- `CATS_GET_IMAGE_BREEDS` — Get Image Breeds — Tool to retrieve breed information associated with a specific cat image. Use when you need to identify which breed(s) are shown in a particular image from The Cat API.
- `CATS_GET_PORTALS` — Get Cat Breeds — Retrieves a paginated list of cat breeds from The Cat API. Returns comprehensive breed information including name, description, temperament, origin, life span, and weight. Use this to browse available cat breeds or search for specific breed information.
- `CATS_GET_VOTE` — Get Vote by ID — Retrieves a specific vote by its unique ID from The Cat API. Returns detailed vote information including the image ID, vote value, timestamp, and optional metadata like sub_id and country code. Use this when you need to fetch details about a specific vote.

## Auth

Auth schemes: `API_KEY`.

## How agents use Cats

Inside a Definable workflow, Cats is one of the tools the **Distributor specialist** can call. Example coordination patterns:

- **Researcher → Cats** — the Researcher (GPT-5.5) pulls context from Cats (records, threads, documents), synthesises findings, and briefs the rest of the team.
- **Writer → Distributor → Cats** — the Writer (Claude Opus 4.7) drafts copy in brand voice, the Verifier passes it, then the Distributor writes the result into Cats (create record, post message, draft email).
- **Designer / Engineer → Distributor → Cats** — the Designer ships an asset or the Engineer ships a code change, the Distributor delivers it via Cats (attach file, open PR comment, post status).

The Verifier checks every Cats call. On rate limit, schema drift, or auth refresh it self-heals and retries — the workflow completes without manual intervention.

## Categories

- images & design — https://definable.ai/apps/category/images-&-design/

## Related

- HTML page: https://definable.ai/apps/cats/
- Same category (images & design): https://definable.ai/apps/category/images-&-design/
- All integrations: https://definable.ai/apps/
- Workflow (multi-agent loop): https://definable.ai/workflow/
- Apps llms.txt index: https://definable.ai/llms-apps.txt