API pipeline: Everything you own or were given (Cabinet)

Index: API pipelines — index

Goal: list everything you own, and everything shared with you, type by type.

Steps

  1. What you own, per type.
GET /v0/my/projects?limit=20&offset=0
→ {"projects": [{"card_type": "project", "nonce": "470000000000000001", "title": "…", "visibility": "Private", …}], "total": 3}

Same for articles, posts, docs, sheets, boards, workspaces, campaigns, telegram_groups (key groups), oracles, agendas, api_endpoints, secrets, links, rubrics, coupons. Most take scope=owned|granted|all (default owned) and archived=true (archived cards only).

  1. Everything shared with you.
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 = what you may do; via = the access links it came through and when your access ends.

  1. Owned and shared together, by title. GET /v0/accessible/cards?type=project&type=workspace&q=trip → items with source: "owned" | "granted" and your permissions; page with next_cursor. Details: API pipeline: Search the graph

  2. How your cards connect. GET /v0/graph/my/edges?kind=containment&target_nonce=<card> → which of your workspaces hold a card. Every edge kind and filter: API pipeline: Link two cards with a relation, section «Other edges of your cards».

Behind

Rules

API surface

Endpoint Purpose FE AI / oracle
GET /v0/my/<type>s Your cards of one type yes (shelves) yes
GET /v0/graph/my/granted Cards shared with you and your rights yes (Granted) yes
GET /v0/accessible/cards Owned and shared, by title yes (pickers) yes
GET /v0/graph/my/edges Your links between cards no yes

Mentioned