API pipeline: Take over an account a Cabi.Chat oracle set up for you

Goal: after a Cabi.Chat oracle set up your project page from a Telegram chat, take it over: review and edit the page, see the oracle's setup access and revoke it.

What happens in the chat

• With your agreement a Cabi.Chat oracle can set up your page. Its access shows on your account as a token named <oracle> — setup access, and you can revoke it at any time.
• You get a one-time notice in the chat with how to revoke it.
• The oracle then builds your project page, usually public, and sends you its link.

Steps

1. Sign in with the same Telegram account that talked to the oracle: API pipeline: Sign in to Cabi.Chat with Telegram. Check: GET /v0/my/self.

2. Find the page. GET /v0/my/projects → {"projects": [{"nonce": "<project>", "title": "…", "visibility": "Public", …}], "total": 1}.

3. Review and edit.

PATCH /v0/my/projects/<project>
{"title": "…", "content": "…", "visibility": "Unlisted"}
→ the project

4. See the setup access. GET /v0/my/pats → a row {"title": "<oracle> — setup access", "last_used_at": "…", "revoked": false}.

5. Revoke it. POST /v0/my/pats/<pat>/revoke → "revoked": true. The oracle loses access to your account at once. You can also ask the oracle in the chat to give it up.

Rules

• What the oracle sets up is yours.
• It cannot see, mint or revoke your tokens.
• Revoke it once your page is ready: revoking keeps everything already built.
• Another Telegram account is another Cabi.Chat account: signed in with it, you see an empty account, not the page.

API surface

Index: API pipelines — index