@apteva/integrations 0.2.3 → 0.3.1

package/src/apps/ashby.json

@@ -0,0 +1,176 @@
+{
+  "slug": "ashby",
+  "name": "Ashby",
+  "description": "Ashby applicant tracking system (ATS) and recruiting platform. Manage candidates, jobs, and applications for your hiring pipeline.",
+  "logo": "https://www.google.com/s2/favicons?domain=ashbyhq.com&sz=128",
+  "categories": [
+    "ats",
+    "recruiting",
+    "hiring",
+    "hr",
+    "candidates",
+    "applicant-tracking"
+  ],
+  "base_url": "https://api.ashbyhq.com",
+  "auth": {
+    "types": [
+      "bearer"
+    ],
+    "headers": {
+      "Authorization": "Bearer {{token}}"
+    },
+    "credential_fields": [
+      {
+        "name": "token",
+        "label": "Api Key",
+        "description": "Ashby API key (generate from Ashby admin settings)"
+      }
+    ]
+  },
+  "tools": [
+    {
+      "name": "list_candidates",
+      "description": "List all candidates in your Ashby organization. Supports cursor-based pagination for iterating through large candidate lists. Use the nextCursor from the response to fetch the next page of results.",
+      "method": "POST",
+      "path": "/candidate.list",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "cursor": {
+            "type": "string",
+            "description": "Pagination cursor from a previous response's nextCursor field. Omit for the first page."
+          },
+          "syncToken": {
+            "type": "string",
+            "description": "Sync token for incremental synchronization. Only returns candidates updated since the token was issued."
+          },
+          "per_page": {
+            "type": "integer",
+            "description": "Number of candidates to return per page."
+          }
+        }
+      }
+    },
+    {
+      "name": "get_candidate",
+      "description": "Retrieve detailed information about a specific candidate by their ID. Returns candidate profile data including name, email, phone, social profiles, tags, and application history.",
+      "method": "POST",
+      "path": "/candidate.info",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string",
+            "description": "The unique ID of the candidate to retrieve."
+          }
+        },
+        "required": [
+          "id"
+        ]
+      }
+    },
+    {
+      "name": "list_jobs",
+      "description": "List all jobs in your Ashby organization including open, closed, and archived positions. Supports cursor-based pagination. Returns job metadata such as title, department, location, and status.",
+      "method": "POST",
+      "path": "/job.list",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "cursor": {
+            "type": "string",
+            "description": "Pagination cursor from a previous response's nextCursor field. Omit for the first page."
+          },
+          "syncToken": {
+            "type": "string",
+            "description": "Sync token for incremental synchronization. Only returns jobs updated since the token was issued."
+          },
+          "per_page": {
+            "type": "integer",
+            "description": "Number of jobs to return per page."
+          }
+        }
+      }
+    },
+    {
+      "name": "list_applications",
+      "description": "List all applications in your Ashby organization. Returns application details including candidate, job, current stage, status, and source. Supports cursor-based pagination for iterating through large result sets.",
+      "method": "POST",
+      "path": "/application.list",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "cursor": {
+            "type": "string",
+            "description": "Pagination cursor from a previous response's nextCursor field. Omit for the first page."
+          },
+          "syncToken": {
+            "type": "string",
+            "description": "Sync token for incremental synchronization. Only returns applications updated since the token was issued."
+          },
+          "per_page": {
+            "type": "integer",
+            "description": "Number of applications to return per page."
+          }
+        }
+      }
+    },
+    {
+      "name": "create_candidate",
+      "description": "Create a new candidate in Ashby. At minimum, a name is required. Optionally include email, phone number, LinkedIn URL, and other profile information. Returns the newly created candidate object with its assigned ID.",
+      "method": "POST",
+      "path": "/candidate.create",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "name": {
+            "type": "string",
+            "description": "Full name of the candidate (required)."
+          },
+          "email": {
+            "type": "string",
+            "description": "Primary email address of the candidate."
+          },
+          "phoneNumber": {
+            "type": "string",
+            "description": "Phone number of the candidate."
+          },
+          "linkedInUrl": {
+            "type": "string",
+            "description": "LinkedIn profile URL of the candidate."
+          },
+          "githubUrl": {
+            "type": "string",
+            "description": "GitHub profile URL of the candidate."
+          },
+          "website": {
+            "type": "string",
+            "description": "Personal website URL of the candidate."
+          },
+          "alternateEmailAddresses": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "Array of additional email addresses for the candidate."
+          },
+          "sourceId": {
+            "type": "string",
+            "description": "ID of the source to attribute this candidate to."
+          },
+          "creditedToUserId": {
+            "type": "string",
+            "description": "ID of the user who should be credited for adding this candidate."
+          },
+          "location": {
+            "type": "string",
+            "description": "Location of the candidate (e.g. 'San Francisco, CA')."
+          }
+        },
+        "required": [
+          "name"
+        ]
+      }
+    }
+  ]
+}

