Skip to content
Changelog

Report a bug

AltText.ai integration: operations for AI agents

AltText.ai connects to Type.com as an integration. This page lists the 17 operations documented for Claude and Codex in Type.com: 7 read, 6 write, 4 destructive.

About AltText.ai

AltText.ai is a service that automatically generates alt text for images, enhancing accessibility and SEO.

Categories: Design & Media

How to connect AltText.ai to Type.com

Access
Organization connection: one shared account for the workspace.

To add the connection, follow the steps in Space connections.

Documented operations

17 operations. Your connection's permissions determine which operations are available. API references describe the vendor surface; they do not expand your connection's credentials or access.

Account

  • Read

    Get account

    Get account settings. The response includes an apikey object describing the key that made the request: its kind, name, origin, and whether it canmanagekeys.

    GET /account

  • Destructive

    Update account

    Update settings of your account.

    PUT /account

API Keys

  • Read

    List API keys

    Lists the account's site keys, oldest first, with cursor pagination. Needs a full-access key. Tokens are included. The response is sent with Cache-Control: no-store.

    GET /api_keys

  • Read

    Get an API key

    Returns one key, including a revoked one. The token is in the response while the key is active, except to an assistant connection without write access, which gets only tokenhint and a 403 for reveal=true.

    GET /api_keys/{id}

  • Read

    Get a key's audit trail

    Lists what happened to the key, newest first: creation, edits, rotations, revocation and token reveals, each with who did it and the values that changed. A revoked key's history stays readable.

    GET /api_keys/{id}/history

  • Write

    Create an API key

    Creates a site key and returns its token. Keys made through the API always have origin api. A key's kind can't be set through the API: sending kind returns 422 invalidparams. Full-access keys are created in the dashboard only. An account can have up to 10,000 active site keys.

    POST /api_keys

  • Write

    Rename a key or change its limit

    Changes name and usagelimit. Fields you leave out are unchanged; usagelimit: null removes the limit. A revoked key can't be changed (409 keyrevoked). Changes are recorded in the audit trail.

    PATCH /api_keys/{id}

  • Write

    Rotate a key's token

    Issues a new token for the key. The old token stops working immediately. The key keeps its ID, name and limit.

    POST /api_keys/{id}/rotation

  • Destructive

    Revoke a key

    Revokes the key. Its token stops working immediately and is deleted; requests that use it get 403 apikeyrevoked. The key stays listable with status=revoked, along with its history. Revoking a revoked key succeeds and changes nothing.

    POST /api_keys/{id}/revocation

Images

  • Read

    Get images

    Get data about existing images. This request supports pagination using the 'page' and 'limit' parameters.

    GET /images

  • Read

    Get image by asset id

    Retrieve information about an existing image

    GET /images/{asset_id}

  • Read

    Search images

    Search for images in your library. This request supports pagination using the page and limit parameters.

    GET /images/search

  • Write

    Create image

    Add an image and generate alt text. There are two ways to add an image: - Adding an image by URL: - The URL to your image must be publicly accessible. - Include the url field in your image JSON data. DO NOT include the raw field.

    POST /images

  • Write

    Bulk create

    Upload and process a CSV of image URLs that need alt text. Valid rows will be processed, and invalid rows will be returned in the rowerrors response field.

    POST /images/bulk_create

  • Write

    Page scrape

    Crawl and scrape a web page or HTML document, generating alt text for all images on the page. Scraped images will be queued for asynchronous alt text generation in the background.

    POST /images/page_scrape

  • Destructive

    Update image by asset id

    Update an image with new data. Note: You cannot update the URL of an exist image.

    PUT /images/{asset_id}

  • Destructive

    Delete image by asset id

    Delete an image.

    DELETE /images/{asset_id}

See How connections work for access and permissions, or browse all integrations.