star-stories

Update STAR Story

Update an existing STAR+Reflection story by id.

patch/star-stories/{id}

Request

  • Base URL: https://api.aiapplyd.com/api/v1
  • URL: https://api.aiapplyd.com/api/v1/star-stories/{id}
  • Auth: HTTP bearer

Path parameters

idstring required

STAR story identifier (UUID)

Example:a1b2c3d4-e5f6-7890-abcd-ef1234567890

Request body

actionstring

What the candidate did (specific, detailed)

bestForQuestionsstring[]

Question types this story is best for

reflectionstring nullable

Lessons learned / what would be done differently (signals seniority)

resultstring

Quantified outcome with metrics where possible

situationstring

Context for the story (1-2 sentences)

taskstring

What needed to be done

theme'leadership' | 'technical_challenge' | 'conflict_resolution' | 'ambiguity' | 'customer_impact' | 'failure' | 'ownership' | 'cross_functional' | 'scaling' | 'other'

Theme tag for the story

titlestring

Short memorable title

Example request

{
  "action": "Re-architected the build pipeline to use parallel test sharding...",
  "bestForQuestions": [
    "Tell me about a time you led",
    "Describe a hard technical decision"
  ],
  "reflection": "I learned to invest in observability before scaling, not after.",
  "result": "Cut CI time from 22 min to 6 min, unblocking 12 engineers.",
  "situation": "Our flagship CI pipeline grew to 22 minutes per run.",
  "task": "Get CI under 10 minutes without dropping coverage.",
  "theme": "technical_challenge",
  "title": "Cutting CI from 22 to 6 minutes"
}

Response

STAR story updated

successtrue required

Example response

{
  "data": {
    "bestForQuestions": [
      "Tell me about a time you led a team",
      "How do you handle conflict?"
    ],
    "createdAt": "2026-01-15T12:00:00Z",
    "derivedFromResume": true,
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "reflection": "I learned to invest in observability before scaling, not after.",
    "theme": "leadership",
    "title": "Cutting CI from 22 to 6 minutes",
    "updatedAt": "2026-03-10T08:30:00Z",
    "usageCount": 3,
    "userId": "user_123"
  },
  "meta": {
    "duration": 150,
    "requestId": "req_abc123",
    "timestamp": "2026-10-13T10:27:20.268Z",
    "version": "v1"
  }
}

Changes

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