Create Case Input

curl --request POST \
  --url https://connect.penbox.io/v1/cases/{id}/inputs \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "context": "Transcript of a call with the client on 2026-09-01",
  "content": "Client: the water damage happened on 30 August, my policy number is POL-123…",
  "data": {
    "policy_number": "POL-123"
  },
  "options": {
    "mode": "suggest"
  }
}
'

import requests

url = "https://connect.penbox.io/v1/cases/{id}/inputs"

payload = {
    "context": "Transcript of a call with the client on 2026-09-01",
    "content": "Client: the water damage happened on 30 August, my policy number is POL-123…",
    "data": { "policy_number": "POL-123" },
    "options": { "mode": "suggest" }
}
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({
    context: 'Transcript of a call with the client on 2026-09-01',
    content: 'Client: the water damage happened on 30 August, my policy number is POL-123…',
    data: {policy_number: 'POL-123'},
    options: {mode: 'suggest'}
  })
};

fetch('https://connect.penbox.io/v1/cases/{id}/inputs', 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://connect.penbox.io/v1/cases/{id}/inputs",
  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([
    'context' => 'Transcript of a call with the client on 2026-09-01',
    'content' => 'Client: the water damage happened on 30 August, my policy number is POL-123…',
    'data' => [
        'policy_number' => 'POL-123'
    ],
    'options' => [
        'mode' => 'suggest'
    ]
  ]),
  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://connect.penbox.io/v1/cases/{id}/inputs"

	payload := strings.NewReader("{\n  \"context\": \"Transcript of a call with the client on 2026-09-01\",\n  \"content\": \"Client: the water damage happened on 30 August, my policy number is POL-123…\",\n  \"data\": {\n    \"policy_number\": \"POL-123\"\n  },\n  \"options\": {\n    \"mode\": \"suggest\"\n  }\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://connect.penbox.io/v1/cases/{id}/inputs")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"context\": \"Transcript of a call with the client on 2026-09-01\",\n  \"content\": \"Client: the water damage happened on 30 August, my policy number is POL-123…\",\n  \"data\": {\n    \"policy_number\": \"POL-123\"\n  },\n  \"options\": {\n    \"mode\": \"suggest\"\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://connect.penbox.io/v1/cases/{id}/inputs")

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  \"context\": \"Transcript of a call with the client on 2026-09-01\",\n  \"content\": \"Client: the water damage happened on 30 August, my policy number is POL-123…\",\n  \"data\": {\n    \"policy_number\": \"POL-123\"\n  },\n  \"options\": {\n    \"mode\": \"suggest\"\n  }\n}"

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

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "created_at": "2023-11-07T05:31:56Z",
  "case": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  },
  "source": "api",
  "type": "call",
  "context": "<unknown>",
  "mode": "suggest",
  "status": "proposed",
  "intelligence": {
    "content": "succeeded",
    "error": "<string>"
  },
  "summary": "<string>",
  "changes": [
    {
      "id": "c2",
      "kind": "data",
      "key": "<string>",
      "label": "<string>",
      "type": "<string>",
      "current": "<unknown>",
      "proposed": "<unknown>",
      "value": "<unknown>",
      "origin": "input",
      "evidence": "<string>",
      "status": "proposed",
      "reason": "fill_if_empty"
    }
  ],
  "unmapped": [
    {
      "name": "<string>",
      "value": "<string>"
    }
  ],
  "reviewed_at": "2023-11-07T05:31:56Z",
  "content": "<unknown>"
}

{
  "errors": [
    {
      "status": "<string>",
      "title": "<string>",
      "detail": "<string>",
      "source": {
        "pointer": "<string>"
      }
    }
  ]
}

Cases

Create Case Input

Push raw material on a case (a call transcript, CRM notes, a chat thread, a parsed email as JSON) and let Penbox turn it into case data, the way an inbound email is read.

This is the front door for writing to a case. data covers POST /cases/{id}/data, contacts covers POST /cases/{id}/contacts, and content is what neither can take. Use the atomic routes when you already know exactly which key to write; use this route when you hold material Penbox should read, or when you want to know what was written and what was refused.

At least one of content, data, contacts is required. A call carrying only data / contacts runs no AI.

auto mode (the default, configurable per case template) writes the values right away, within the case’s Email Intelligence fill setting: by default an input fills empty fields and never overwrites a value the case already holds.
suggest mode keeps every row as a proposal. Review it with POST /cases/{id}/inputs/{input_id}/apply.

Explicit values always win over what the AI reads. Values land on the case in a single write, so automations and Document Intelligence fire as they do for POST /cases/{id}/data; Document Intelligence runs after the response, so re-read the case a moment later if a file field with a template was written.

POST

cases

{id}

inputs

Create Case Input

curl --request POST \
  --url https://connect.penbox.io/v1/cases/{id}/inputs \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "context": "Transcript of a call with the client on 2026-09-01",
  "content": "Client: the water damage happened on 30 August, my policy number is POL-123…",
  "data": {
    "policy_number": "POL-123"
  },
  "options": {
    "mode": "suggest"
  }
}
'

import requests

url = "https://connect.penbox.io/v1/cases/{id}/inputs"

payload = {
    "context": "Transcript of a call with the client on 2026-09-01",
    "content": "Client: the water damage happened on 30 August, my policy number is POL-123…",
    "data": { "policy_number": "POL-123" },
    "options": { "mode": "suggest" }
}
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({
    context: 'Transcript of a call with the client on 2026-09-01',
    content: 'Client: the water damage happened on 30 August, my policy number is POL-123…',
    data: {policy_number: 'POL-123'},
    options: {mode: 'suggest'}
  })
};

