Perigon integration: operations for AI agents
Perigon connects to Type.com as an integration. This page lists the 50 operations documented for Claude and Codex in Type.com: 35 read, 10 write, 5 destructive.
About Perigon
Perigon API reference operations, subject to Type setup and account permissions.
Categories: Analytics & Data
How to connect Perigon to Type.com
- Connect
- Configure provider-specific API target and authentication setup.
- Access
- Organization connection: one shared account for the workspace.
To add the connection, follow the steps in Space connections.
Documented operations
50 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.
50 operations listed.
Contact Points
- Read
List contact points
List contact points owned by the organization associated with the API key. Supports filtering by status and type. FASTN contact points are excluded from results.
GET /v1/api/contactPoints - Read
Get contact point
Retrieve a contact point by UUID. Only returns contact points owned by the organization associated with the API key. FASTN contact points are not accessible via this endpoint.
GET /v1/api/contactPoints/{uuid} - Write
Create contact point
Create a new contact point under the organization associated with the API key. Only WEBHOOK contact points can be created via the API.
POST /v1/api/contactPoints - Write
Update contact point
Partially update a contact point owned by the organization associated with the API key. Only provided fields will be updated.
PATCH /v1/api/contactPoints/{uuid} - Destructive
Delete contact point
Delete a contact point owned by the organization associated with the API key. Contact points with historical notifications are archived rather than hard-deleted.
DELETE /v1/api/contactPoints/{uuid}
Monitors
- Read
List monitors
List AI monitors for the organization associated with the API key. Excludes archived monitors by default. Use the status parameter to filter.
GET /v1/api/monitors - Read
Get monitor
Retrieve a monitor by UUID for the organization associated with the API key.
GET /v1/api/monitors/{uuid} - Read
List monitor events
List structured events emitted by a monitor. Events represent individual matches detected by the monitor (e.g. a news article matching the monitor's criteria) and are produced asynchronously as new content is ingested.
GET /v1/api/monitors/{uuid}/events - Read
List monitor newsletters
List newsletters generated for a monitor. Newsletters bundle a monitor's recent events into a human-readable digest and are produced on the monitor's configured schedule.
GET /v1/api/monitors/{uuid}/newsletters - Read
List monitor summaries
List AI-generated summaries produced for a monitor as matching content is processed.
GET /v1/api/monitors/{uuid}/summary - Write
Create monitor
Create a new AI monitor. Only AI_SIGNAL type is supported; status is required and accepts ACTIVE or DRAFT.
POST /v1/api/monitors - Write
Activate monitor
Activate a monitor, starting its processing pipeline.
POST /v1/api/monitors/{uuid}/activate - Write
Pause monitor
Pause a monitor, stopping its processing pipeline.
POST /v1/api/monitors/{uuid}/pause - Destructive
Archive monitor
Archive a monitor. Archived monitors are excluded from list results by default.
DELETE /v1/api/monitors/{uuid} - Destructive
Update monitor
Partially update a monitor. Only provided fields are modified. Use /activate, /pause, or DELETE to change monitor status.
PATCH /v1/api/monitors/{uuid}
Source Groups
- Read
List source groups
List source groups owned by the organization associated with the API key, as well as publicly visible source groups. Supports filtering by name and domain.
GET /v1/api/sourceGroups - Read
Resolve source groups
Resolve source groups by name. For each name, returns the organization's private source group if one exists, otherwise falls back to the matching public source group.
GET /v1/api/sourceGroups/resolve - Read
Get source group
Retrieve a source group by ID. Only returns source groups owned by the organization associated with the API key.
GET /v1/api/sourceGroups/{id} - Write
Create source group
Create a new source group under the organization associated with the API key.
POST /v1/api/sourceGroups - Write
Update source group
Partially update a source group owned by the organization associated with the API key. Only provided fields will be updated.
PATCH /v1/api/sourceGroups/{id} - Destructive
Delete source group
Delete a source group owned by the organization associated with the API key.
DELETE /v1/api/sourceGroups/{id}
Watchlists
- Read
List watchlists
List watchlists owned by the organization associated with the API key, as well as publicly visible watchlists. Supports filtering by name.
GET /v1/api/watchlists - Read
Resolve watchlists
Resolve watchlists by name. For each name, returns the organization's private watchlist if one exists, otherwise falls back to the matching public watchlist.
GET /v1/api/watchlists/resolve - Read
Get watchlist
Retrieve a watchlist by ID. Only returns watchlists owned by the organization associated with the API key.
GET /v1/api/watchlists/{id} - Write
Create watchlist
Create a new watchlist under the organization associated with the API key. A watchlist can contain up to 100 combined people and companies.
POST /v1/api/watchlists - Write
Update watchlist
Partially update a watchlist owned by the organization associated with the API key. Only provided fields will be updated.
PATCH /v1/api/watchlists/{id} - Destructive
Delete watchlist
Delete a watchlist owned by the organization associated with the API key. A watchlist cannot be deleted if it is attached to active monitors.
DELETE /v1/api/watchlists/{id}
News & Stories
- Read
All Articles
Search and filter all news articles available via the Perigon API. The result includes a list of individual articles that were matched to your specific criteria.
GET /v1/articles/all - Read
Get article refresh job status
Returns the job status together with whatever per-article results have been computed so far. Results are immutable snapshots taken when each article was processed.
GET /v1/articles/refresh/jobs/{id} - Read
Peek cached article refresh data
Returns whatever refreshed article data is already cached, on a best-effort basis, without scheduling any processing or creating a job.
POST /v1/articles/refresh/peek - Read
Stories
Track evolving narratives and top news headlines with the '**Stories**' endpoint — it returns structured clusters of related articles with summaries, key points, sentiment scores, and metadata on top people, companies, topics, countries, and categories. Use it to monitor how news stories develop over time, who and what they impact, and where they're gaining traction globally. Each story represents a cluster of related articles grouped during processing. Articles are assigned to a single story, identified by the `clusterId` field. Once a story reaches five articles, a story title is automatically generated based on its content. Stories update as new coverage is processed and key details evolve. To fetch all articles within a specific story, query the `/articles/all` endpoint using the `clusterId` parameter.
GET /v1/stories/all - Read
Story History
Retrieve previous generated versions of stories and their evolving summaries, key points, questions, and changelogs.
GET /v1/stories/history - Read
Story Count Statistics
Count matching stories by their creation time. Results can be grouped by hour, day, week, or month and filtered by supported story attributes.
GET /v1/stories/stats - Read
News (Vector)
Perform a natural language search over news articles from the past 6 months using semantic relevance. The result includes a list of articles most closely matched to your query intent.
POST /v1/vector/news/all - Write
Submit an article refresh job
Submits article ids for background refresh. Articles resolvable from a fresh cache are returned immediately; the rest are scheduled for processing. Poll the job status endpoint for results.
POST /v1/articles/refresh/jobs
Supplemental Endpoints
- Read
Companies
Browse or search for companies Perigon tracks using name, domain, ticker symbol, industry, and more. Supports Boolean search logic and filtering by metadata such as country, exchange, employee count, and IPO date.
GET /v1/companies/all - Read
Journalists
Search journalists using broad search attributes. Our database contains over 230,000 journalists from around the world and is refreshed frequently.
GET /v1/journalists/all - Read
Journalists by ID
Find additional details on a journalist by using the journalist ID found in an article response object.
GET /v1/journalists/{id} - Read
People
Search and retrieve additional information on known persons that exist within Perigon's entity database and as referenced in any article response object. Our database contains over 650,000 people from around the world and is refreshed frequently. People data is derived from Wikidata and includes a wikidataId field that can be used to lookup even more information on Wikidata's website.
GET /v1/people/all - Read
Sources
Search and filter the 200,000+ media sources available via the Perigon API. The result includes a list of individual media sources that were matched to your specific criteria.
GET /v1/sources/all - Read
Topics
Search through all available Topics that exist within the Perigon Database.
GET /v1/topics/all
Utilities
- Read
Limits
Returns the authenticated account's current API usage and the limits that apply to it: the number of requests made in the current tracking period, the request limit, the per-second rate limit, and when the counter resets. Optionally, pass one or more API keys via the `apiKeys` parameter to check their status. For each supplied key the response reports whether it is `valid` (exists and belongs to your account), `enabled` (a disabled key is 'off'), and whether its `subscription` is active. This endpoint is authenticated with your API key but is quota-exempt: calling it does **not** count against your monthly request quota and is not subject to rate limiting. It is intended for liveness/health probes and external dashboards that need to check whether an API key and subscription are active without consuming usage.
GET /v1/limits
Social
- Read
LinkedIn Company Posts
Get the recent posts of a LinkedIn company page, newest first. Each request counts against your social request quota, separate from the news API quota.
GET /v1/social/linkedin/companies/posts - Read
LinkedIn Person Activity
Get the recent posts, comments or reactions of a LinkedIn member, newest first. Each request counts against your social request quota, separate from the news API quota.
GET /v1/social/linkedin/people/activity - Read
LinkedIn Posts
Search public LinkedIn posts by keyword. Each request counts against your social request quota, separate from the news API quota.
GET /v1/social/linkedin/posts - Read
Reddit Posts
Search Reddit posts, optionally within a single subreddit. Each request counts against your social request quota, separate from the news API quota.
GET /v1/social/reddit/posts - Read
X Posts
Search recent posts on X (Twitter). Each request counts against your social request quota, separate from the news API quota.
GET /v1/social/x/posts
AI & Advanced Search
- Read
Search Summarizer
Produce one concise summary from up to 100 articles matching the supplied filters. Use the prompt and summarization fields to control which insights are highlighted. When method is CLUSTERS, article-only parameters such as articleId, page, sortBy, watchlist, reprintGroupId, exclusion filters, prefixTaxonomy, and highlighting options are ignored.
POST /v1/summarize
Wikipedia
- Read
Wikipedia (Vector)
Perform a natural language search over Wikipedia pages using semantic relevance. The result includes a list of page sections most closely matched to your query intent.
POST /v1/vector/wikipedia/all - Read
Wikipedia
Search and filter all Wikipedia pages available via the Perigon API. The result includes a list of individual pages that were matched to your specific criteria.
GET /v1/wikipedia/all
No operations match.
See How connections work for access and permissions, or browse all integrations.
Reference date: October 29, 2026. Perigon API docs.