Typebot
Get published bot
Typebot
Get published bot
GET
/
v1
/
typebots
/
{typebotId}
/
publishedTypebot
Authorization
string
*
Bearer
Authorization
Required
string
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
typebotId
string
*
typebotId
Required
string
migrateToLatestVersion
boolean
migrateToLatestVersion
boolean
If enabled, the typebot will be converted to the latest schema version
curl --request GET \
--url https://app.typebot.io/api/v1/typebots/{typebotId}/publishedTypebot \
--header 'Authorization: Bearer <token>'
{
"publishedTypebot": {
"id": "<string>",
"version": "6",
"createdAt": "<string>",
"updatedAt": "<string>",
"typebotId": "<string>",
"groups": [
{
"id": "<string>",
"title": "<string>",
"graphCoordinates": {
"x": 123,
"y": 123
},
"blocks": [
{
"id": "<string>",
"outgoingEdgeId": "<string>",
"type": "text",
"content": {
"html": "<string>",
"richText": [
"<any>"
],
"plainText": "<string>"
}
}
]
}
],
"events": [
{
"id": "<string>",
"outgoingEdgeId": "<string>",
"graphCoordinates": {
"x": 123,
"y": 123
},
"type": "start"
}
],
"edges": [
{
"id": "<string>",
"from": {
"blockId": "<string>",
"itemId": "<string>"
},
"to": {
"groupId": "<string>",
"blockId": "<string>"
}
}
],
"variables": [
{
"id": "<string>",
"name": "<string>",
"isSessionVariable": true,
"value": "<string>"
}
],
"theme": {
"general": {
"font": "<string>",
"background": {
"type": "Color",
"content": "<string>"
},
"progressBar": {
"isEnabled": true,
"color": "<string>",
"backgroundColor": "<string>",
"placement": "Top",
"thickness": 123,
"position": "fixed"
}
},
"chat": {
"container": {
"maxWidth": "<string>",
"maxHeight": "<string>",
"backgroundColor": "<string>",
"color": "<string>",
"blur": 123,
"opacity": 0.5,
"shadow": "none",
"border": {
"thickness": 123,
"color": "<string>",
"roundeness": "none",
"customRoundeness": 123,
"opacity": 0.5
}
},
"hostAvatar": {
"isEnabled": true,
"url": "<string>"
},
"guestAvatar": {
"isEnabled": true,
"url": "<string>"
},
"hostBubbles": {
"backgroundColor": "<string>",
"color": "<string>",
"blur": 123,
"opacity": 0.5,
"shadow": "none",
"border": {
"thickness": 123,
"color": "<string>",
"roundeness": "none",
"customRoundeness": 123,
"opacity": 0.5
}
},
"guestBubbles": {
"backgroundColor": "<string>",
"color": "<string>",
"blur": 123,
"opacity": 0.5,
"shadow": "none",
"border": {
"thickness": 123,
"color": "<string>",
"roundeness": "none",
"customRoundeness": 123,
"opacity": 0.5
}
},
"buttons": {
"backgroundColor": "<string>",
"color": "<string>",
"blur": 123,
"opacity": 0.5,
"shadow": "none",
"border": {
"thickness": 123,
"color": "<string>",
"roundeness": "none",
"customRoundeness": 123,
"opacity": 0.5
}
},
"inputs": {
"backgroundColor": "<string>",
"color": "<string>",
"blur": 123,
"opacity": 0.5,
"shadow": "none",
"border": {
"thickness": 123,
"color": "<string>",
"roundeness": "none",
"customRoundeness": 123,
"opacity": 0.5
},
"placeholderColor": "<string>"
},
"roundness": "none"
},
"customCss": "<string>"
},
"settings": {
"general": {
"isBrandingEnabled": true,
"isTypingEmulationEnabled": true,
"isInputPrefillEnabled": true,
"isHideQueryParamsEnabled": true,
"isNewResultOnRefreshEnabled": true,
"rememberUser": {
"isEnabled": true,
"storage": "session"
}
},
"typingEmulation": {
"enabled": true,
"speed": 123,
"maxDelay": 123,
"delayBetweenBubbles": 2.5,
"isDisabledOnFirstMessage": true
},
"metadata": {
"title": "<string>",
"description": "<string>",
"imageUrl": "<string>",
"favIconUrl": "<string>",
"customHeadCode": "<string>",
"googleTagManagerId": "<string>"
},
"whatsApp": {
"isEnabled": true,
"startCondition": {
"logicalOperator": "OR",
"comparisons": [
{
"id": "<string>",
"comparisonOperator": "Equal to",
"value": "<string>"
}
]
},
"sessionExpiryTimeout": 24.005
},
"publicShare": {
"isEnabled": true
},
"security": {
"allowedOrigins": [
"<string>"
]
}
}
},
"version": "3"
}
Authorizations
Authorization
string
headerrequiredBearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Path Parameters
typebotId
string
requiredQuery Parameters
migrateToLatestVersion
boolean
default: falseIf enabled, the typebot will be converted to the latest schema version
Response
200 - application/json
publishedTypebot
object
requiredpublishedTypebot.id
string
requiredpublishedTypebot.version
enum<string>
requiredAvailable options:
6
publishedTypebot.createdAt
string
requiredpublishedTypebot.updatedAt
string
requiredpublishedTypebot.typebotId
string
requiredpublishedTypebot.groups
object[]
requiredpublishedTypebot.groups.id
string
requiredpublishedTypebot.groups.title
string
requiredpublishedTypebot.groups.graphCoordinates
object
requiredpublishedTypebot.groups.graphCoordinates.x
number
requiredpublishedTypebot.groups.graphCoordinates.y
number
requiredpublishedTypebot.groups.blocks
object[]
requiredpublishedTypebot.groups.blocks.id
string
requiredpublishedTypebot.groups.blocks.outgoingEdgeId
string
publishedTypebot.groups.blocks.type
enum<string>
requiredAvailable options:
text
publishedTypebot.groups.blocks.content
object
publishedTypebot.groups.blocks.content.html
string
publishedTypebot.groups.blocks.content.richText
any[]
publishedTypebot.groups.blocks.content.plainText
string
publishedTypebot.events
object[]
requiredpublishedTypebot.events.id
string
requiredpublishedTypebot.events.outgoingEdgeId
string
publishedTypebot.events.graphCoordinates
object
requiredpublishedTypebot.events.graphCoordinates.x
number
requiredpublishedTypebot.events.graphCoordinates.y
number
requiredpublishedTypebot.events.type
enum<string>
requiredAvailable options:
start
publishedTypebot.edges
object[]
requiredpublishedTypebot.edges.id
string
requiredpublishedTypebot.edges.from
object
requiredpublishedTypebot.edges.from.blockId
string
requiredpublishedTypebot.edges.from.itemId
string
publishedTypebot.edges.to
object
requiredpublishedTypebot.edges.to.groupId
string
requiredpublishedTypebot.edges.to.blockId
string
publishedTypebot.variables
object[]
requiredpublishedTypebot.variables.id
string
requiredpublishedTypebot.variables.name
string
requiredpublishedTypebot.variables.isSessionVariable
boolean
publishedTypebot.variables.value
publishedTypebot.theme
object
requiredpublishedTypebot.theme.general
object
publishedTypebot.theme.general.font
publishedTypebot.theme.general.background
object
publishedTypebot.theme.general.background.type
enum<string>
Available options:
Color
, Image
, None
publishedTypebot.theme.general.background.content
string
publishedTypebot.theme.general.progressBar
object
publishedTypebot.theme.general.progressBar.isEnabled
boolean
publishedTypebot.theme.general.progressBar.color
string
publishedTypebot.theme.general.progressBar.backgroundColor
string
publishedTypebot.theme.general.progressBar.placement
enum<string>
Available options:
Top
, Bottom
publishedTypebot.theme.general.progressBar.thickness
number
publishedTypebot.theme.general.progressBar.position
enum<string>
Available options:
fixed
, absolute
publishedTypebot.theme.chat
object
publishedTypebot.theme.chat.container
object
publishedTypebot.theme.chat.container.maxWidth
string
publishedTypebot.theme.chat.container.maxHeight
string
publishedTypebot.theme.chat.container.backgroundColor
string
publishedTypebot.theme.chat.container.color
string
publishedTypebot.theme.chat.container.blur
number
publishedTypebot.theme.chat.container.opacity
number
publishedTypebot.theme.chat.container.shadow
enum<string>
Available options:
none
, sm
, md
, lg
, xl
, 2xl
publishedTypebot.theme.chat.container.border
object
publishedTypebot.theme.chat.container.border.thickness
number
publishedTypebot.theme.chat.container.border.color
string
publishedTypebot.theme.chat.container.border.roundeness
enum<string>
Available options:
none
, medium
, large
, custom
publishedTypebot.theme.chat.container.border.customRoundeness
number
publishedTypebot.theme.chat.container.border.opacity
number
publishedTypebot.theme.chat.hostAvatar
object
publishedTypebot.theme.chat.hostAvatar.isEnabled
boolean
publishedTypebot.theme.chat.hostAvatar.url
string
publishedTypebot.theme.chat.guestAvatar
object
publishedTypebot.theme.chat.guestAvatar.isEnabled
boolean
publishedTypebot.theme.chat.guestAvatar.url
string
publishedTypebot.theme.chat.hostBubbles
object
publishedTypebot.theme.chat.hostBubbles.backgroundColor
string
publishedTypebot.theme.chat.hostBubbles.color
string
publishedTypebot.theme.chat.hostBubbles.blur
number
publishedTypebot.theme.chat.hostBubbles.opacity
number
publishedTypebot.theme.chat.hostBubbles.shadow
enum<string>
Available options:
none
, sm
, md
, lg
, xl
, 2xl
publishedTypebot.theme.chat.hostBubbles.border
object
publishedTypebot.theme.chat.hostBubbles.border.thickness
number
publishedTypebot.theme.chat.hostBubbles.border.color
string
publishedTypebot.theme.chat.hostBubbles.border.roundeness
enum<string>
Available options:
none
, medium
, large
, custom
publishedTypebot.theme.chat.hostBubbles.border.customRoundeness
number
publishedTypebot.theme.chat.hostBubbles.border.opacity
number
publishedTypebot.theme.chat.guestBubbles
object
publishedTypebot.theme.chat.guestBubbles.backgroundColor
string
publishedTypebot.theme.chat.guestBubbles.color
string
publishedTypebot.theme.chat.guestBubbles.blur
number
publishedTypebot.theme.chat.guestBubbles.opacity
number
publishedTypebot.theme.chat.guestBubbles.shadow
enum<string>
Available options:
none
, sm
, md
, lg
, xl
, 2xl
publishedTypebot.theme.chat.guestBubbles.border
object
publishedTypebot.theme.chat.guestBubbles.border.thickness
number
publishedTypebot.theme.chat.guestBubbles.border.color
string
publishedTypebot.theme.chat.guestBubbles.border.roundeness
enum<string>
Available options:
none
, medium
, large
, custom
publishedTypebot.theme.chat.guestBubbles.border.customRoundeness
number
publishedTypebot.theme.chat.guestBubbles.border.opacity
number
publishedTypebot.theme.chat.buttons
object
publishedTypebot.theme.chat.buttons.backgroundColor
string
publishedTypebot.theme.chat.buttons.color
string
publishedTypebot.theme.chat.buttons.blur
number
publishedTypebot.theme.chat.buttons.opacity
number
publishedTypebot.theme.chat.buttons.shadow
enum<string>
Available options:
none
, sm
, md
, lg
, xl
, 2xl
publishedTypebot.theme.chat.buttons.border
object
publishedTypebot.theme.chat.buttons.border.thickness
number
publishedTypebot.theme.chat.buttons.border.color
string
publishedTypebot.theme.chat.buttons.border.roundeness
enum<string>
Available options:
none
, medium
, large
, custom
publishedTypebot.theme.chat.buttons.border.customRoundeness
number
publishedTypebot.theme.chat.buttons.border.opacity
number
publishedTypebot.theme.chat.inputs
object
publishedTypebot.theme.chat.inputs.backgroundColor
string
publishedTypebot.theme.chat.inputs.color
string
publishedTypebot.theme.chat.inputs.blur
number
publishedTypebot.theme.chat.inputs.opacity
number
publishedTypebot.theme.chat.inputs.shadow
enum<string>
Available options:
none
, sm
, md
, lg
, xl
, 2xl
publishedTypebot.theme.chat.inputs.border
object
publishedTypebot.theme.chat.inputs.border.thickness
number
publishedTypebot.theme.chat.inputs.border.color
string
publishedTypebot.theme.chat.inputs.border.roundeness
enum<string>
Available options:
none
, medium
, large
, custom
publishedTypebot.theme.chat.inputs.border.customRoundeness
number
publishedTypebot.theme.chat.inputs.border.opacity
number
publishedTypebot.theme.chat.inputs.placeholderColor
string
publishedTypebot.theme.chat.roundness
enum<string>
Deprecated, use container.border.roundeness
instead
Available options:
none
, medium
, large
publishedTypebot.theme.customCss
string
publishedTypebot.settings
object
requiredpublishedTypebot.settings.general
object
publishedTypebot.settings.general.isBrandingEnabled
boolean
publishedTypebot.settings.general.isTypingEmulationEnabled
boolean
publishedTypebot.settings.general.isInputPrefillEnabled
boolean
publishedTypebot.settings.general.isHideQueryParamsEnabled
boolean
publishedTypebot.settings.general.isNewResultOnRefreshEnabled
boolean
publishedTypebot.settings.general.rememberUser
object
publishedTypebot.settings.general.rememberUser.isEnabled
boolean
publishedTypebot.settings.general.rememberUser.storage
enum<string>
Available options:
session
, local
publishedTypebot.settings.typingEmulation
object
publishedTypebot.settings.typingEmulation.enabled
boolean
publishedTypebot.settings.typingEmulation.speed
number
publishedTypebot.settings.typingEmulation.maxDelay
number
publishedTypebot.settings.typingEmulation.delayBetweenBubbles
number
publishedTypebot.settings.typingEmulation.isDisabledOnFirstMessage
boolean
publishedTypebot.settings.metadata
object
publishedTypebot.settings.metadata.title
string
publishedTypebot.settings.metadata.description
string
publishedTypebot.settings.metadata.imageUrl
string
publishedTypebot.settings.metadata.favIconUrl
string
publishedTypebot.settings.metadata.customHeadCode
string
publishedTypebot.settings.metadata.googleTagManagerId
string
publishedTypebot.settings.whatsApp
object
publishedTypebot.settings.whatsApp.isEnabled
boolean
publishedTypebot.settings.whatsApp.startCondition
object
publishedTypebot.settings.whatsApp.startCondition.logicalOperator
enum<string>
requiredAvailable options:
OR
, AND
publishedTypebot.settings.whatsApp.startCondition.comparisons
object[]
requiredpublishedTypebot.settings.whatsApp.startCondition.comparisons.id
string
requiredpublishedTypebot.settings.whatsApp.startCondition.comparisons.comparisonOperator
enum<string>
Available options:
Equal to
, Not equal
, Contains
, Does not contain
, Greater than
, Less than
, Is set
, Is empty
, Starts with
, Ends with
, Matches regex
, Does not match regex
publishedTypebot.settings.whatsApp.startCondition.comparisons.value
string
publishedTypebot.settings.whatsApp.sessionExpiryTimeout
number
Expiration delay in hours after latest interaction
publishedTypebot.settings.publicShare
object
publishedTypebot.settings.publicShare.isEnabled
boolean
publishedTypebot.settings.security
object
publishedTypebot.settings.security.allowedOrigins
string[]
version
enum<string>
Provides the version the published bot was migrated from if migrateToLatestVersion
is set to true
.
Available options:
3
, 4
, 5
, 6
curl --request GET \
--url https://app.typebot.io/api/v1/typebots/{typebotId}/publishedTypebot \
--header 'Authorization: Bearer <token>'
{
"publishedTypebot": {
"id": "<string>",
"version": "6",
"createdAt": "<string>",
"updatedAt": "<string>",
"typebotId": "<string>",
"groups": [
{
"id": "<string>",
"title": "<string>",
"graphCoordinates": {
"x": 123,
"y": 123
},
"blocks": [
{
"id": "<string>",
"outgoingEdgeId": "<string>",
"type": "text",
"content": {
"html": "<string>",
"richText": [
"<any>"
],
"plainText": "<string>"
}
}
]
}
],
"events": [
{
"id": "<string>",
"outgoingEdgeId": "<string>",
"graphCoordinates": {
"x": 123,
"y": 123
},
"type": "start"
}
],
"edges": [
{
"id": "<string>",
"from": {
"blockId": "<string>",
"itemId": "<string>"
},
"to": {
"groupId": "<string>",
"blockId": "<string>"
}
}
],
"variables": [
{
"id": "<string>",
"name": "<string>",
"isSessionVariable": true,
"value": "<string>"
}
],
"theme": {
"general": {
"font": "<string>",
"background": {
"type": "Color",
"content": "<string>"
},
"progressBar": {
"isEnabled": true,
"color": "<string>",
"backgroundColor": "<string>",
"placement": "Top",
"thickness": 123,
"position": "fixed"
}
},
"chat": {
"container": {
"maxWidth": "<string>",
"maxHeight": "<string>",
"backgroundColor": "<string>",
"color": "<string>",
"blur": 123,
"opacity": 0.5,
"shadow": "none",
"border": {
"thickness": 123,
"color": "<string>",
"roundeness": "none",
"customRoundeness": 123,
"opacity": 0.5
}
},
"hostAvatar": {
"isEnabled": true,
"url": "<string>"
},
"guestAvatar": {
"isEnabled": true,
"url": "<string>"
},
"hostBubbles": {
"backgroundColor": "<string>",
"color": "<string>",
"blur": 123,
"opacity": 0.5,
"shadow": "none",
"border": {
"thickness": 123,
"color": "<string>",
"roundeness": "none",
"customRoundeness": 123,
"opacity": 0.5
}
},
"guestBubbles": {
"backgroundColor": "<string>",
"color": "<string>",
"blur": 123,
"opacity": 0.5,
"shadow": "none",
"border": {
"thickness": 123,
"color": "<string>",
"roundeness": "none",
"customRoundeness": 123,
"opacity": 0.5
}
},
"buttons": {
"backgroundColor": "<string>",
"color": "<string>",
"blur": 123,
"opacity": 0.5,
"shadow": "none",
"border": {
"thickness": 123,
"color": "<string>",
"roundeness": "none",
"customRoundeness": 123,
"opacity": 0.5
}
},
"inputs": {
"backgroundColor": "<string>",
"color": "<string>",
"blur": 123,
"opacity": 0.5,
"shadow": "none",
"border": {
"thickness": 123,
"color": "<string>",
"roundeness": "none",
"customRoundeness": 123,
"opacity": 0.5
},
"placeholderColor": "<string>"
},
"roundness": "none"
},
"customCss": "<string>"
},
"settings": {
"general": {
"isBrandingEnabled": true,
"isTypingEmulationEnabled": true,
"isInputPrefillEnabled": true,
"isHideQueryParamsEnabled": true,
"isNewResultOnRefreshEnabled": true,
"rememberUser": {
"isEnabled": true,
"storage": "session"
}
},
"typingEmulation": {
"enabled": true,
"speed": 123,
"maxDelay": 123,
"delayBetweenBubbles": 2.5,
"isDisabledOnFirstMessage": true
},
"metadata": {
"title": "<string>",
"description": "<string>",
"imageUrl": "<string>",
"favIconUrl": "<string>",
"customHeadCode": "<string>",
"googleTagManagerId": "<string>"
},
"whatsApp": {
"isEnabled": true,
"startCondition": {
"logicalOperator": "OR",
"comparisons": [
{
"id": "<string>",
"comparisonOperator": "Equal to",
"value": "<string>"
}
]
},
"sessionExpiryTimeout": 24.005
},
"publicShare": {
"isEnabled": true
},
"security": {
"allowedOrigins": [
"<string>"
]
}
}
},
"version": "3"
}