API and agents

You can drive GenLink from your own code or from a coding agent like Claude Code, Cursor or Codex. Everything goes through one HTTP API with a personal access token.

Get a token#

In the app, open Settings > API access and click Create token.

• The token is shown once, so copy it right away. You can revoke it later from the same page.
• It acts as you, in your current workspace. Switch workspace in the app to point it somewhere else.
• You can have 20 live tokens at most. Revoke an old one to make room.

Save it as the environment variable GENLINK_API_TOKEN. Never commit it to a repo.

The HTTP API#

• Base URL: https://backend.genlink.so/api
• Headers on every call: Authorization: Bearer $GENLINK_API_TOKEN and Accept: application/json. Without the Accept header, a validation error comes back as a redirect instead of JSON.

The main entry point is POST /manager/messages. You send a plain-English instruction and your manager agent carries it out, the same manager you chat with in the app. A turn takes 60 to 180 seconds, so give it a long timeout.

curl -X POST https://backend.genlink.so/api/manager/messages \
  -H "Authorization: Bearer $GENLINK_API_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  --max-time 300 \
  -d '{"message":"Find 25 DR-60+ marketing blogs relevant to my AI tool and draft outreach"}'

These reads are safe and return right away:

• GET /workspaces: your workspaces and the current_workspace_id your token acts in.
• GET /campaigns: your agents, 20 a page, with status and send, reply and link counts.
• GET /results: backlinks won, referring domains and 90 days of daily activity.
• GET /manager/messages: the conversation with your manager agent.

curl https://backend.genlink.so/api/results \
  -H "Authorization: Bearer $GENLINK_API_TOKEN" \
  -H "Accept: application/json"

The short guide is at backend.genlink.so/llms.txt and the full spec at backend.genlink.so/openapi.json.

Warning: the manager acts on your behalf. An instruction to it can hire agents, change what they pitch and send real email. Only send instructions you have reviewed, and remember the workspace approval gate and do-not-send list still apply.

Set up a coding agent#

There is a ready-made prompt that walks an agent through the token, these docs and a check that it can read your workspace, agents and results. Pick one:

• Click Setup for agents at the top of genlink.so and paste the prompt into your agent.
• In the app, go to Settings > API access and click Copy setup prompt. That one includes a fresh token, so the agent can start right away.
• Or tell your agent: "Read https://genlink.so/agent-setup.md and follow it."

MCP#

A hosted MCP server is coming. Until then, use the setup prompt above.