Skip to content
Changelog

Report a bug

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

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

Reference date: October 29, 2026. Perigon API docs.