Skip to content
ajan.io

Docs menu

On this page

Get Integration Icon

Retrieve the icon URL for an integration

Returns the icon URL for an integration. If the integration has no icon, iconUrl is null.

Base URL

https://api.ajan.io/integrations/v1/{integrationId}/icon

Required Scopes

This endpoint requires the INTEGRATION_API scope.

Parameters

ParameterTypeRequiredDescription
integrationIdstringYesUUID of the integration

Example

javascript
const axios = require("axios");

async function getIcon(integrationId) {
  const response = await axios.get(
    `https://api.ajan.io/integrations/v1/${integrationId}/icon`,
    {
      headers: {
        Authorization: "Bearer YOUR_API_KEY"
      }
    }
  );

  console.log("Icon URL:", response.data.iconUrl);
}

getIcon("550e8400-e29b-41d4-a716-446655440000");

Response Format

Success Response (200 OK)

typescript
{
  iconUrl: string | null;
}

Error Handling

Status CodeDescription
400Invalid integration ID format
401Invalid or missing API key
403No access to this integration
404Integration not found
429Rate limit exceeded