Cats

18 tools available

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

Connect Cats to Definable to generate on-brand assets, refresh creative in bulk, render storyboards from briefs. Personas call Cats's 18 tools directly from chat or scheduled flows. Hand it to a creative persona that knows your brand — the agent generates assets that ship.

Common workflows with Cats

On-brand variants

Brief in plain English
Persona applies brand rules
Generates approved variants

Bulk asset refresh

List all assets in a folder
Re-render with new style spec
Replace and version-tag

Storyboard pipeline

Persona drafts a sequence
This integration renders frames
Exports as a deck or video

Cats actions 18

Every Cats action below is a callable tool any Definable persona can invoke.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

List Image Categories

Retrieves a list of all active image categories from The Cat API. Categories include hats, sunglasses, boxes, sinks, and more. Use category IDs when searching or filtering images by category.

List Favourites

Tool to get all favourites belonging to your account. Use when you need to retrieve saved cat images, optionally filtered by sub_id. Supports pagination to browse through large collections of favourites.

List Uploaded Images

Tool to get all images uploaded to your account via /images/upload. Supports pagination and filtering by sub_id or original filename. Use this to retrieve your uploaded images, check if a file already exists, or filter by user identifiers. The API returns images in order of upload date.

List Votes

Tool to retrieve all votes you have created. Returns a paginated list of votes with image IDs, vote values, and metadata. Use this to view voting history, filter by user segment (sub_id), or analyze vote patterns.

Search Cat Breeds

Search for cat breeds by name. Use the 'q' parameter with part or all of the breed name to find matching breeds. Returns breed details including temperament, origin, and characteristics.

Search Cat Images

Search for random cat images with optional filters. Filter by breed availability, size, and file type. Returns an array of image objects with URLs and metadata. Use this to find cat images for display, testing, or content generation. The default behavior returns 1 random cat image.

Frequently asked questions

What can I automate with Cats on Definable?

Anything Cats exposes through its API. Common images & design workflows on Definable include generate on-brand assets, refresh creative in bulk, render storyboards from briefs. Personas can call any of the 18 Cats tools directly, then chain the result into another integration without you writing code.

How does Cats authentication work?

Cats uses API_KEY on Definable. You connect once from the integrations page, scoped to the permissions you choose, and from then on any persona that has the integration enabled can act on your behalf. Tokens are encrypted at rest and rotated automatically.

Is the Cats integration included in my Definable plan?

Yes — every Definable plan, including Starter, includes access to all 18 Cats tools. You only need a separate Cats subscription if Cats itself charges per seat or per API call.

Is using Cats through Definable secure?

Every call from a persona to Cats is logged with the user, persona, prompt, and response. Tokens never leave Definable's secrets vault, scopes are configurable per persona, and you can revoke access at any time from the integration page.

How do I get started with Cats on Definable?

Sign up for Definable, open the integrations page, find Cats, and connect via OAuth or API key. You can immediately attach Cats to any persona and start running workflows. The free Starter plan includes 5,000 credits/month.

What Cats actions does Definable expose?

Definable exposes all 18 Cats actions as callable tools — including `Create Favourite`, `Create Vote`, `Delete Favourite`, plus 15 more. Each tool gets a typed parameter schema so personas know exactly how to call it.

Ready to automate with Cats?

Wire it up in minutes. No coding required.

Start for free Schedule a demo

← All integrations