Skip to main content
POST
curl, made-up values
MCP tool: propose_link, on PodData’s MCP server at https://api.poddata.ai/mcp, does what this route does, with the same key. See The MCP server.

Authorizations

Authorization
string
header
required

An API key, sent as Authorization: Bearer pd_live_…. Someone on your team makes one in the workspace, Settings › API keys; it's shown once. Staging's keys start with pd_test_.

Path Parameters

id
string
required
Maximum string length: 64

Body

application/json
kind
string
required

One of the kinds GET /companies/{id}/links answers: domain, google_place, amazon_asin, instagram, sec_cik, npi, legal_name and the rest

Required string length: 2 - 40
value
string
required

As the kind writes it: waterboy.com, ChIJ…, TN:QualDerm Partners, LLC

Required string length: 1 - 300
evidence
string

The address of the page that shows it's theirs, such as the company's own site linking to the account

Required string length: 8 - 2000

Response

Already one of its links: as it stands

id
string
required
kind
string
required
value
string
required
state
enum<string>
required
Available options:
proposed,
confirmed,
struck
evidence
string | null
required
decided_at
string | null
required
waits_for
enum<string> | null
required
Available options:
team,
poddata,
null