Documentation

Linkio does it for you

Linkio runs the work. What you receive, your jobs in the app and with your AI agent, how you pay, who to ask, and what a managed agent cannot do.

On the managed plan, your account manager at Linkio finds the sites, gets the articles written and placed, and pays the publishers. You make the decisions that are yours: which sites, which titles, and the invoice.

You do your part through the links Linkio sends you, with your AI agent, or both, on the same account. A managed agent does different jobs from a self-serve agent: Linkio does the finding, ordering, sending and publisher payments, so you and your agent read, approve, pay Linkio's invoice and ask your account manager.

What you receive

Linkio sends you links. None of them needs a login.

LinkWhat it asks of you
Your reportRead what was placed and where each placement stands. Your open decisions are on its Action Items tab.
Site approvals (on the report, Action Items tab)Approve or reject each proposed site. Add a note if you want.
Title approvalsApprove a title for each article, or reject it with a reason.
An invoicePay it with Pay This Invoice. If something on it is wrong, use Question This Invoice.

Your jobs, in the app and with your agent

For an agent: account_me gives the account id (account.id). order_list gives each order's brands (clients[].id): that is the clientId that other tools take.

  • In the app: open Your report.
  • With your agent: order_list lists your orders, and order_get shows one order with each placement and its status; order_get also lists the sites that were left out, so count only those with inclusionStatus: included. line_items_operations shows your placements across all orders, 50 at a time (offset gives the next ones), and account_activity_feed lists what happened lately.

Read your results

  • In the app: Your report.
  • With your agent: client_report_highlights gives a brand's results: the keywords its links are cited for in AI assistants, the Google rankings they reached and the deliveries by month.

Approve sites

  • In the app: the Action Items tab of your report.
  • With your agent: site_approval_batch_list shows each batch of proposed sites and the decision on each site. You approve or reject on the report.

Approve titles

  • In the app: the title approval link.
  • With your agent: no tool reads title approvals for a managed key. Use the link, or ask your account manager.

Pay Linkio

  • In the app: the invoice link, Pay This Invoice.
  • With your agent: billing_history lists your payments and invoices; an invoice still to pay is in unpaidInvoices. account_billing_summary shows your balance. You pay; the agent does not. On order_get, the payment fields of an order are not an invoice: your invoices are the ones Linkio sends you.

Ask about a placement

  • In the app: the email address or the chat that your account manager gave you.
  • With your agent: line_item_message_publisher on a placement of a managed order goes to Linkio's team, never to the publisher.

How you pay

You pay Linkio, by the invoice link or the payment link that Linkio sends you. Linkio pays the publishers. You never pay a publisher on the managed plan.

Who to ask

Ask your account manager. Use the email address or the chat that your account manager gave you.

Your API key (optional)

You can give a tool or an AI agent access to your account. Make a key at https://www.linkio.com/account/api-keys. For a managed account the page opens on the Reporting level: the key can read your orders, placements and reports, and cannot change anything. Pick Automation if your agent should also send messages about a placement to Linkio's team.

A managed key never shows Linkio's cost, who the publisher is (no name or email), or Linkio's internal notes. It does show each placement's status with the publisher, including when the publisher is paid, and the publisher's status updates in the activity feed, for example "Article approved".

To connect an agent with the key: Connect an agent. The agent uses Linkio's MCP server, https://mcp.linkio.com/mcp, with the header Authorization: Bearer <the key>. An agent that cannot add a tool server calls the same tools over HTTP, one JSON-RPC request per call:

curl -s https://mcp.linkio.com/mcp -H 'Authorization: Bearer acc_your_key' \
  -H 'content-type: application/json' -H 'accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"order_list","arguments":{}}}'

The answer is an event stream. The tool's answer is the text in result.content[0].text on the data: line.

The server's list of tools for a managed key also names the self-serve tools; they answer as in the table below.

What a managed agent cannot do

The self-serve work is Linkio's on a managed account, so these calls are refused for a managed key:

The workToolsThe answer
Search siteswebsite_search403 ACCOUNT_TYPE_DENIED
Make an order, add or change its sitesorder_create, line_items_add_to_order, line_items_update403 ACCOUNT_TYPE_DENIED
Add target pagestarget_pages_add403 ACCOUNT_TYPE_DENIED
Read title approvalstopic_gen_title_approval_status403 ACCOUNT_TYPE_DENIED
Write or send an articlearticle_gen_start, workflow_send_to_publisher403 ACCOUNT_TYPE_DENIED
Close or move a placementline_item_close, line_item_replace_site403 NOT_SELF_SERVE
Pass or fail a live link, record a publisher paymentline_item_qa_decision, account_publisher_invoice_mark_paidRefused on a managed order
Move the account to self-serve while it has a managed planaccount_billing_mode with mode: self_serve403 managed_customer: ask your account manager

This page as markdown: /docs/managed.md. All pages for agents: /llms.txt.