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

Pomo Agentic Conversations API

The agentic-conversations API from Pomo — 7 operation(s) for agentic-conversations.

Pomo Agentic Conversations API is one of 100 APIs that Pomo publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include agentic-conversations. The published artifact set on APIs.io includes an OpenAPI specification, an API reference, API documentation, authentication docs, and rate-limit docs.

This API exposes 10 operations across 7 paths, and defines 26 schemas. It is described by OpenAPI 3.2.0, at version 0.1.0.

Requests are made against a single base URL, https://api.usepomo.ai.

10 operations 7 paths 26 schemas 1 DELETE3 GET3 PATCH3 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
0.1.0
Base URL
https://api.usepomo.ai
Authentication
HTTP Bearer
Resource Areas
1

Authentication & Security 1

Pomo Agentic Conversations API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (HTTPBearer).

Paths & Operations 10

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

agentic-conversations 10
POST
/api/agentic/conversations
Create Conversation
create_conversation_api_agentic_conversations_post body → 200422
GET
/api/agentic/conversations
List Conversations
list_conversations_api_agentic_conversations_get 4 params → 200422
POST
/api/agentic/conversations/{conversation_id}/attachments
Upload Attachments
upload_attachments_api_agentic_conversations__conversation_id__attachments_post 1 param body → 200422
GET
/api/agentic/conversations/inbox-summary
Get Conversation Inbox Summary
get_conversation_inbox_summary_api_agentic_conversations_inbox_summary_get 4 params → 200422
GET
/api/agentic/conversations/{conversation_id}
Get Conversation
get_conversation_api_agentic_conversations__conversation_id__get 2 params → 200422
PATCH
/api/agentic/conversations/{conversation_id}
Update Conversation
update_conversation_api_agentic_conversations__conversation_id__patch 1 param body → 200422
DELETE
/api/agentic/conversations/{conversation_id}
Delete Conversation
delete_conversation_api_agentic_conversations__conversation_id__delete 1 param → 204422
PATCH
/api/agentic/conversations/{conversation_id}/messages/{message_id}/feedback
Update Message Feedback
update_message_feedback_api_agentic_conversations__conversation_id__messages__message_id__feedback_patch 2 params body → 200422
PATCH
/api/agentic/conversations/{conversation_id}/messages/{message_id}/tool-result
Update Message Tool Result
update_message_tool_result_api_agentic_conversations__conversation_id__messages__message_id__tool_result_patch 2 params body → 200422
POST
/api/agentic/conversations/{conversation_id}/mark-read
Mark Conversation Read
mark_conversation_read_api_agentic_conversations__conversation_id__mark_read_post 1 param → 200422

Schemas 26

The contract defines 26 schemas that model the data the API accepts and returns. The most detailed are AgentMessageResponse (17 properties), AgentConversationWithMessages (17 properties), PublicExecutionSummary (16 properties), PublicExecutionStep (15 properties). Each schema is shown below with its type and property counts.

HTTPValidationError
object
1 property
PublicExecutionStep
object
One bounded, presentation-ready item in a public execution snapshot. The optional result fields are public operational facts, never model reasoning or raw tool…
15 properties 5 required
AgentMessageResponse
object
Response schema for agent message. Includes: - Message content (role, content) - MCP tool execution history (toolcalls) - Cost tracking (tokensused) - Agentic…
17 properties 5 required
PublicExecutionSummary
object
A complete public snapshot of one assistant execution.
16 properties 3 required
Body_upload_attachments_api_agentic_conversations__conversation_id__attachments_post
object
1 property 1 required
AgentConversationWithMessages
object
Extended response schema that includes messages. Used for GET /conversations/{id} endpoint.
17 properties 9 required
ConversationAttachmentsResponse
object
1 property 1 required
PublicTerminalDisposition
object
Versioned, server-authored customer meaning for a terminal result.
3 properties 1 required
AgentConversationInboxSummaryResponse
object
3 properties 1 required
AgentConversationInboxPreview
object
5 properties 2 required
RuntimeKey
string
Canonical Markee engine versions. The serialized values predate the v1/v2 product vocabulary and remain stable so existing conversation rows and in-flight jobs…
AgentTraceStep
object
One step in the agent delegation trace (specialist analysis or manager synthesis).
6 properties 4 required
AgentConversationCreate
object
Request schema for creating a new agent conversation. Required fields: - organizationid: Organization context (for multi-tenant scoping) - companyprofileid: Co…
4 properties 2 required
ReferencedDocument
object
Document referenced in a chat response. Tracks which company documents were used to generate the response, allowing the UI to display file references.
4 properties 2 required
AgentConversationUpdate
object
Request schema for updating an existing conversation. All fields are optional - only provided fields will be updated.
2 properties
ResolvedWorkspaceAttributionResponse
object
Public source label with all private evidence locators removed.
8 properties 6 required
ResolvedCitationResponse
object
Safe public projection of one server-resolved citation.
11 properties 9 required
ToolResultUpdateRequest
object
Request schema for patching a tool call result with async job output.
13 properties
AgentConversationListResponse
object
Response schema for paginated conversation list. Used for GET /conversations endpoint.
5 properties 5 required
ValidationError
object
3 properties 3 required
EvidenceLineageClass
string
How a workspace field entered the evidence plane. Lineage is descriptive metadata, not a truth ranking. In particular, systemderived facts still require suppor…
AgentConversationResponse
object
Response schema for agent conversation. Uses mixins for consistent UUID serialization: - UUIDIdentifierMixin: Handles 'id' field - UserScopedMixin: Handles 'us…
14 properties 9 required
MarkReadResponse
object
Response schema for mark-read endpoint.
1 property 1 required
PublicDispositionKind
string
Closed customer meaning for one terminal assistant execution. Runtime lifecycle and internal stop causes remain separate. Unknown internal outcomes must be pro…
MessageFeedbackRequest
object
Request schema for updating message feedback.
1 property
ConversationAttachmentResponse
object
4 properties 4 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

pomo-agentic-conversations-api-openapi.yml Raw ↑

Other APIs Pomo publishes across the network.

Pomo Ab Groups API
Pomo Agent Jobs API
Pomo Agentic Chat API
Pomo Agentic Tasks API
Pomo Agentic Teams API
Pomo Agentic User API
Pomo AI Campaign API
Pomo AI Personas API
Pomo AI Policy API
Pomo AI Product Lab API
Pomo AI Testing API
Pomo Analytics API
Where this information came from

This is an independent, third-party profile of Pomo Agentic Conversations 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.