Lister vos applications

Renvoie les applications de votre tableau de bord : les vôtres, celles des espaces de travail dont vous faites partie et celles qui ont été partagées avec vous, les plus récemment modifiées d’abord. Les applications supprimées ne sont pas incluses. N’importe quel rôle suffit, y compris viewer.

Les applications arrivent par lots de 100. total indique combien correspondent et, tant qu’il en reste, truncated vaut true et nextOffset indique où commence la page suivante. Pour trouver une seule application sans les lire toutes, cherchez avec q.

Lister est gratuit et ne consomme pas de crédits.

Requête

curl https://www.setherion.com/api/v1/projects \
  -H "Authorization: Bearer $SETHERION_API_KEY"

Pour chercher, ajoutez q. Il correspond aux mots n’importe où dans le nom ou la description d’une application, sans tenir compte des majuscules :

curl "https://www.setherion.com/api/v1/projects?q=coffee" \
  -H "Authorization: Bearer $SETHERION_API_KEY"

Pour la page suivante, ajoutez offset avec le nextOffset de la réponse précédente :

curl "https://www.setherion.com/api/v1/projects?offset=100" \
  -H "Authorization: Bearer $SETHERION_API_KEY"

L’ordre suit la dernière modification, l’id de l’application départageant les égalités, de sorte que deux applications modifiées au même instant ne changent jamais de place d’une page à l’autre. Une application modifiée entre deux demandes de page passe en haut de la liste, donc lisez les pages d’une seule traite.

Réponse

La première page d’un compte de plus de 100 applications :

{
  "ok": true,
  "total": 142,
  "truncated": true,
  "offset": 0,
  "nextOffset": 100,
  "projects": [
    {
      "id": "7c1e4a52-9b0d-4f3e-8a61-2d5f0c9e7b14",
      "name": "Coffee shop",
      "description": "Website for a coffee shop in Leeds",
      "url": "https://coffee-shop.setherion.app",
      "updatedAt": "2026-09-19T10:42:07.000Z"
    },
    {
      "id": "0e9d3b6a-41c2-4d7f-b8a5-6f1c2a9d4e30",
      "name": "Booking tool",
      "description": null,
      "url": null,
      "updatedAt": "2026-09-18T16:03:51.000Z"
    }
  ]
}

(Le tableau projects contient jusqu’à 100 entrées. Deux sont montrées.)

Une page au-delà de la fin n’est pas une erreur : elle répond ok: true avec une liste projects vide.

Lire toutes les pages

const base = 'https://www.setherion.com/api/v1/projects'
const headers = { Authorization: `Bearer ${process.env.SETHERION_API_KEY}` }

let offset = 0
const all = []
while (offset !== null) {
  const page = await fetch(`${base}?offset=${offset}`, { headers }).then(r => r.json())
  if (!page.ok) throw new Error(page.error)
  all.push(...page.projects)
  offset = page.nextOffset
}

Erreurs