Skip to content

Main content

Psychiatric Interview Section Token

Identify an explicitly recorded interview section within a supplied instrument version without determining a diagnosis.

Loading tool…

Description

Identify an explicitly recorded interview section within a supplied instrument version.

Mental-health records preserve instrument versions, recall wording, reporter roles, unknown responses and a person's own priorities. A missing code differs from a symptom rating, and a normalized preference is a scale position rather than a clinical urgency score. Recording these values does not assess mental state, diagnose a condition or choose care.

Identify an explicitly recorded interview section within a supplied instrument version.

When to use this tool

Use Psychiatric Interview Section Token when you already have interviewId, sectionCode, instrumentVersion and need to identify an explicitly recorded interview section within a supplied instrument version.

How to use the tool and how it works

  1. Enter interviewId, sectionCode, instrumentVersion. Use the units and conventions below.
  2. Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
  3. Read token. Use the output convention below.

Enter interviewId, sectionCode, instrumentVersion using the field constraints below. Encode these values, in exactly that order, as a JSON array and return the serialized array as text in token. String values are preserved without trimming or external terminology lookup.1

Input fieldMeaning and unitsAccepted input
interviewIdInterview IdRequired. Text; minimum UTF-16 length 1; maximum UTF-16 length 8192.
sectionCodeSection CodeRequired. Text; minimum UTF-16 length 1; maximum UTF-16 length 8192.
instrumentVersionInstrument VersionRequired. Text; minimum UTF-16 length 1; maximum UTF-16 length 8192.
Output fieldInterpretationReturned shape
tokenTokenRequired. Text; maximum UTF-16 length 8192.
json
{
  "input": {
    "interviewId": "INT17",
    "sectionCode": "SEC-A",
    "instrumentVersion": "v3"
  },
  "output": {
    "token": "[\"INT17\",\"SEC-A\",\"v3\"]"
  }
}

Limitations and assumptions

  • The result records supplied values without determining a diagnosis. Sources and asserted relationships are not independently authenticated.
  • Inputs must satisfy both the field types and the cross-field conditions above. Invalid input causes an error; a successful false flag or documented placeholder is a different result.

Alternative or Complementary methods

Consult the original instrument, language/version and reporter context for any substantive assessment. Preserve missing responses and user-selected goals explicitly; use the instrument's complete scoring process rather than treating one label or normalized preference as a clinical score.

References

  1. Calculation and input contract: psychiatry/psychiatric-interview-section-token — tool.io

Similar or alternative tools