Skip to content

Which of your projects holds this entity

GET
/v1/locate/{kind}/{id}
curl --request GET \
--url https://beta-api.plune.ai/v1/locate/runs/example \
--header 'Authorization: Bearer <token>'

For a dashboard address with no project in it — a link sent before #810, or one the CLI and eval-action print (api.ts → locate, ADR 0037): the dashboard asks here and replaces the address with /projects/<id>/…. Only the projects you are a member of are searched, and only its own project for a token minted in one — so a stranger’s entity, a binned one and an id nobody has all answer the same 404. Reads no X-Plune-Project: the project is what it answers.

kind
required
string
Allowed values: runs test-cases plans review

The dashboard path segment the id sits under — /runs/<id>, /test-cases/<id>, /plans/<id>, /review/<id>

id
required
string

The project that holds it

Media type application/json
object
projectId
required
string
Example
{
"projectId": "u-shop::default"
}

A kind it does not know

Media type application/json
object
error
required
string
Example generated
{
"error": "example"
}

No / invalid token or session

Not in any project of yours

Media type application/json
object
error
required
string
Example
{
"error": "not found"
}