Check the parsing status of a specific project using its project ID. Returns the current status and whether the parsed commit matches the latest commit on the branch.
x-api-key header.
Request & Response
| Location | Field | Type | Required | Description |
|---|---|---|---|---|
| Path | project_id | string | required | Unique identifier of the project (returned from Parse Directory endpoint) |
| Response | status | string | - | Current parsing state: submitted, cloned, parsed, processing, inferring, ready, or error |
| Response | latest | boolean | - | Whether the parsed commit matches the latest commit on the branch |
401 Unauthorized
404 Not Found
project_id doesn’t exist in the databaseproject_id is correct and ensure you have appropriate access permissions.500 Internal Server Error
project_id.Status stuck at 'submitted'
Status shows 'error'
latest field is false
latest field shows false even though status is ready.Solution:| Status | Description | Typical Duration |
|---|---|---|
submitted | Parsing request queued | Immediate |
cloned | Repository cloned successfully | 10-30 seconds |
parsed | Code structure analyzed | 1-5 minutes |
processing | Building knowledge graph | 5-15 minutes |
inferring | Generating knowledge graph inferences | 5-20 minutes |
ready | Parsing complete and ready | Final state |
error | Parsing failed | Final state |
API key authentication. Get your key from potpie settings page
The unique project identifier returned from the parse endpoint