List Integrations

Retrieve all integrations available in your workspace

Using our API via a dedicated deployment? Just replace api.odeus.ai with your deployment's base URL: <deployment-url>/api/public

Returns all integrations available in your workspace, including both Odeus-built integrations and custom integrations you've created.

Required Scopes

This endpoint requires one of the following API key scopes:

• ASSISTANT_API
• INTEGRATION_API

Example

const axios = require("axios");

async function listIntegrations() {
  const response = await axios.get(
    "https://api.odeus.ai/integrations/v1/get",
    {
      headers: {
        Authorization: "Bearer YOUR_API_KEY"
      }
    }
  );

  console.log("Integrations:", response.data.integrations);
}

listIntegrations();

Response Format

Success Response (200 OK)

{
  integrations: Array<{
    id: string;              // UUID of the integration
    name: string;            // Display name
    description: string;     // Integration description
    authType: string;        // Authentication type (e.g., "OAUTH", "API_KEY", "NONE")
    buildByOdeus: boolean; // true if this is a Odeus-built integration
    actions: Array<{
      id: string;            // UUID of the action
      name: string;          // Action display name
      description: string;   // Action description
    }&gt;;
  }>;
}

Example Response

{
  "integrations": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "Slack",
      "description": "Send messages and interact with Slack",
      "authType": "OAUTH",
      "buildByOdeus": true,
      "actions": [
        {
          "id": "660e8400-e29b-41d4-a716-446655440001",
          "name": "Send Message",
          "description": "Send a message to a Slack channel"
        },
        {
          "id": "660e8400-e29b-41d4-a716-446655440002",
          "name": "Create Channel",
          "description": "Create a new Slack channel"
        }
      ]
    },
    {
      "id": "770e8400-e29b-41d4-a716-446655440000",
      "name": "My Custom Integration",
      "description": "Internal API connector",
      "authType": "API_KEY",
      "buildByOdeus": false,
      "actions": [
        {
          "id": "880e8400-e29b-41d4-a716-446655440001",
          "name": "Get User Data",
          "description": "Retrieves user information"
        }
      ]
    }
  ]
}

Error Handling

Status Code	Description
401	Invalid or missing API key
429	Rate limit exceeded
500	Internal server error

Odeus intentionally blocks browser-origin requests to protect your API key and ensure your applications remain secure. For more information, please see our guide on API Key Best Practices.