Profound

Profound Agents API

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

GitHub OpenAPI

Operations 10

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /v1/agents List the organization's agents · List agents #
Ask an LLM
“Which agents does my organization have in Profound?”
“Can I see only the agents that have never been published?”
Tell an agent
List all of my organization's agents.
Show me only agents with status {statuses}.
POST /v1/agents Create a new draft agent · Create an agent #
Ask an LLM
“How do I build a new agent from scratch for my organization?”
“Is a newly created agent live right away or does it start as a draft?”
Tell an agent
Create a draft agent called {name} in organization {organization_id}.
Create agent {name} in org {organization_id} described as {description} with workflow graph {graph}.
POST /v1/agents/{agent_id}/publish Publish an agent's draft as live · Publish an agent #
Ask an LLM
“How do I take my agent's draft live?”
“Why would publishing an agent fail with a 422 validation error?”
Tell an agent
Publish the latest draft of agent {agent_id}.
Promote agent {agent_id}'s draft graph to a new published version.
GET /v1/agents/node-types List node types for building agents · List node types #
Ask an LLM
“What building blocks can I use when designing an agent workflow?”
“Which node types are available for agent graphs, and can I cache that list?”
Tell an agent
List every node type I can use in an agent graph.
Show the catalog of available agent node types.
GET /v1/agents/node-types/{node_type}/schema Get the config schema for a node type · Get a node type schema #
Ask an LLM
“What configuration fields does a particular agent node type accept?”
“How can I tell when a node type's JSON schema has changed?”
Tell an agent
Get the configuration JSON schema for node type {node_type}.
Fetch the schema and schema_version for the {node_type} node.
GET /v1/agents/{agent_id} Get an agent's details · Get an agent #
Ask an LLM
“Can I look up one agent's details and status?”
“Is it possible to view an agent's unpublished draft instead of its live version?”
Tell an agent
Show me agent {agent_id}.
Get the {version} version of agent {agent_id} with its schema details.
PATCH /v1/agents/{agent_id} Replace an agent's draft graph · Update an agent #
Ask an LLM
“How do I fix my agent's workflow without creating a new agent?”
“Does updating an agent re-validate the draft before I publish it?”
Tell an agent
Replace the draft graph of agent {agent_id} with {graph}.
Save this revised workflow {graph} as agent {agent_id}'s draft and tell me if it validates.
GET /v1/agents/{agent_id}/graph Get an agent's workflow graph · Get an agent's graph #
Ask an LLM
“Can I export an agent's nodes and edges so I can copy it?”
“Who can see an agent's draft graph versus its published graph?”
Tell an agent
Export the nodes and edges of agent {agent_id}.
Get the {version} workflow graph for agent {agent_id} so I can edit a copy.
POST /v1/agents/{agent_id}/runs Start a run of a published agent · Run an agent #
Ask an LLM
“How do I execute one of my agents?”
“Can I run an agent that has only a draft and was never published?”
Tell an agent
Run agent {agent_id} now.
Kick off a new execution of agent {agent_id}'s live version.
GET /v1/agents/{agent_id}/runs/{run_id} Check an agent run's status and result · Get an agent run #
Ask an LLM
“Has my agent run finished, and what did it return?”
“Can I get verbose detail on an individual agent run?”
Tell an agent
Check the status of run {run_id} for agent {agent_id}.
Get verbose={verbose} results for run {run_id} of agent {agent_id}.

Documentation

📖
Documentation
https://docs.tryprofound.com/rest-api/introduction
📖
APIReference
https://docs.tryprofound.com/api-reference/organization/get-categories
📖
Authentication
https://docs.tryprofound.com/rest-api/authentication

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/profound/refs/heads/main/openapi/profound-agents-api-openapi.yml

Other Resources

🔗
OpenAPI Source
https://api.tryprofound.com/openapi.json
🔗
ChangeLog
https://docs.tryprofound.com/rest-api/changelog

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/profound:profound-agents-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

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

OpenAPI Specification

profound-agents-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: External Agents API
  version: 6551bd49db665ffb7f80780b3e150b8e8b780cc3
servers:
- url: https://api.tryprofound.com
  description: Production Server
tags:


# --- truncated at 32 KB (34 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/profound/refs/heads/main/openapi/profound-agents-api-openapi.yml