Skip to main content
POST
Publish a public link

Authorizations

Authorization
string
header
required

A pc_… token generated from Settings > API & MCP.

Body

application/json
targetId
string<uuid>
required

Identifier of a row.

Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
targetKind
enum<string>
required

What the link points at.

Available options:
task,
project,
area
email
string<email> | null

Recorded when the link was sent to one person. Not enforced on opening.

Maximum string length: 254
Pattern: ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$

Response

Created.

url
string
required

The public address. Shown once and never again.