Letter of recommendation

Draft a letter of recommendation from counselor notes. Call this to WRITE a letter. To critique one that already exists, call letterlens instead, which is much cheaper. Runs the same 5-step pipeline as appeal.

post/v1/tools/rec

Request

  • Base URL: https://api.counselorai.app
  • URL: https://api.counselorai.app/v1/tools/rec
  • Auth: HTTP bearer

Headers

Idempotency-Keystring

Retry-safe key. Guarantees the call is billed at most once.

X-Max-Creditsinteger

Maximum credits approved for this call. Rejects a larger hold and caps the final charge.

Request body

studentNamestring

The student this is about. Used in the output text.

counselorNamestring

Who the letter is from. The counselor stays the author; this tool drafts, it does not sign.

purpose'college_general' | 'college_honors' | 'scholarship' | 'transfer' | 'professional' | 'employment' | 'program' | 'undergraduate' | 'graduate' | 'internship' | 'other'

What the letter is for. undergraduate, graduate, internship and other are legacy aliases kept working for existing integrations.

profType'law' | 'medical' | 'mba' | 'dental' | 'pharmacy' | 'pa' | 'nursing' | 'socialwork'

Only when purpose is professional: which professional school, since each reads for different things.

recipientstring

Who receives it, if named.

schoolsstring

Target school or program.

majorstring
selectivitystring

How selective the target is. Shifts how much evidence the letter has to carry.

relationshipstring

How the counselor knows the student, and for how long.

traitsstring required

Three standout traits. Send prose, not a list of adjectives: the pipeline turns each one into a scene and needs something to work from.

storystring

A specific moment worth telling. The single highest-value field here.

contributionstring

What the student adds to a campus.

resumeTextstring

Resume or activity list as plain text.

sampleTextstring

A sample of the counselor's own writing, so the letter lands in their voice rather than a generic one.

Response

Tool output

request_idstring
toolstring

Changes

No recorded changes to this operation across all 1 revision of this API.