How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Need help?

Contact us
Profound

Profound Agents API

The Agents API from Profound — 8 operation(s) for agents.

Documentation Provider Profile APIs.io OpenAPI GitHub

Profound Agents API is one of 16 APIs that Profound publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Agents. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, authentication docs, and a changelog.

This API exposes 10 operations across 8 paths, and defines 23 schemas. It is described by OpenAPI 3.2.0, at version 6551bd49db665ffb7f80780b3e150b8e8b780cc3.

Requests are made against a single base URL, https://api.tryprofound.com.

10 operations 8 paths 23 schemas 6 GET1 PATCH3 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
6551bd49db665ffb7f80780b3e150b8e8b780cc3
Base URL
https://api.tryprofound.com
Authentication
API Key, HTTP Bearer
Resource Areas
1

Authentication & Security 2

Profound Agents API declares 2 security schemes for authenticating requests. An API key is passed in the header as X-API-Key (APIKeyHeader). It accepts HTTP bearer tokens (BearerAuth).

Paths & Operations 10

Across 8 paths, the API surfaces 10 operations — 6 GET, 1 PATCH, 3 POST. Each is listed below with its method, path, parameters, and response codes.

Agents 10
GET
/v1/agents
List agents
list_agents_v1_agents_get 3 params → 200422
POST
/v1/agents
Create an agent
create_agent_v1_agents_post body → 201422
POST
/v1/agents/{agent_id}/publish
Publish an agent
publish_agent_v1_agents__agent_id__publish_post 1 param → 201422
GET
/v1/agents/node-types
List node types
list_node_types_v1_agents_node_types_get → 200422
GET
/v1/agents/node-types/{node_type}/schema
Get a node type schema
get_node_type_schema_v1_agents_node_types__node_type__schema_get 1 param → 200422
GET
/v1/agents/{agent_id}
Get an agent
get_agent_v1_agents__agent_id__get 2 params → 200422
PATCH
/v1/agents/{agent_id}
Update an agent
update_agent_v1_agents__agent_id__patch 1 param body → 200422
GET
/v1/agents/{agent_id}/graph
Get an agent's graph
get_agent_graph_v1_agents__agent_id__graph_get 2 params → 200422
POST
/v1/agents/{agent_id}/runs
Run an agent
run_agent_v1_agents__agent_id__runs_post 1 param body → 202422
GET
/v1/agents/{agent_id}/runs/{run_id}
Get an agent run
get_agent_run_v1_agents__agent_id__runs__run_id__get 3 params → 200422

Schemas 23

The contract defines 23 schemas that model the data the API accepts and returns. The most detailed are AgentRun (8 properties), AgentDetail (8 properties), AgentRunStep (8 properties), NodeSchemaResponse (7 properties). Each schema is shown below with its type and property counts.

HTTPValidationError
object
1 property
ListNodeTypesResponse
object
List of node types available to v1 agent authors.
1 property 1 required
RunAgentRequest
object
Request body for starting an agent run.
1 property
AgentRun
object
Status and result details for an agent run.
8 properties 3 required
AcceptedAgentRun
object
Run details returned after a run request is accepted.
4 properties 3 required
CursorPagination
object
Cursor-based pagination metadata.
2 properties
AgentGraph
object
An agent version's workflow graph in the canonical dialect.
3 properties 3 required
ListAgentsStatusFilter
string
Statuses you can use to filter the list agents response.
AgentValidationIssue
object
A single problem found while validating an agent's graph.
7 properties 2 required
ListAgentsResponse
object
Paginated list of agents.
2 properties 1 required
AgentStatus
string
Current availability status for an agent.
AgentSchema
object
Schema metadata for an agent.
2 properties 2 required
AgentVersion
string
Version selector for retrieving a specific agent.
ValidationError
object
5 properties 3 required
AgentDetail
object
Detailed information for an agent.
8 properties 5 required
UpdateAgentRequest
object
Request body for updating a draft agent's graph in place.
1 property 1 required
AgentValidation
object
Result of validating an agent's graph. Mirrors the report computed on every read, so callers can confirm a draft is publishable before calling publish.
2 properties 1 required
NodeTypeSummary
object
Thin summary for a node type available to v1 agent authors.
3 properties 2 required
AgentRunStep
object
One executed node in a run's step trace, in execution order. The lightweight fields always ship; outputs is populated only when the run-retrieve request asks f…
8 properties 4 required
NodeSchemaResponse
object
JSON schema for a single node type.
7 properties 3 required
AgentRunStatus
string
Current execution status for an agent run.
CreateAgentRequest
object
Request body for creating a draft agent.
4 properties 2 required
Agent
object
Summary information for an agent.
6 properties 5 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

profound-agents-api-openapi.yml Raw ↑

Other APIs Profound publishes across the network.

Profound Agent Analytics Ingestion API
AE Profile APIs.io
Profound Beta API
AE Profile APIs.io
Profound Bot Traffic Reports API
AE Profile APIs.io
Profound Categories API
AE Profile APIs.io
Profound Content API
AE Profile APIs.io
Profound Content optimization API
AE Profile APIs.io
Profound Documents API
AE Profile APIs.io
Profound Human Referrals API
AE Profile APIs.io
Profound Integrations API
AE Profile APIs.io
Profound Knowledge bases API
AE Profile APIs.io
Profound OpenAI Ads API
AE Profile APIs.io
Profound Organization API
AE Profile APIs.io
#Agents
← Back to P APIs
API Details
ID
profound:profound-agents-api
Base URL
https://api.tryprofound.com
Docs
https://docs.tryprofound.com/rest-api/introduction
Provider
Profound
APIs.io →  GitHub →
Explore more
All APIs Providers APIs.io Network
Work with this as data

Every API here is available over the API and to AI agents over MCP. APIs is not yet its own endpoint on the v1 API. Reach this content through network search and the tag graph, or the MCP server below.

Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.

MCP tools for apis
4 tools reach this content
  • search_api_evangelistSearch every content type across the network at once.
  • find_relatedThe shared-tag relevance graph — what else covers this.
  • get_tagEverything one tag labels, across all content types.
  • guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
All tools & prompts
Call it yourself
curl for this page
Search the network for this 
curl "https://api.apievangelist.com/v1/search?q=profound-agents-api&limit=10"
Everything under a tag 
curl "https://api.apievangelist.com/v1/tags/profound-agents-api"

Discovery needs no key. Full bodies and the synthesis endpoints are Pro.

Get an API key

Free tier, no email required. Sign in with whichever identity you already have.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have. Your account

Where this information came from

This is an independent, third-party profile of Profound Agents API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.