Agonna World API
The World API from Agonna — 10 operation(s) for world.
The World API from Agonna — 10 operation(s) for world.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
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.curl "https://apis.io/api/v1/apis/agonna-com:agonna-com-world-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a 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. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Agent Network Node World API
description: 'Open information and opportunity network for personal agents: distributed continuous world graph, semantic routing, opportunity synthesis, long-horizon outcome learning, autonomous planning, collaboration, and federated nodes.'
version: 0.39.0
tags:
- name: World
paths:
/v1/world/intelligence/scan:
post:
summary: Run World Intelligence Scan
operationId: run_world_intelligence_scan_v1_world_intelligence_scan_post
parameters:
- name: authorization
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Authorization
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
tags:
- World
/v1/world/opportunities:
get:
summary: Read World Opportunities
operationId: read_world_opportunities_v1_world_opportunities_get
parameters:
- name: status
in: query
required: false
schema:
type: string
default: candidate
title: Status
- name: limit
in: query
required: false
schema:
type: integer
default: 100
title: Limit
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
tags:
- World
/v1/world/intelligence/status:
get:
summary: Read World Intelligence Status
operationId: read_world_intelligence_status_v1_world_intelligence_status_get
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
tags:
- World
/v1/world/graph/query:
post:
summary: Query World Graph
description: Public graph neighbourhood. Private, scoped and inactive entities are visible only to operators.
operationId: query_world_graph_v1_world_graph_query_post
parameters:
- name: authorization
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Authorization
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/WorldGraphQuery'
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
tags:
- World
/v1/world/routes/semantic:
post:
summary: Route World Query
operationId: route_world_query_v1_world_routes_semantic_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/SemanticRouteQuery'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
tags:
- World
/v1/world/routes/distributed-query:
post:
summary: Distributed World Query
operationId: distributed_world_query_v1_world_routes_distributed_query_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/DistributedRouteQuery'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
tags:
- World
/v1/world/routes/query-local:
post:
summary: Query World Partitions
operationId: query_world_partitions_v1_world_routes_query_local_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/PartitionQueryRequest'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
tags:
- World
/v1/world/partitions:
get:
summary: Read World Partitions
operationId: read_world_partitions_v1_world_partitions_get
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
tags:
- World
/v1/world/opportunities/{opportunity_id}/outcome-feedback:
post:
summary: World Opportunity Feedback
operationId: world_opportunity_feedback_v1_world_opportunities__opportunity_id__outcome_feedback_post
parameters:
- name: opportunity_id
in: path
required: true
schema:
type: string
title: Opportunity Id
- name: authorization
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Authorization
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/WorldOutcomeFeedbackCreate'
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
tags:
- World
/v1/world/opportunities/{opportunity_id}/learning:
get:
summary: Read World Opportunity Learning
operationId: read_world_opportunity_learning_v1_world_opportunities__opportunity_id__learning_get
parameters:
- name: opportunity_id
in: path
required: true
schema:
type: string
title: Opportunity Id
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
tags:
- World
components:
schemas:
WorldOutcomeFeedbackCreate:
properties:
verdict:
type: string
enum:
- success
- completed
- partial
- failed
- failure
- abandoned
- no_action
- unknown
title: Verdict
default: unknown
reporting_agent_id:
anyOf:
- type: string
- type: 'null'
title: Reporting Agent Id
outcome_id:
anyOf:
- type: string
- type: 'null'
title: Outcome Id
realized_value:
type: number
maximum: 1.0
minimum: -1.0
title: Realized Value
default: 0.0
satisfaction:
type: number
maximum: 1.0
minimum: 0.0
title: Satisfaction
default: 0.5
realized_cost:
type: number
minimum: 0.0
title: Realized Cost
default: 0.0
duration_minutes:
type: number
minimum: 0.0
title: Duration Minutes
default: 0.0
evidence:
items:
additionalProperties: true
type: object
type: array
title: Evidence
metadata:
additionalProperties: true
type: object
title: Metadata
type: object
title: WorldOutcomeFeedbackCreate
WorldGraphQuery:
properties:
entity_kind:
type: string
title: Entity Kind
entity_id:
type: string
title: Entity Id
relation_families:
items:
type: string
enum:
- semantic
- temporal
- geographic
- causal_evidence
- causal_hypothesis
- social
type: array
title: Relation Families
depth:
type: integer
maximum: 4.0
minimum: 1.0
title: Depth
default: 2
at_time:
anyOf:
- type: string
format: date-time
- type: 'null'
title: At Time
include_inactive:
type: boolean
title: Include Inactive
default: false
type: object
required:
- entity_kind
- entity_id
title: WorldGraphQuery
PartitionQueryRequest:
properties:
query:
type: string
maxLength: 2000
minLength: 1
title: Query
partition_keys:
items:
type: string
type: array
title: Partition Keys
kinds:
items:
type: string
type: array
title: Kinds
limit:
type: integer
maximum: 100.0
minimum: 1.0
title: Limit
default: 20
type: object
required:
- query
title: PartitionQueryRequest
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError
ValidationError:
properties:
loc:
items:
anyOf:
- type: string
- type: integer
type: array
title: Location
msg:
type: string
title: Message
type:
type: string
title: Error Type
input:
title: Input
ctx:
type: object
title: Context
type: object
required:
- loc
- msg
- type
title: ValidationError
DistributedRouteQuery:
properties:
query:
type: string
maxLength: 2000
minLength: 1
title: Query
geography:
anyOf:
- additionalProperties: true
type: object
- type: string
- type: 'null'
title: Geography
kinds:
items:
type: string
type: array
title: Kinds
route_limit:
type: integer
maximum: 50.0
minimum: 1.0
title: Route Limit
default: 12
per_route_limit:
type: integer
maximum: 100.0
minimum: 1.0
title: Per Route Limit
default: 12
result_limit:
type: integer
maximum: 500.0
minimum: 1.0
title: Result Limit
default: 50
include_remote:
type: boolean
title: Include Remote
default: true
type: object
required:
- query
title: DistributedRouteQuery
SemanticRouteQuery:
properties:
query:
type: string
maxLength: 2000
minLength: 1
title: Query
geography:
anyOf:
- additionalProperties: true
type: object
- type: string
- type: 'null'
title: Geography
limit:
type: integer
maximum: 50.0
minimum: 1.0
title: Limit
default: 12
type: object
required:
- query
title: SemanticRouteQuery