API reference

Project chats

List conversations associated with a project for workspace views. Use the conversation resource to inspect individual messages.

How it fits together

Select an action to see its complete inputs, request, response, and status codes.

GET/api/v1/tenancy/projects/{project_id}/chats

Production base URLhttps://api.mahvashai.ir

AuthenticationUser access JWT

ResponseMahvash product envelope

The table shows the accepted inputs for this endpoint. Examples use placeholders and illustrate a safe integration pattern.

Name	Location	Type	Required	Support	Details
`project_id`	Path	string	Required	Mahvash extension	Project UUID.
`search`	Query	string	Optional	Mahvash extension	Case-insensitive search over chat titles.
`status`	Query	string	Optional	Mahvash extension	Filter by chat lifecycle status.
`page`	Query	integer	Optional	Mahvash extension	One-based page number when bounded pagination is requested.
`page_size`	Query	integer	Optional	Mahvash extension	Page size from 1 through 100 when bounded pagination is requested.
`X-Request-ID`	Header	string	Optional	Mahvash extension	Client-supplied correlation ID. Echoed on every response; replaced when absent or malformed.
`X-Mahvash-Project`	Header	string	Optional	Mahvash extension	Project slug or ID within the caller's organization. Narrows the request principal; it can never widen it.

curl -X GET 'https://api.mahvashai.ir/api/v1/tenancy/projects/<project_id>/chats' \
  -H "Authorization: Bearer $MAHVASH_USER_JWT"

{
  "status": 0,
  "data": "<value>"
}

Illustrative response shape; actual fields depend on the operation and model.

HTTP	Details
200	List conversations in a project.
401	Authentication credentials are missing or invalid.
403	The principal is not allowed to perform this request.
404	No such resource is visible to this principal.
429	A quota or rate limit was exceeded.
500	An internal error occurred.