CellCog

Hire a new AI employee in the connected CellCog account. Hiring creates a standing AI employee: it works over days or months, keeps memory, learns the skills you teach it and runs routines, and its work spends the owner's credits (you pay for the work, not the hire). For a one-off job use a chat (cellcog_chat_create) instead. brief (required) is the role in plain words, as you would type it on the hire page: "a marketing manager for my coffee brand; posts weekly; tracks Instagram". name (optional) asks the employee to call itself that; it still sets its own identity. chat_tier: flash, core (default) or max. Settings beyond the brief (routines, schedule, email, access to tools) are changed by messaging the employee with cellcog_employee_message: it changes what it can itself and asks its owner for the rest. Pausing and deleting are on the web. Returns employee_id, shift_number (1) and the web link; then poll cellcog_get_result with employee_id: the employee introduces itself and asks what it needs. If the account is out of credits the tool returns error=needs_credits with a checkout_url to open for the user; once credits land, hire again.

cellcog_employee_hire

The AI employees you can instruct in the connected CellCog account: the ones you own, and the ones a teammate shared with you inside your organization. Each row carries employee_id (pass it to the other employee tools), name, title, email, access (owner, or team when you instruct it on behalf of its owner; the owner's credits pay either way), owner_name, status (working, resting, paused) and current_shift (its number, chat id and state). An AI employee works in numbered shifts: one workspace and memory, one conversation per shift. With none yet, hire one with cellcog_employee_hire.

cellcog_employee_list

One AI employee by employee_id: who it is and its list of shifts. The same fields as cellcog_employee_list plus its shifts, newest first (shift_number, chat_id, started_at, ended_at, stop_reason, trigger, is_current). shifts_limit sets the page size (default 20, up to 100); pass next_before_shift as before_shift for the page before. To read what was said in a shift, use cellcog_employee_shift.

cellcog_employee_get

Every message of one shift of an AI employee: the employee's and its human's, in order, the files they reference with links, and the shift's dates. shift_number picks the shift; omit it for the latest. limit keeps the most recent messages (default 50, up to 500); messages_total says how many the shift has. For who the employee is and its list of shifts, use cellcog_employee_get.

cellcog_employee_shift

Send a message to an AI employee, as you would type it in its chat on the web: a request, an answer to its question, new information, or a change to its own settings (a routine, its schedule, how it works). It lands in the employee's current shift and returns shift_number, the shift that holds it: a message to a shift that already clocked out can start a new shift, and started_new_shift says so. A paused employee keeps the message in its mailbox (paused and queued are true) until its owner resumes it. Attachments work as on cellcog_chat_create. Then poll cellcog_get_result with employee_id about once a minute for the reply. If CellCog fails you or a feature is missing, ask the employee to file a support report with the details (what you tried, the exact error, what you expected).

cellcog_employee_message

The connected CellCog account: email, organization, plan, credit balance and parallel-chat slots (running and allowed). Use it to confirm the connection works or to explain why a chat did not start.

cellcog_account

Start a CellCog chat. An agent takes your brief as a job and returns finished work: the script, the asset and a check of the result, not a single model call. Use it when the brief is a job (an ad, a video, a report, a deck, a spreadsheet, research with sources, an app). CellCog produces images, video with dialogue, music and sound, voiceover and cloned voices, music, sound effects, podcasts, talking avatars, 3D models, PDFs, slide decks, spreadsheets, dashboards, web apps, diagrams, memes, SVG graphics, deep research, data analysis and code, and covers image or video generation, upscaling, background removal, outpainting and dubbing in the same request. chat_mode: agent (default), creative (design, brand and voice work; it matters when art direction must hold across several outputs, otherwise agent gives the same result for less), team (several agents challenging each other, deep research). chat_tier: flash (quickest and cheapest), core (balanced), max (deepest reasoning, costliest, for work that must be right); the mode's default when omitted. Cost follows the work assigned; the balance is in cellcog_account and the price list at https://cellcog.ai/pricing. attachments: public https links the agent should download, up to 25 MB each, or 'upload:<upload_id>' from cellcog_upload, which attaches every file in that window; write <SHOW_FILE>key</SHOW_FILE> in the prompt only when the brief must say which file is which, never both for the same file. project_id scopes the chat to a CellCog project. Returns the chat id and a link right away; the work runs in the background. Then poll cellcog_get_result about once a minute: it returns the agent's progress notes while the run is live and the result when it is done (cellcog_chat_status is a one-line check, not the polling loop). If the account is out of credits the tool returns error=needs_credits with a checkout_url to open for the user; once credits land, send the same request again.

cellcog_chat_create

Recent chats in the connected CellCog account with their status, the ones created through this connector first. label filters by the chat's name. Use it to find yesterday's work.

cellcog_chat_list

Send a follow-up into an existing CellCog chat, in context: iterate on the result, answer a question the agent asked, or add files. Attachments work exactly as on cellcog_chat_create: public https URLs, 'upload:<upload_id>' from cellcog_upload, or <SHOW_FILE>key</SHOW_FILE> per file key written in the message text (the web-chat shape). Returns immediately; the agent picks the message up in its current run or starts a new one.

cellcog_chat_send

Cheap status check for a CellCog chat: status (running, needs_input, done, idle), whether a run is live, and the agent's latest one-line progress note. For the full timeline of progress notes, poll cellcog_get_result.

cellcog_chat_status