fetch('https://connect.penbox.io/v1/cases/{id}/inputs', 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://connect.penbox.io/v1/cases/{id}/inputs",
  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([
    'context' => 'Transcript of a call with the client on 2026-09-01',
    'content' => 'Client: the water damage happened on 30 August, my policy number is POL-123…',
    'data' => [
        'policy_number' => 'POL-123'
    ],
    'options' => [
        'mode' => 'suggest'
    ]
  ]),
  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://connect.penbox.io/v1/cases/{id}/inputs"

	payload := strings.NewReader("{\n  \"context\": \"Transcript of a call with the client on 2026-09-01\",\n  \"content\": \"Client: the water damage happened on 30 August, my policy number is POL-123…\",\n  \"data\": {\n    \"policy_number\": \"POL-123\"\n  },\n  \"options\": {\n    \"mode\": \"suggest\"\n  }\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://connect.penbox.io/v1/cases/{id}/inputs")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"context\": \"Transcript of a call with the client on 2026-09-01\",\n  \"content\": \"Client: the water damage happened on 30 August, my policy number is POL-123…\",\n  \"data\": {\n    \"policy_number\": \"POL-123\"\n  },\n  \"options\": {\n    \"mode\": \"suggest\"\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://connect.penbox.io/v1/cases/{id}/inputs")

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  \"context\": \"Transcript of a call with the client on 2026-09-01\",\n  \"content\": \"Client: the water damage happened on 30 August, my policy number is POL-123…\",\n  \"data\": {\n    \"policy_number\": \"POL-123\"\n  },\n  \"options\": {\n    \"mode\": \"suggest\"\n  }\n}"

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

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "created_at": "2023-11-07T05:31:56Z",
  "case": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  },
  "source": "api",
  "type": "call",
  "context": "<unknown>",
  "mode": "suggest",
  "status": "proposed",
  "intelligence": {
    "content": "succeeded",
    "error": "<string>"
  },
  "summary": "<string>",
  "changes": [
    {
      "id": "c2",
      "kind": "data",
      "key": "<string>",
      "label": "<string>",
      "type": "<string>",
      "current": "<unknown>",
      "proposed": "<unknown>",
      "value": "<unknown>",
      "origin": "input",
      "evidence": "<string>",
      "status": "proposed",
      "reason": "fill_if_empty"
    }
  ],
  "unmapped": [
    {
      "name": "<string>",
      "value": "<string>"
    }
  ],
  "reviewed_at": "2023-11-07T05:31:56Z",
  "content": "<unknown>"
}

{
  "errors": [
    {
      "status": "<string>",
      "title": "<string>",
      "detail": "<string>",
      "source": {
        "pointer": "<string>"
      }
    }
  ]
}

Push raw material on a case and let Penbox read it into case data, the way an inbound email is read. Use this route when you hold something Penbox should read: a call transcript, CRM notes, a chat thread, a parsed email. Use POST /cases/{id}/data when you already know exactly which key to write. The response is the input resource: what Penbox proposed or wrote, row by row, and what it refused and why. The refreshed case is embedded under case. Contacts sent in contacts are the caller’s own word: the role is created when the case does not declare it, an already-bound role is replaced, and the identity fields you send override the ones on an existing contact. A contact the AI read is more conservative: it fills a declared role, and only when that role is empty.

Authorizations

Authorization

string

header

required

API token (starts with pnbx_). Create at https://app.penbox.io/workspace/settings/api. Include as: Authorization: Bearer {token}

Path Parameters

string<uuid>

required

Case UUID

Body

application/json

context

What this material is and where it comes from: free text, or any JSON (call id, agent, duration…)

Example:

"Transcript of an 11-minute call with the client on 2026-09-01"

content

The material itself: a string (transcript, notes, OCR…) or any JSON value (a parsed email, a webhook payload). Sent to the model as-is. Max 100 000 characters once serialized.

data

object

Explicit values, written as-is. An unknown key lands in the case's extra data, as with POST /cases/{id}/data.

contacts

object[]

Explicit contacts, same shape as POST /cases/{id}/contacts

Show child attributes

options

object

Show child attributes

Response

The input resource with its change list, plus the refreshed case

string<uuid>

created_at

string<date-time>

case

object

The case. On the write routes and on the single read it is the full case (same shape as GET /cases/{id}).

Show child attributes

source

string

Provenance, inferred from your token: api

Example:

"api"

type

enum<string> | null

What the material is, derived by Penbox from the context and the content

Available options:

call,

note,

chat,

message,

document,

other

context

any | null

What you sent as context

mode

enum<string>

Available options:

suggest,

auto

status

enum<string>

Available options:

proposed,

partially_applied,

applied

intelligence

object

Show child attributes

summary

string | null

One paragraph on what the material is about, in the case language

changes

object[]

Show child attributes

unmapped

object[]

Facts read in the content that no case field can hold. Never written.

Show child attributes

reviewed_at

string<date-time> | null

content

any | null

The raw material, verbatim. Only returned by GET /cases/{id}/inputs/{input_id}.

API Reference

Workspaces

Cases

Tasks

Case Templates

Forms

Form Templates

Attachments

Document Intelligence

Signatures

Previous API version

Create Case Input

Authorizations

Path Parameters

Body

Response