Get AI project details

GET 
/ai/projects/:project_id

Returns one AI project, including its metadata, assistant settings, your access level, linked knowledge bases and agents (with sync status), uploaded files (with indexing status), and when project context was last refreshed. You need at least read-only access. If resource ACLs are enabled on the project, knowledge bases and agents you cannot access are omitted, except the platform agents SummarizerAgent, DatalabellerAgent, and ErrorDiagnosisAgent, which always appear. Links to deleted knowledge bases or agents are also omitted, so these lists can be shorter than what was saved. AvatarURL is a short-lived download URL and is included only when an avatar has been uploaded. Model includes AdaptiveThinking and Effort from the models catalog. This operation does not change any data.

Request

Responses

200

The full project, including assistant settings, linked resources, and files.

Response Headers

Access-Control-Allow-Origin
Access-Control-Allow-Methods
Access-Control-Allow-Headers
Strict-Transport-Security

400

The request was invalid or you do not have permission. The body is {"Message": " - "}. Common cases include a missing role_id (AUTH-1001), missing ai.view permission (AUTH-1030), or no read-only access to the project (AUTH-1012). Permission failures return 400, not 403.

Response Headers

Access-Control-Allow-Origin
Access-Control-Allow-Methods
Access-Control-Allow-Headers
Strict-Transport-Security

404

The project does not exist. The body is {"Message": "IPV-1002 - Invalid ProjectId - , resource not found."}. This is the only AI project operation that returns 404 for a missing project; update and delete return the same error as 400.

Response Headers

Access-Control-Allow-Origin
Access-Control-Allow-Methods
Access-Control-Allow-Headers
Strict-Transport-Security

500

An unexpected server error. The body is typically {"Message": "GE-1008 - Could not complete the request. Please try again."}.

Response Headers

Access-Control-Allow-Origin
Access-Control-Allow-Methods
Access-Control-Allow-Headers
Strict-Transport-Security