Search
K
Evaluation Sessions

Evaluation Sessions

1.0.0OAS 3.0

Schedules individual and group evaluation sessions, manages confirmations
and cancellations, and collects feedback after the session.

The API supports two models: fixed sessions, to which you invite
requesters, and availability windows, from which requesters pick their
own slot. Both can be mixed per agent.

API Base URL
  • Server 1:https://api.nexora.example/v1

    Production

  • Server 2:https://sandbox.api.nexora.example/v1

    Sandbox

Security
apiKey (apiKey)

Every call carries an API key in the apikey header. You generate the
key in the Nexora AI portal under “My Apps”; it’s shown exactly once.

Each key has the scopes it’s allowed to use attached to it. If one is
missing, the API responds with 403 and code: "scope_missing"; the
missing scope is in details[].field.

Additional Information
Contact API Support - Nexora AI (api-support@nexora.example)

For demonstration purposes only License

Sessions

List evaluation sessions

get

Query Parameters

agent_idstring

Example:agt_8f2c1a

fromstring(date-time)
tostring(date-time)
statusstring

Allowed values:scheduledconfirmedcompletedcancelled

Example:confirmed

Response

application/json

Results list

dataarray
Show Child Parameters
pageobject

Cursor-based pagination.

Show Child Parameters
get/sessions
 
application/json

Create an evaluation session

post

Body

application/json

SessionInput

agent_idstringrequired

Example:agt_8f2c1a

typestringrequired

Allowed values:individualgroupvirtual

Example:individual

startstring(date-time)required

Example:2026-09-03T16:00:00+02:00

duration_minutesinteger

Default:30

>= 10<= 240

slotsinteger

Only evaluated when type: group.

>= 1

Example:12

location_or_linkstring

<= 200 characters

Example:https://meet.nexora.example/eval-8f2c1a

notestring

<= 500 characters

Example:Please come with concrete workflows you want the agent to try.

Response

application/json

Created

Session

agent_idstringrequired

Example:agt_8f2c1a

typestringrequired

Allowed values:individualgroupvirtual

Example:individual

startstring(date-time)required

Example:2026-09-03T16:00:00+02:00

duration_minutesinteger

Default:30

>= 10<= 240

slotsinteger

Only evaluated when type: group.

>= 1

Example:12

location_or_linkstring

<= 200 characters

Example:https://meet.nexora.example/eval-8f2c1a

notestring

<= 500 characters

Example:Please come with concrete workflows you want the agent to try.

idstring

Example:sess_9a44

statusstring

Allowed values:scheduledconfirmedcompletedcancelled

Example:confirmed

confirmations_countinteger

Example:8

waitlist_countinteger

Example:2

created_atstring(date-time)

Example:2026-08-20T11:02:10Z

post/sessions

Body

{ "agent_id": "agt_8f2c1a", "type": "individual", "start": "2026-09-03T16:00:00+02:00", "duration_minutes": 30, "location_or_link": "https://meet.nexora.example/eval-8f2c1a" }
 
application/json

Retrieve an evaluation session

get

Path Parameters

sessionIdstringrequired

Example:sess_9a44

Response

application/json

Session

Session

agent_idstringrequired

Example:agt_8f2c1a

typestringrequired

Allowed values:individualgroupvirtual

Example:individual

startstring(date-time)required

Example:2026-09-03T16:00:00+02:00

duration_minutesinteger

Default:30

>= 10<= 240

slotsinteger

Only evaluated when type: group.

>= 1

Example:12

location_or_linkstring

<= 200 characters

Example:https://meet.nexora.example/eval-8f2c1a

notestring

<= 500 characters

Example:Please come with concrete workflows you want the agent to try.

idstring

Example:sess_9a44

statusstring

Allowed values:scheduledconfirmedcompletedcancelled

Example:confirmed

confirmations_countinteger

Example:8

waitlist_countinteger

Example:2

created_atstring(date-time)

Example:2026-08-20T11:02:10Z

get/sessions/{sessionId}
 
application/json