Skip to main content
POST
Create endpoint
Create an HTTP endpoint the assistant can call from a scenario http tool. Required request fields:
  • name (unique per user)
  • url
Optional:
  • headers — JSON object. Put {{secret.*}} placeholders here, not in body.
  • body — JSON object. Use {{runtime.*}} / {{llm.*}} templates as needed.
Akapulu Labs invokes your URL with POST and a JSON body. Secrets themselves are still created in the dashboard. See Endpoints and Templates and variables.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
name
string
required
url
string
required
headers
object

Request headers. Secrets belong here as {{secret.*}} placeholders.

body
object

JSON body templates. Cannot use {{secret.*}}; put secrets in headers.

Response

Endpoint created successfully

status
string
required
id
string<uuid>
required
redirect_url
string

Dashboard path. Ignore for API clients.