overlay: 1.0.0
info:
title: Chatley AI Developer API enhancements
version: '2026-11-03'
extends: ../openapi/_ae-authored/chatley-ai-openapi-generated.yml
x-provenance:
method: derived
generated: '2026-11-03'
source:
- https://docs.chatley.ai/api/chat-sessions.md
- https://docs.chatley.ai/api/chat-messages.md
actions:
- target: $.paths['/api/developer/chat/sessions'].post
update:
operationId: post_api_developer_chat_sessions
summary: Create a chat session
tags:
- Chat
description: Start a conversation with one of your agents. Reuse the returned sessionId for every message in that conversation
so the agent keeps earlier turns in context.
x-source: https://docs.chatley.ai/api/chat-sessions.md
- target: $.paths['/api/developer/chat/messages'].post
update:
summary: Send a message
tags:
- Chat
description: 'Send one message into an existing session (agentId, sessionId, message all required) and return the agent
reply. Documented errors: 400 missing fields or agent chat not enabled, 401/403 API key problems, 404 Agent not found,
500 retry.'
x-source: https://docs.chatley.ai/api/chat-messages.md
- target: $.tags
update:
- name: Chat
description: Chat with your Chatley agents from your own application.
- target: $.components.securitySchemes.bearer
update:
description: 'Chatley API key sent as Authorization: Bearer $CHATLEY_API_KEY.'
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
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.