Create a session

POST

api

apps

{id}

sessions

Create a session

curl --request POST \
  --url https://api.judt.ai/api/apps/{id}/sessions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "title": "<string>",
  "model": "<string>",
  "message": "<string>"
}
'

import requests

url = "https://api.judt.ai/api/apps/{id}/sessions"

payload = {
    "title": "<string>",
    "model": "<string>",
    "message": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({title: '<string>', model: '<string>', message: '<string>'})
};

fetch('https://api.judt.ai/api/apps/{id}/sessions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.judt.ai/api/apps/{id}/sessions",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'title' => '<string>',
    'model' => '<string>',
    'message' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.judt.ai/api/apps/{id}/sessions"

	payload := strings.NewReader("{\n  \"title\": \"<string>\",\n  \"model\": \"<string>\",\n  \"message\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.judt.ai/api/apps/{id}/sessions")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"title\": \"<string>\",\n  \"model\": \"<string>\",\n  \"message\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.judt.ai/api/apps/{id}/sessions")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"title\": \"<string>\",\n  \"model\": \"<string>\",\n  \"message\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "id": "<string>",
  "app_id": "<string>",
  "title": "<string>",
  "model": "<string>",
  "status": "idle",
  "active_turn_id": "<string>",
  "last_sequence": 48,
  "usage": {
    "input_tokens": 12840,
    "output_tokens": 1260,
    "cache_read_tokens": 9600
  },
  "created_by": "<string>",
  "created_at": "2026-10-03T14:01:30.000Z",
  "updated_at": "2026-10-03T14:01:30.000Z"
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "request_id": "<string>",
    "detail": "<string>"
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "request_id": "<string>",
    "detail": "<string>"
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "request_id": "<string>",
    "detail": "<string>"
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "request_id": "<string>",
    "detail": "<string>"
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "request_id": "<string>",
    "detail": "<string>"
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "request_id": "<string>",
    "detail": "<string>"
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "request_id": "<string>",
    "detail": "<string>"
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "request_id": "<string>",
    "detail": "<string>"
  }
}

Authorizations

Authorization

string

header

required

An API token for one organization. You create and revoke tokens in the dashboard. A token scoped to one App can reach only that App, so give that kind of token to an agent. An organization-wide token can create a short-lived one with POST /api/tokens.

Headers

Idempotency-Key

string

A key that identifies this request for retries, up to 200 printable characters. A retry with the same key and input returns the first request's result instead of repeating the work. If you omit the key, the API generates one and returns it in the Idempotency-Key response header.

Required string length: 1 - 200

Path Parameters

string

required

A unique ID that starts with app_.

Pattern: ^app_[0-9A-Za-z]{24}$

Example:

"app_Zj7XhMgplmTJcp5Dk4vcYuk0"

Body

application/json

title

string

The session's title. Default: a summary of the first message.

Required string length: 1 - 200

model

string

The session's default model. Default: auto.

Maximum string length: 100

message

string

A message that starts the session's first turn.

Required string length: 1 - 32768

effort

enum<string>

The effort for the first turn. Requires message.

Available options:

low,

medium,

high,

xhigh,

max

Response

The new session.

string

required

The session's ID, which starts with ses_.

app_id

string

required

The ID of the App that the session belongs to.

title

string

required

The session's title.

model

string

required

The default model for the session's turns: auto or a model ID.

status

enum<string>

required

The session's state:

idle: no turn is running or queued.
running: a turn is running or queued.
waiting: the active turn needs input from a person. The turn's input_request field describes the input.

Available options:

idle,

running,

waiting

active_turn_id

string | null

required

The ID of the running or waiting turn, or null if there isn't one.

last_sequence

integer

required

The sequence of the session's newest event. A transcript that includes this event is up to date.

Required range: x >= 0

Example:

48

usage

object

required

The tokens used by all of the session's turns.

Show child attributes

created_by

string | null

required

The ID of the user who created the session, or null if that user deleted their account.

created_at

string<date-time>

required

When the session was created.

Example:

"2026-10-03T14:01:30.000Z"

updated_at

string<date-time>

required

When the session last changed. Sessions are listed by this time.

Example:

"2026-10-03T14:01:30.000Z"

Create a session

curl --request POST \
  --url https://api.judt.ai/api/apps/{id}/sessions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "title": "<string>",
  "model": "<string>",
  "message": "<string>"
}
'

import requests

url = "https://api.judt.ai/api/apps/{id}/sessions"

payload = {
    "title": "<string>",
    "model": "<string>",
    "message": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({title: '<string>', model: '<string>', message: '<string>'})
};

fetch('https://api.judt.ai/api/apps/{id}/sessions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.judt.ai/api/apps/{id}/sessions",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'title' => '<string>',
    'model' => '<string>',
    'message' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.judt.ai/api/apps/{id}/sessions"

	payload := strings.NewReader("{\n  \"title\": \"<string>\",\n  \"model\": \"<string>\",\n  \"message\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.judt.ai/api/apps/{id}/sessions")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"title\": \"<string>\",\n  \"model\": \"<string>\",\n  \"message\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.judt.ai/api/apps/{id}/sessions")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"title\": \"<string>\",\n  \"model\": \"<string>\",\n  \"message\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "id": "<string>",
  "app_id": "<string>",
  "title": "<string>",
  "model": "<string>",
  "status": "idle",
  "active_turn_id": "<string>",
  "last_sequence": 48,
  "usage": {
    "input_tokens": 12840,
    "output_tokens": 1260,
    "cache_read_tokens": 9600
  },
  "created_by": "<string>",
  "created_at": "2026-10-03T14:01:30.000Z",
  "updated_at": "2026-10-03T14:01:30.000Z"
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "request_id": "<string>",
    "detail": "<string>"
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "request_id": "<string>",
    "detail": "<string>"
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "request_id": "<string>",
    "detail": "<string>"
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "request_id": "<string>",
    "detail": "<string>"
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "request_id": "<string>",
    "detail": "<string>"
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "request_id": "<string>",
    "detail": "<string>"
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "request_id": "<string>",
    "detail": "<string>"
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "request_id": "<string>",
    "detail": "<string>"
  }
}

Overview

Account

Apps

Tokens

Secrets

Files

Sandbox

Deployments

Monitoring

Templates

Agents

Feedback

Create a session

Authorizations

Headers

Path Parameters

Body

Response