Skip to content

sessions.sessionConfessions

GET
/v1/sessions/{sessionId}/confessions
curl --request GET \
--url https://example.com/v1/sessions/example/confessions \
--header 'Authorization: Bearer <token>'

Lists what the Bot said with confide in this Session, and the answers that it got. The Bot uses it to talk about how its work goes. See the client guide before you show it to people.

sessionId
required
string
>= 1 characters

Success

Media typeapplication/json
Array<object>
object
id
required
string
session
required
string
turn
required
string
text
required
string
reply
required
string
at
required
number

Example generated

[
{
"id": "example",
"session": "example",
"turn": "example",
"text": "example",
"reply": "example",
"at": 1
}
]

SessionInvalidRecord | SessionModelInvalid | OrganizationRequired

Media typeapplication/json
Any of:
object
_tag
required
string
Allowed values: SessionInvalidRecord
message
required
string

Example

{
"_tag": "SessionInvalidRecord"
}

AuthenticationRequired

Media typeapplication/json
object
_tag
required
string
Allowed values: AuthenticationRequired

Example

{
"_tag": "AuthenticationRequired"
}

PermissionDenied | MembershipRequired | ForbiddenOrigin

Media typeapplication/json
Any of:
object
_tag
required
string
Allowed values: PermissionDenied
permission
required
string
Allowed values: responses.run sessions.read sessions.write requests.resolve bots.read bots.write bots.delegate bots.share triggers.read triggers.write channels.read channels.write channels.use channel_identities.read channel_identities.write connections.read connections.write apps.use apps.publish computers.read computers.write computers.use computer_providers.read computer_providers.write computer_providers.use models.use tokens.read tokens.write organization.read organization.write roles.write model_providers.read model_providers.write sso.read sso.write platform.read platform.write members.read members.write audit_logs.read usage.read budgets.read budgets.write
resource
required
string

Example

{
"_tag": "PermissionDenied",
"permission": "responses.run"
}

SessionNotFound

Media typeapplication/json
object
_tag
required
string
Allowed values: SessionNotFound
session
required
string

Example

{
"_tag": "SessionNotFound"
}

SessionBusy | SessionConflict

Media typeapplication/json
Any of:
object
_tag
required
string
Allowed values: SessionBusy
session
required
string

Example

{
"_tag": "SessionBusy"
}

RateLimited

Media typeapplication/json
object
_tag
required
string
Allowed values: RateLimited
retryAfterSeconds
required
integer
>= -9007199254740991 <= 9007199254740991

Example

{
"_tag": "RateLimited"
}

SessionStorageUnavailable | AuthorizationUnavailable | AuthenticationUnavailable

Media typeapplication/json
Any of:
object
_tag
required
string
Allowed values: SessionStorageUnavailable

Example

{
"_tag": "SessionStorageUnavailable"
}