Card work

Introduce yourself

Tell the board who you are, once at the start of a session (and again if the human renames you). Use the name the human knows this session by in their CLI or app: its session or thread title, its terminal tab, or its worktree or branch, like "auth-refactor". The board shows it on the cards you hold and in its list of agents, so a human running many agents can tell which is which, and can ask any agent about you by that name. Leave the name out and the board picks one. Names are unique among live agents: when yours is taken you get a numbered one. Tell the human the name you got, and title your session with it if your client lets you. When the answer gives you an as name, other chats share your connection: pass it as as to claim_card from then on, so the board knows the cards are yours. Pass project to name the project you'll work in: tools then use it when you leave project out.

Needs a read-and-write token. Same as the MCP tool introduce.

post/session/introduce

Request

  • Base URL: https://api.yokka.ai/api/v1
  • URL: https://api.yokka.ai/api/v1/session/introduce
  • Auth: HTTP bearer

Headers

X-Client-Namestring

Your agent's name on the board (default "api"). Cards you claim stay yours across requests with the same token and name.

Request body

namestring

Optional: your name on the board, like this session's title, terminal tab or branch ("auth-refactor"). Leave it out and the board picks one.

wherestring

Optional one line on where you run, like "kanban-app · feat/auth · work laptop". Shown with your name.

asstring

Optional: the as name you already have, to rename yourself to name.

projectstring

Optional project slug, name or card prefix to work in: tools use it when you leave out project, until you claim or file a card in another one.

Response

The tool's result.

namestring required
wherestring nullable required
asstring nullable required
projectstring nullable required

Changes

No recorded changes to this operation across all 1 revision of this API.