Modify session
Modifies the configuration of a session that you created.
Authorizations
Headers
The trace ID you set in your system to trace this request. It can be up to 128 characters in length. If the request fails, you can provide it to the Powerdrill team to help with troubleshooting.
Path Parameters
The ID of the session you want to modify.
To check sessions existing in your project, call GET /v2/team/sessions.
Body
The session name, which can be up to 128 characters in length. If it exceeds this limit, it will be truncated.
Your user ID, which uniquely identifies you within your team. To obtain your ID:
- If you're the team admin, refer to Check user information.
- If you're a system or virtual user, ask your team admin to check your user ID by referring to Check user information.
The language in which the output is generated. For example, if set to EN
, the output will be in English. If not specified, the default setting AUTO
will be used, which allows Powerdrill Enterprise to automatically detect the appropriate language for the output based on your question. Possible values are:
AUTO
: adaptive recognitionEN
: EnglishES
: SpanishAR
: ArabicPT
: PortugueseID
: IndonesianJA
: JapaneseRU
: RussianHI
: HindiFR
: FrenchDE
: GermanVI
: VietnameseTR
: TurkishPL
: PolishIT
: ItalianKO
: KoreanZH-CN
: Simplified ChineseZH-TW
: Traditional Chinese
AUTO
, EN
, ES
, AR
, PT
, ID
, JA
, RU
, HI
, FR
, DE
, VI
, TR
, PL
, IT
, KO
, ZH-CN
, ZH-TW
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.
If not specified, the default setting AUTO
will be used. However, if your intent is clearly data analysis, we recommend specifying the value as DATA_ANALYSIS. This helps Powerdrill skip the intention detection step, enabling faster question processing.
AUTO
, DATA_ANALYTICS
The maximum number of recent jobs retained as context for the next job, with a value range of 0
to 10
. The default value is 10
. If set to 0
, jobs will be run without any context from previous jobs.
Response
Status code. 0 indicates that the operation is successful. Otherwise, the operation fails. For error troubleshooting, refer to Error Codes.
Null is returned when the operation is successful.