Apply Case Input

curl --request POST \
  --url https://connect.penbox.io/v1/cases/{id}/inputs/{input_id}/apply \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "changes": [
    {
      "id": "c1"
    },
    {
      "id": "c2",
      "value": "2026-08-31"
    },
    {
      "id": "c7",
      "key": "photos"
    }
  ],
  "reject_others": true
}
'

import requests

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

payload = {
    "changes": [
        { "id": "c1" },
        {
            "id": "c2",
            "value": "2026-08-31"
        },
        {
            "id": "c7",
            "key": "photos"
        }
    ],
    "reject_others": True
}
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({
    changes: [{id: 'c1'}, {id: 'c2', value: '2026-08-31'}, {id: 'c7', key: 'photos'}],
    reject_others: true
  })
};

fetch('https://connect.penbox.io/v1/cases/{id}/inputs/{input_id}/apply', 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/{input_id}/apply",
  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([
    'changes' => [
        [
                'id' => 'c1'
        ],
        [
                'id' => 'c2',
                'value' => '2026-08-31'
        ],
        [
                'id' => 'c7',
                'key' => 'photos'
        ]
    ],
    'reject_others' => true
  ]),
  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/{input_id}/apply"

	payload := strings.NewReader("{\n  \"changes\": [\n    {\n      \"id\": \"c1\"\n    },\n    {\n      \"id\": \"c2\",\n      \"value\": \"2026-08-31\"\n    },\n    {\n      \"id\": \"c7\",\n      \"key\": \"photos\"\n    }\n  ],\n  \"reject_others\": true\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/{input_id}/apply")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"changes\": [\n    {\n      \"id\": \"c1\"\n    },\n    {\n      \"id\": \"c2\",\n      \"value\": \"2026-08-31\"\n    },\n    {\n      \"id\": \"c7\",\n      \"key\": \"photos\"\n    }\n  ],\n  \"reject_others\": true\n}")
  .asString();

require 'uri'
require 'net/http'

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

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  \"changes\": [\n    {\n      \"id\": \"c1\"\n    },\n    {\n      \"id\": \"c2\",\n      \"value\": \"2026-08-31\"\n    },\n    {\n      \"id\": \"c7\",\n      \"key\": \"photos\"\n    }\n  ],\n  \"reject_others\": true\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",
    "documents": "succeeded",
    "error": "<string>"
  },
  "summary": "<string>",
  "changes": [
    {
      "id": "c2",
      "kind": "data",
      "key": "<string>",
      "label": "<string>",
      "type": "<string>",
      "current": "<unknown>",
      "proposed": "<unknown>",
      "value": "<unknown>",
      "attachment": {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "name": "<string>",
        "size": 123,
        "type": "<string>"
      },
      "intelligence": "pending",
      "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

Apply Case Input

Review a suggest input: accept some rows, optionally with an edited value, and reject the rest. Deterministic, no AI call, applied from the stored record.

An accepted row is written whatever the fill setting says: a human validated it.
A row whose field changed on the case since the proposal comes back skipped with reason: value_changed, so an old proposal never overwrites a newer value.
Idempotent: rows already applied or rejected are returned unchanged. An unknown row id is a 400.
reject_others (default true) rejects every row you did not list. Pass false to keep them proposed for a later call.
A document row is filed at apply time. Pass key to file an unclassified document, or to send a classified one to another field. Document Intelligence runs after this response, so re-read the case a moment later when a row comes back with "intelligence": "pending".

POST

cases

{id}

inputs

{input_id}

apply

Apply Case Input

curl --request POST \
  --url https://connect.penbox.io/v1/cases/{id}/inputs/{input_id}/apply \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "changes": [
    {
      "id": "c1"
    },
    {
      "id": "c2",
      "value": "2026-08-31"
    },
    {
      "id": "c7",
      "key": "photos"
    }
  ],
  "reject_others": true
}
'

import requests

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

payload = {
    "changes": [
        { "id": "c1" },
        {
            "id": "c2",
            "value": "2026-08-31"
        },
        {
            "id": "c7",
            "key": "photos"
        }
    ],
    "reject_others": True
}
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({
    changes: [{id: 'c1'}, {id: 'c2', value: '2026-08-31'}, {id: 'c7', key: 'photos'}],
    reject_others: true
  })
};

fetch('https://connect.penbox.io/v1/cases/{id}/inputs/{input_id}/apply', 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/{input_id}/apply",
  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([
    'changes' => [
        [
                'id' => 'c1'
        ],
        [
                'id' => 'c2',
                'value' => '2026-08-31'
        ],
        [
                'id' => 'c7',
                'key' => 'photos'
        ]
    ],
    'reject_others' => true
  ]),
  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/{input_id}/apply"

	payload := strings.NewReader("{\n  \"changes\": [\n    {\n      \"id\": \"c1\"\n    },\n    {\n      \"id\": \"c2\",\n      \"value\": \"2026-08-31\"\n    },\n    {\n      \"id\": \"c7\",\n      \"key\": \"photos\"\n    }\n  ],\n  \"reject_others\": true\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/{input_id}/apply")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"changes\": [\n    {\n      \"id\": \"c1\"\n    },\n    {\n      \"id\": \"c2\",\n      \"value\": \"2026-08-31\"\n    },\n    {\n      \"id\": \"c7\",\n      \"key\": \"photos\"\n    }\n  ],\n  \"reject_others\": true\n}")
  .asString();

require 'uri'
require 'net/http'

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

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  \"changes\": [\n    {\n      \"id\": \"c1\"\n    },\n    {\n      \"id\": \"c2\",\n      \"value\": \"2026-08-31\"\n    },\n    {\n      \"id\": \"c7\",\n      \"key\": \"photos\"\n    }\n  ],\n  \"reject_others\": true\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",
    "documents": "succeeded",
    "error": "<string>"
  },
  "summary": "<string>",
  "changes": [
    {
      "id": "c2",
      "kind": "data",
      "key": "<string>",
      "label": "<string>",
      "type": "<string>",
      "current": "<unknown>",
      "proposed": "<unknown>",
      "value": "<unknown>",
      "attachment": {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "name": "<string>",
        "size": 123,
        "type": "<string>"
      },
      "intelligence": "pending",
      "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>"
      }
    }
  ]
}

Review an input created in suggest mode: accept some rows, optionally with an edited value, and reject the rest. A document row is filed at apply time. Pass key on the row to choose the file field. Use it to file a document that came back unclassified, or to send a classified one to another field. The key must be a file field of the case, else the call is a 400.

Filing a document on apply

{
  "changes": [
    { "id": "c1" },
    { "id": "c7", "key": "photos" }
  ]
}

Document Intelligence runs after this response, and only when the target field has a Document Intelligence template on the case. A row that comes back with "intelligence": "pending" means values read from the file will land on the case shortly: re-read GET /cases/{id} a moment later. Document Intelligence is billed per page.

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

input_id

string<uuid>

required

Input UUID

Body

application/json

changes

object[]

required

Show child attributes

reject_others

boolean

default:true

Response

The input with its row statuses updated, 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

Apply Case Input

Authorizations

Path Parameters

Body

Response