latestOpenAPI 3.0.12026-08-082942150.5 KB
14cab8ac3bca
Project Management
Get Project Status
When invoked, Get Project Status returns current project status and — if input data errors were detected — error information associated with each input data unit where an error occurred.
A project’s state can change due to REST API calls executed by your code, changes made to a project in the Enterprise Portal as well as project-related events occurring at Defined.ai. It is not guaranteed that project states follow a sequential, ordered progression.
| REST API Call Invocation | Project Related Event | Project Status | Invokable REST API Calls |
|---|---|---|---|
| Create Project | Project has been created | NOT ACTIVE | Upload Data Units |
| Delete Project | |||
| Upload Data Units | Defined.ai is running validation | PROCESSING DATA UPLOAD | |
| Upload to Defined.ai is complete and no errors were detected | UPLOAD SUCCESS | Upload Data Units | |
| Delete Project | |||
| Upload to Defined.ai is complete but Defined.ai found errors in some Input Units | UPLOAD ERRORS | Upload Data Units | |
| Delete Project | |||
| Upload to Defined.ai is complete but no data unit is valid | INSUFFICIENT DATA | Upload Data Units | |
| Delete Project | |||
| Defined.ai is preparing the project before deploying it to our human intelligence community | PREPARING PROJECT | Cancel Project | |
| Defined.ai has deployed the project to our human intelligence community | RUNNING | Cancel Project | |
| Defined.ai is accessing the quality of the human intelligence community | ASSESSING QUALITY | Cancel Project | |
| Defined.ai is curating and preparing the results for download | GENERATING RESULTS | ||
| Defined.ai has completed the project and data is available for download | PROJECT COMPLETED | Delete Project | |
| Get Deliverables | |||
| Cancel Project | Defined.ai has canceled the project | CANCELLED | Delete Project |
| Delete Project | Defined.ai has deleted the project | DELETED |
Permission Required: Read Project Properties
get/v2.0/public/projects/{projectId}/status
Path parameters
projectIdstring uuid required
Example:00000000-0000-0000-0000-000000000000
Project identifier.
Response
The ProjectStatus structure.
Example response
{
"projectDetails": {
"id": "00000000-0000-0000-0000-000000000000",
"uploadInputUnitsError": [
{
"inputDataUnitId": "00000000-0000-0000-0000-000000000000"
}
]
}
}