List projects for the active tenant

Session principals: scoped to activeTenantId; tenant ADMIN+/SUPER_ADMIN see all tenant projects, others see only their own. A project-level API key principal (the project’s own apiKey/apiSecret, header X-API-Key or _ak/key query — NOT a scoped key) returns just that one project. Does not use requireApiScope.

Authorizations

SessionCookie
ApiKeyAuth

Responses

200

Projects

application/json

object

projects

Array<object>

object

string

name

string

slug

string

description

string | null

domain

string | null

isActive

boolean

createdAt

string

updatedAt

string

_count

object

members

integer

400

Stale/absent active tenant (session)

application/json

object

error

required

Human-readable error message.

string

message

string

Example^generated

1
{
2
  "error": "example",
3
  "message": "example"
4
}

401

Not authorized

application/json

object

error

required

Human-readable error message.

string

message

string

Example^generated

1
{
2
  "error": "example",
3
  "message": "example"
4
}

GET

/api/projects

1
curl --request GET \
2
  --url https://retidal.com/api/projects \
3
  --cookie trackly_session=%3CYOUR_API_KEY%3E

1
const url = 'https://retidal.com/api/projects';
2
const options = {method: 'GET', headers: {cookie: 'trackly_session=%3CYOUR_API_KEY%3E'}};
3

4
try {
5
  const response = await fetch(url, options);
6
  const data = await response.json();
7
  console.log(data);
8
} catch (error) {
9
  console.error(error);
10
}

1
package main
2

3
import (
4
  "fmt"
5
  "net/http"
6
  "io"
7
)
8

9
func main() {
10

11
  url := "https://retidal.com/api/projects"
12

13
  req, _ := http.NewRequest("GET", url, nil)
14

15
  req.Header.Add("cookie", "trackly_session=%3CYOUR_API_KEY%3E")
16

17
  res, _ := http.DefaultClient.Do(req)
18

19
  defer res.Body.Close()
20
  body, _ := io.ReadAll(res.Body)
21

22
  fmt.Println(res)
23
  fmt.Println(string(body))
24

25
}

200Projects

1
{
2
  "projects": [
3
    {
4
      "id": "example",
5
      "name": "example",
6
      "slug": "example",
7
      "description": "example",
8
      "domain": "example",
9
      "isActive": true,
10
      "createdAt": "example",
11
      "updatedAt": "example",
12
      "_count": {
13
        "members": 1
14
      }
15
    }
16
  ]
17
}

List projects for the active tenant

Authorizations

Responses

200

400

Examplegenerated

401

Examplegenerated

Example^generated

Example^generated