package/src/apps/assemblyai.json

@@ -0,0 +1,163 @@
+{
+  "slug": "assemblyai",
+  "name": "AssemblyAI",
+  "description": "AssemblyAI speech-to-text and audio intelligence API. Transcribe audio files, retrieve transcription results, and search within transcripts.",
+  "logo": "https://www.google.com/s2/favicons?domain=assemblyai.com&sz=128",
+  "categories": [
+    "speech-to-text",
+    "transcription",
+    "audio",
+    "ai",
+    "audio-intelligence"
+  ],
+  "base_url": "https://api.assemblyai.com/v2",
+  "auth": {
+    "types": [
+      "bearer"
+    ],
+    "headers": {
+      "Authorization": "Bearer {{token}}"
+    },
+    "credential_fields": [
+      {
+        "name": "token",
+        "label": "Api Key",
+        "description": "AssemblyAI API key (find at assemblyai.com/app/account)"
+      }
+    ]
+  },
+  "tools": [
+    {
+      "name": "create_transcript",
+      "description": "Submit an audio file for transcription. Provide a publicly accessible URL to the audio/video file. The transcription is processed asynchronously - use the returned transcript ID to poll for results with the Get Transcript endpoint. Supports optional features like speaker diarization, auto chapters, entity detection, and sentiment analysis.",
+      "method": "POST",
+      "path": "/transcript",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "audio_url": {
+            "type": "string",
+            "description": "The publicly accessible URL of the audio or video file to transcribe."
+          },
+          "language_code": {
+            "type": "string",
+            "description": "Language code for the audio (e.g. 'en', 'es', 'fr'). Defaults to 'en' (English)."
+          },
+          "speaker_labels": {
+            "type": "boolean",
+            "description": "Enable speaker diarization to identify different speakers in the audio."
+          },
+          "auto_chapters": {
+            "type": "boolean",
+            "description": "Enable auto chapters to automatically segment the transcript into chapters with summaries."
+          },
+          "entity_detection": {
+            "type": "boolean",
+            "description": "Enable entity detection to identify and classify entities (people, locations, etc.) in the transcript."
+          },
+          "sentiment_analysis": {
+            "type": "boolean",
+            "description": "Enable sentiment analysis to detect the sentiment of each sentence in the transcript."
+          },
+          "auto_highlights": {
+            "type": "boolean",
+            "description": "Enable auto highlights to automatically extract key phrases from the transcript."
+          },
+          "punctuate": {
+            "type": "boolean",
+            "description": "Enable automatic punctuation. Enabled by default."
+          },
+          "format_text": {
+            "type": "boolean",
+            "description": "Enable text formatting (e.g. numbers, dates). Enabled by default."
+          },
+          "webhook_url": {
+            "type": "string",
+            "description": "URL to receive a webhook notification when the transcript is complete."
+          }
+        },
+        "required": [
+          "audio_url"
+        ]
+      }
+    },
+    {
+      "name": "get_transcript",
+      "description": "Retrieve the status and results of a transcript by its ID. The transcript is ready when the 'status' field is 'completed'. While processing, the status will be 'queued' or 'processing'. If transcription fails, the status will be 'error' with an error message.",
+      "method": "GET",
+      "path": "/transcript/%7B%7Bparam.transcript_id%7D%7D",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "transcript_id": {
+            "type": "string",
+            "description": "The unique ID of the transcript to retrieve."
+          }
+        },
+        "required": [
+          "transcript_id"
+        ]
+      }
+    },
+    {
+      "name": "list_transcripts",
+      "description": "List all transcripts for your account with pagination support. Returns transcript metadata including IDs, status, audio URLs, and creation timestamps. Use limit and cursor parameters to paginate through results.",
+      "method": "GET",
+      "path": "/transcript",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "limit": {
+            "type": "integer",
+            "description": "Maximum number of transcripts to return. Default is 20."
+          },
+          "after_id": {
+            "type": "string",
+            "description": "Return transcripts created after this transcript ID (for forward pagination)."
+          },
+          "before_id": {
+            "type": "string",
+            "description": "Return transcripts created before this transcript ID (for backward pagination)."
+          },
+          "status": {
+            "type": "string",
+            "description": "Filter by transcript status.",
+            "enum": [
+              "queued",
+              "processing",
+              "completed",
+              "error"
+            ]
+          },
+          "throttled_only": {
+            "type": "boolean",
+            "description": "Set to true to only return throttled transcripts."
+          }
+        }
+      }
+    },
+    {
+      "name": "word_search",
+      "description": "Search for specific words or phrases within a completed transcript. Returns match counts, positions in the word array, and associated timestamps for each match. Supports individual words, numbers, or phrases containing up to five words.",
+      "method": "GET",
+      "path": "/transcript/%7B%7Bparam.transcript_id%7D%7D/word-search",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "transcript_id": {
+            "type": "string",
+            "description": "The ID of the completed transcript to search within."
+          },
+          "words": {
+            "type": "string",
+            "description": "Comma-separated list of words or phrases to search for in the transcript."
+          }
+        },
+        "required": [
+          "transcript_id",
+          "words"
+        ]
+      }
+    }
+  ]
+}

