Documentation

Statuses and what you do now

Every placement status and activity event, what it means, and what you do next.

A placement has a publisher status: where it stands with the seller. The app shows it on each order row. An agent reads it in order_get, line_items_list or workflow_read (publisherStatus).

Publisher statuses

Before work starts

StatusWhat it meansWhat you do now
assignedA seller is on the placement. The article is not sent yet.Send the article when it is ready (workflow_send_to_publisher). Before the seller accepts, you can change the seller (line_item_switch_seller).
pre_acceptedThe seller said yes before work starts.Send the article when it is ready.
pre_rejectedThe seller said no before work starts.Move the placement to another site or seller (line_item_replace_site), or close it (line_item_close).
pre_approval_sentThe topic or the details went to the seller for approval before work starts.Wait for the reply. Read the thread with line_item_conversation_read.

The article

StatusWhat it meansWhat you do now
acceptedThe seller accepted the work.Send the article when it is ready. The seller can no longer be changed with line_item_switch_seller; use line_item_replace_site if you must move it.
awaiting_articleThe seller waits for the article.Finish or upload the article, then send it.
article_readyThe article was sent. It is in the seller's hands.Wait for the reply. If the seller is silent, message them (line_item_message_publisher). See When a placement goes wrong.
article_approvedThe seller approved the article.Wait for publication.
awaiting_publisher_approvalThe article was sent and waits for the seller's approval.Wait. Message the seller if it takes long.
approved_scheduledThe seller approved the article and set a publication date.Wait for publication.
revisions_requestedThe seller asks for changes to the article.Read the request on the thread, change the article, then send it again.
StatusWhat it meansWhat you do now
published_url_submittedThe seller sent the live URL.Check the live page, then pass or fail it (line_item_qa_decision). See Check the live link and pay.
in_qaThe live article is being checked.Read the check (workflow_read), then pass or fail it.
qa_failedThe check failed. The seller was told what to fix.Wait for the fix, then check the page again.
qa_resolvedThe seller says the issues are fixed.Check the live page again, then pass or fail it.
qa_passedThe live article passed the check.Pay the seller's invoice when it arrives.

Payment

StatusWhat it meansWhat you do now
payment_pendingThe article passed. The seller waits for payment.Pay the invoice yourself, then record the payment (account_publisher_invoice_mark_paid).
paidThe seller is paid.Nothing.

Ended

StatusWhat it meansWhat you do now
rejectedThe seller rejected the placement.Move it to another site or seller (line_item_replace_site), or close it (line_item_close).
cancelledThe work with this seller is cancelled.Nothing. A placement you closed yourself comes back with line_item_reopen.
non_responsiveThe seller stopped answering.Message the seller once more. Then move the placement (line_item_replace_site) or close it (line_item_close).
completedThe work is complete.Nothing.

Inclusion

Each site on an order is included, excluded or saved_for_later. Only included sites are worked on. Change it with line_items_update (inclusionStatus).

A closed placement

A placement you closed has the item status cancelled. It comes back with line_item_reopen. See When a placement goes wrong.

Activity events

account_activity_feed and https://www.linkio.com/account/activity list these events. Filter them with types (the event types, comma-separated).

Event typeFilter on the activity pageWhat happened
publisher_actionStatus UpdatesA seller's status changed on one of your placements.
conversation_messageMessagesA message on a placement thread, from you, the seller or Linkio.
order_createdOrdersAn order was created.
paymentPaymentsA payment on one of your orders.
usage_chargeChargesLinkio charged a job, with its cost.
holdHoldsMoney was held for a job, then settled or released.
approvalApprovalsA job asked for your yes under "ask me before any job over $X", and what was decided.
budget_pauseBudget PausesA workflow paused because the budget ran out.
budget_alertBudget AlertsA budget alert was sent.
limits_changeLimit ChangesYour spending limits changed.
placement_changePlacement ChangesA placement was closed, reopened, or moved to another site or seller.
invoice_receivedSeller InvoicesA seller sent an invoice for a placement on an order where you pay the seller.
qa_resultQA ResultsThe QA check on a placement gave a result, on an order where you pay the seller.
seller_rejectedSeller RejectionsA seller rejected or declined a placement, or did not answer. The placement needs a new site.
waiting_on_youWaiting on YouLinkio asked you a question about a placement, or the question was closed.

This page as markdown: /docs/self-serve/statuses.md. All pages for agents: /llms.txt.