Problem Library
Get Issue
Retrieve details for a specific issue from the problem library.
GET
/
v1
/
issues
/
:id
curl https://api.promptster.ai/v1/issues/iss_abc123 \
-H "Authorization: Bearer psk_live_abc123def456"
{
"issue": {
"id": "iss_abc123",
"source": "github",
"repoUrl": "https://github.com/facebook/react",
"repoSlug": "facebook/react",
"issueNumber": 28347,
"issueTitle": "useEffect cleanup runs with stale closure",
"issueUrl": "https://github.com/facebook/react/issues/28347",
"issueBody": "When a component unmounts while an async operation is in flight...",
"language": "typescript",
"difficulty": "medium",
"skillTags": ["hooks", "closures", "state-management"],
"estimatedMinutes": 45,
"brokenSha": "a1b2c3d4e5f6",
"referenceSha": "f6e5d4c3b2a1",
"taskBrief": "Fix the stale closure bug in the useEffect cleanup function...",
"setupInstructions": "Run `npm install` then `npm test` to see the failing test.",
"isCustom": false,
"status": "active",
"createdAt": "2026-03-01T00:00:00.000Z",
"updatedAt": "2026-03-15T00:00:00.000Z"
}
}
Returns full details for a single issue including its task brief, setup instructions, and metadata. Use this to preview an issue before linking it to an assessment.
Authentication
Requires either an org API key or a Clerk JWT.Authorization: Bearer psk_live_...
string
required
The issue ID.
object
The issue object.
Show properties
Show properties
string
Issue ID (UUID).
string
Source repository host.
string
Repository URL.
string | null
Short repo identifier.
integer | null
Original issue/PR number.
string
Issue title.
string | null
Link to the original GitHub issue.
string
Full issue body/description.
string
Primary language.
string
Difficulty level.
string[]
Skill tags.
integer | null
Estimated solve time.
string
Git SHA where the bug exists.
string
Git SHA with the known fix.
string
Markdown task description.
string
Workspace setup instructions.
boolean
Whether this is a custom issue.
string
Issue status.
string
ISO 8601 timestamp.
string
ISO 8601 timestamp.
{
"issue": {
"id": "iss_abc123",
"source": "github",
"repoUrl": "https://github.com/facebook/react",
"repoSlug": "facebook/react",
"issueNumber": 28347,
"issueTitle": "useEffect cleanup runs with stale closure",
"issueUrl": "https://github.com/facebook/react/issues/28347",
"issueBody": "When a component unmounts while an async operation is in flight...",
"language": "typescript",
"difficulty": "medium",
"skillTags": ["hooks", "closures", "state-management"],
"estimatedMinutes": 45,
"brokenSha": "a1b2c3d4e5f6",
"referenceSha": "f6e5d4c3b2a1",
"taskBrief": "Fix the stale closure bug in the useEffect cleanup function...",
"setupInstructions": "Run `npm install` then `npm test` to see the failing test.",
"isCustom": false,
"status": "active",
"createdAt": "2026-03-01T00:00:00.000Z",
"updatedAt": "2026-03-15T00:00:00.000Z"
}
}
curl https://api.promptster.ai/v1/issues/iss_abc123 \
-H "Authorization: Bearer psk_live_abc123def456"
curl https://api.promptster.ai/v1/issues/iss_abc123 \
-H "Authorization: Bearer psk_live_abc123def456"
{
"issue": {
"id": "iss_abc123",
"source": "github",
"repoUrl": "https://github.com/facebook/react",
"repoSlug": "facebook/react",
"issueNumber": 28347,
"issueTitle": "useEffect cleanup runs with stale closure",
"issueUrl": "https://github.com/facebook/react/issues/28347",
"issueBody": "When a component unmounts while an async operation is in flight...",
"language": "typescript",
"difficulty": "medium",
"skillTags": ["hooks", "closures", "state-management"],
"estimatedMinutes": 45,
"brokenSha": "a1b2c3d4e5f6",
"referenceSha": "f6e5d4c3b2a1",
"taskBrief": "Fix the stale closure bug in the useEffect cleanup function...",
"setupInstructions": "Run `npm install` then `npm test` to see the failing test.",
"isCustom": false,
"status": "active",
"createdAt": "2026-03-01T00:00:00.000Z",
"updatedAt": "2026-03-15T00:00:00.000Z"
}
}