POST
/
v1
/
team
/
sessions

Authorizations

x-pd-api-key
string
header
required

Headers

x-pd-external-trace-id
string

The external trace ID. The length ranges from 0 to 128 characters.

Body

application/json
title
string
required

The session name, which can be up to 128 characters in length. If it exceeds this limit, it will be truncated.

userId
string
required

Your user ID.

How to obtain your user ID: Sign in to Powerdrill Enterprise, click Users in the top navigation bar, and find your user ID in the list of users.

agentId
string
default:
DATA_ANALYSIS_AGENT

The ID of the agent. You don't need to specify it or set it to DATA_ANALYSIS_AGENT.

jobMode
enum<string>
default:
AUTO

Job mode. Possible values are:

  • AUTO: Powerdrill automatically detects your intent and selects the appropriate job mode from data analysis and information retrieval.
  • DATA_ANALYTICS: Powerdrill focuses specifically on data analysis.
Available options:
AUTO,
DATA_ANALYTICS
languageType
enum<string>
default:
AUTO

The language in which the output is generated. Possible values are:

  • AUTO: adaptive recognition
  • EN: English
  • ES: Spanish
  • AR: Arabic
  • PT: Portuguese
  • ID: Indonesian
  • JA: Japanese
  • RU: Russian
  • HI: Hindi
  • FR: French
  • DE: German
  • VI: Vietnamese
  • TR: Turkish
  • PL: Polish
  • IT: Italian
  • KO: Korean
  • ZH-CN: Simplified Chinese
  • ZH-TW: Traditional Chinese
Available options:
AUTO,
EN,
ES,
AR,
PT,
ID,
JA,
RU,
HI,
FR,
DE,
VI,
TR,
PL,
IT,
KO,
ZH-CN,
ZH-TW
maxMessagesInContext
integer
default:
10

The maximum number of messages retained per session, with a value range of 0 to 10. The default is 10.

You can set it to 0 if you don't want your answer is to contain any context of job history.

Response

200 - application/json
code
integer
required

Status code. 0 indicates that the operation is successful. Otherwise, the operation fails. Possible error codes include:

  • 100: Bad request.
  • 201: Request frequency limit.
  • 9999: Internal error.
  • 100001: Invalid operation.
data
object
required

The returned data object.