package/src/apps/attio.json

@@ -0,0 +1,243 @@
+{
+  "slug": "attio",
+  "name": "Attio",
+  "description": "Attio CRM platform. Manage meetings, call recordings, and customer relationship data.",
+  "logo": "https://www.google.com/s2/favicons?domain=attio.com&sz=128",
+  "categories": [
+    "crm",
+    "attio",
+    "meetings",
+    "call-recordings"
+  ],
+  "base_url": "https://api.attio.com/v2",
+  "auth": {
+    "types": [
+      "bearer"
+    ],
+    "headers": {
+      "Authorization": "Bearer {{token}}"
+    },
+    "credential_fields": [
+      {
+        "name": "accessToken",
+        "label": "Access Token",
+        "description": "Attio API access token (generate at app.attio.com under Settings > Developers > API keys)"
+      }
+    ]
+  },
+  "tools": [
+    {
+      "name": "list_meetings",
+      "description": "List and filter meetings from Attio CRM. Supports cursor-based pagination and time-range filtering by start/end timestamps. Use ends_from and starts_before to narrow results to a specific date range.",
+      "method": "GET",
+      "path": "/meetings",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "limit": {
+            "type": "integer",
+            "description": "Maximum number of meetings to return. Defaults to 50, maximum 200.",
+            "default": 50
+          },
+          "cursor": {
+            "type": "string",
+            "description": "Pagination cursor from a previous response's pagination.next_cursor field. Omit for the first page."
+          },
+          "ends_from": {
+            "type": "string",
+            "description": "Filter to meetings ending after this timestamp (inclusive). ISO 8601 format, e.g. 2025-01-01T00:00:00Z."
+          },
+          "starts_before": {
+            "type": "string",
+            "description": "Filter to meetings starting before this timestamp (exclusive). ISO 8601 format, e.g. 2025-12-31T23:59:59Z."
+          },
+          "timezone": {
+            "type": "string",
+            "description": "Timezone for interpreting ends_from and starts_before filters. Defaults to UTC. IANA timezone format, e.g. America/New_York.",
+            "default": "UTC"
+          }
+        }
+      }
+    },
+    {
+      "name": "list_call_recordings",
+      "description": "List all call recordings associated with a specific meeting in Attio CRM. Returns recording metadata including video URLs and processing status. Requires a meeting ID obtained from the list meetings endpoint.",
+      "method": "GET",
+      "path": "/meetings/%7B%7Bparam.meeting_id%7D%7D/call_recordings",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "meeting_id": {
+            "type": "string",
+            "description": "The unique identifier of the meeting to list call recordings for."
+          },
+          "limit": {
+            "type": "integer",
+            "description": "Maximum number of call recordings to return. Defaults to 50, maximum 200.",
+            "default": 50
+          },
+          "cursor": {
+            "type": "string",
+            "description": "Pagination cursor from a previous response's pagination.next_cursor field. Omit for the first page."
+          }
+        },
+        "required": [
+          "meeting_id"
+        ]
+      }
+    },
+    {
+      "name": "create_call_recording",
+      "description": "Create a new call recording for a meeting in Attio CRM. Provide a video URL pointing to the recording file. Rate limited to 1 request per second. This endpoint is in alpha.",
+      "method": "POST",
+      "path": "/meetings/%7B%7Bparam.meeting_id%7D%7D/call_recordings",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "meeting_id": {
+            "type": "string",
+            "description": "The unique identifier of the meeting to attach the call recording to."
+          },
+          "video_url": {
+            "type": "string",
+            "description": "The publicly accessible URL of the call recording video file (e.g. https://example.com/recording.mp4)."
+          }
+        },
+        "required": [
+          "meeting_id",
+          "video_url"
+        ]
+      }
+    },
+    {
+      "name": "create_meeting",
+      "description": "Find or create a meeting in Attio CRM. Uses external_ref for idempotency -- if a meeting with the same external_ref already exists for your integration, it will be returned instead of creating a duplicate. Supports setting title, description, time range, participants, and linked records. This endpoint is in alpha.",
+      "method": "POST",
+      "path": "/meetings",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "data": {
+            "type": "object",
+            "description": "The meeting data object containing all meeting details.",
+            "properties": {
+              "title": {
+                "type": "string",
+                "description": "The title of the meeting, e.g. 'Onboarding Session'."
+              },
+              "description": {
+                "type": "string",
+                "description": "A text description or summary of the meeting."
+              },
+              "start": {
+                "type": "object",
+                "description": "The start time of the meeting.",
+                "properties": {
+                  "datetime": {
+                    "type": "string",
+                    "description": "ISO 8601 datetime string, e.g. 2025-06-01T10:00:00."
+                  },
+                  "timezone": {
+                    "type": "string",
+                    "description": "IANA timezone, e.g. America/New_York."
+                  }
+                },
+                "required": [
+                  "datetime",
+                  "timezone"
+                ]
+              },
+              "end": {
+                "type": "object",
+                "description": "The end time of the meeting.",
+                "properties": {
+                  "datetime": {
+                    "type": "string",
+                    "description": "ISO 8601 datetime string, e.g. 2025-06-01T11:00:00."
+                  },
+                  "timezone": {
+                    "type": "string",
+                    "description": "IANA timezone, e.g. America/New_York."
+                  }
+                },
+                "required": [
+                  "datetime",
+                  "timezone"
+                ]
+              },
+              "is_all_day": {
+                "type": "boolean",
+                "description": "Whether this is an all-day meeting. Defaults to false.",
+                "default": false
+              },
+              "participants": {
+                "type": "array",
+                "description": "List of meeting participants.",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "email_address": {
+                      "type": "string",
+                      "description": "The participant's email address."
+                    },
+                    "is_organizer": {
+                      "type": "boolean",
+                      "description": "Whether this participant is the meeting organizer.",
+                      "default": false
+                    },
+                    "status": {
+                      "type": "string",
+                      "description": "The participant's attendance status.",
+                      "enum": [
+                        "accepted",
+                        "declined",
+                        "tentative",
+                        "needs_action"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "email_address"
+                  ]
+                }
+              },
+              "external_ref": {
+                "type": "string",
+                "description": "A unique external reference identifier for idempotency. Calls with the same external_ref from your integration will be treated as the same meeting."
+              },
+              "linked_records": {
+                "type": "array",
+                "description": "Records to link to this meeting (e.g. companies, deals).",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "object": {
+                      "type": "string",
+                      "description": "The object type slug, e.g. 'companies' or 'deals'."
+                    },
+                    "record_id": {
+                      "type": "string",
+                      "description": "The record ID to link."
+                    }
+                  },
+                  "required": [
+                    "object",
+                    "record_id"
+                  ]
+                }
+              }
+            },
+            "required": [
+              "title",
+              "start",
+              "end"
+            ]
+          }
+        },
+        "required": [
+          "data"
+        ]
+      }
+    }
+  ]
+}