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

  1. 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).

  1. 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.

  1. Lo tuyo y lo compartido juntos, por título. GET /v0/accessible/cards?type=project&type=workspace&q=trip → elementos con source: "owned" | "granted" y tus permissions; pagina con next_cursor. Detalles: Pipeline de API: buscar en el grafo

  2. Có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

Reglas

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í

Mentioned