Request
The unique identifier of the project
The unique identifier of the session
Bearer token for authentication
Content type for response. Options:
application/json
(default) - Returns structured JSON
text/markdown
- Returns raw markdown content
ETag value for conditional requests
Response
Indicates if the request was successful
Unique session identifier
Full markdown content of the session
Size of markdown content in bytes
Name of the client application
Version of the client application
ISO 8601 creation timestamp
ISO 8601 last update timestamp
ISO 8601 timestamp when session started
ISO 8601 timestamp when session ended
curl -H "Authorization: Bearer YOUR_API_KEY" \
-H "Accept: application/json" \
https://cloud.specstory.com/api/v1/projects/proj_abc123/sessions/550e8400-e29b-41d4-a716-446655440000
{
"success": true,
"data": {
"session": {
"id": "550e8400-e29b-41d4-a716-446655440000",
"name": "Bug Fix Discussion",
"markdownContent": "## Session Summary\n\n**User**: I'm having an issue with authentication...\n\n**Assistant**: Let me help you debug that...",
"markdownSize": 15420,
"metadata": {
"clientName": "Cursor",
"clientVersion": "2.0.0",
"agentName": "SpecStory Agent",
"deviceId": "device123",
"gitBranches": ["main", "feature-auth"],
"llmModels": ["claude-3-opus"],
"tags": ["bug-fix", "authentication"]
},
"createdAt": "2024-01-15T10:30:00.000Z",
"updatedAt": "2024-01-15T14:45:30.000Z",
"startedAt": "2024-01-15T10:30:00.000Z",
"endedAt": "2024-01-15T14:45:30.000Z",
"project": {
"id": "proj_abc123",
"name": "My Web App",
"icon": "Code2",
"color": "blue"
}
}
}
}