Pipeline de API: todo lo que tienes o te han concedido (Gabinete)
Índice: Pipelines de API — índice
Objetivo: listar todo lo que es tuyo y todo lo que se ha compartido contigo, tipo por tipo.
Pasos
- Lo que es tuyo, por tipo.
GET /v0/my/projects?limit=20&offset=0
→ {"projects": [{"card_type": "project", "nonce": "470000000000000001", "title": "…", "visibility": "Private", …}], "total": 3}
Igual para articles, posts, docs, sheets, boards, workspaces, campaigns, telegram_groups (clave groups), oracles, agendas, api_endpoints, secrets, links, rubrics, coupons. La mayoría aceptan scope=owned|granted|all (por defecto owned) y archived=true (solo tarjetas archivadas).
- Todo lo compartido contigo.
GET /v0/graph/my/granted
→ {"granted": [{"tile": {"card_type": "workspace", "nonce": "…", "title": "…", …},
"rights": {"read": true, "write": false, "execute": false},
"via": [{"nonce": "<link>", "title": "…", "expires_at": "…"}]}],
"total": 4}
rights = lo que puedes hacer; via = los enlaces de acceso por los que llegó y cuándo termina tu acceso.
Lo tuyo y lo compartido juntos, por título.
GET /v0/accessible/cards?type=project&type=workspace&q=trip→ elementos consource: "owned" | "granted"y tuspermissions; pagina connext_cursor. Detalles: Pipeline de API: buscar en el grafoCómo se conectan tus tarjetas.
GET /v0/graph/my/edges?kind=containment&target_nonce=<card>→ cuáles de tus espacios de trabajo contienen una tarjeta. Todos los tipos de arista y filtros: Pipeline de API: unir dos tarjetas con una relación, sección «Otras aristas de tus tarjetas».
Detrás
- Las tarjetas archivadas quedan fuera salvo que pidas
archived=true: Pipeline de API: archivar, restaurar o eliminar tus tarjetas - Tus me gusta: Pipeline de API: dar me gusta a tarjetas y volver a encontrarlas. Tus espacios de trabajo: Pipeline de API: reunir tarjetas en espacios de trabajo.
Reglas
- 401 sin token.
edges: 400 sinsource_noncenitarget_nonce, o con unkinddesconocido.
Superficie de la API
| Endpoint | Para qué | FE | IA / oráculo |
|---|---|---|---|
GET /v0/my/<type>s |
Tus tarjetas de un tipo | sí (secciones del Gabinete) | sí |
GET /v0/graph/my/granted |
Tarjetas compartidas contigo y tus derechos | sí (Concedidos) | sí |
GET /v0/accessible/cards |
Tuyas y compartidas, por título | sí (selectores) | sí |
GET /v0/graph/my/edges |
Tus enlaces entre tarjetas | no | sí |