Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.truthlocks.com/llms.txt

Use this file to discover all available pages before exploring further.

Your public portfolio is a profile page that displays all your protections with visibility set to “public.” Anyone can view it without signing in, making it a shareable showcase of your verified work.

​
Portfolio URL

Your portfolio is available at: 
https://verify.truthlocks.com/portfolio/{username}
The page displays your name, username, total number of protected items, and a grid of public protections. Each card links to the full proof page where visitors can verify authenticity.
Portfolio pages include OpenGraph metadata, so sharing your portfolio URL on social media or messaging apps generates a rich preview with your name and protection count.

​
Claiming a username

Your username determines your portfolio URL. Usernames are globally unique — once claimed, no other account can use it.
1

Go to your profile

Open Profile in the sidebar on the verify portal.
2

Enter a username

Type the username you want. Usernames must be 3–30 characters, lowercase alphanumeric, and may include hyphens or underscores. No spaces or special characters.
3

Claim it

Click Claim username. If the name is available, it is assigned to your account immediately and your portfolio goes live.
You can also claim a username through the API: 
curl -X PUT https://api.truthlocks.com/v1/consumer/me/username \
  -H "X-API-Key: tlk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"username": "jdoe"}'
Response
{
  "status": "updated",
  "username": "jdoe"
}
Your portfolio is then live at https://verify.truthlocks.com/portfolio/jdoe.
Usernames cannot be changed after claiming. Choose carefully.

​
Set up your portfolio

1

Protect content

Protect at least one piece of content using the Protect page or the API.
2

Claim a username

Claim a unique username from your Profile page to activate your portfolio URL.
3

Set visibility to public

When protecting content, choose Public (Portfolio) as the visibility option. You can also toggle existing protections to public from your Protections list.
4

Set your display name

Go to Profile in the sidebar and add your display name. This appears on your portfolio page alongside your username.

​
Managing visibility

Each protection can be either private (default) or public. Only public protections appear on your portfolio. To toggle visibility on an existing protection:
  1. Go to Protections in your dashboard.
  2. Click the visibility badge (labeled “private” or “public”) on any protection.
  3. The change takes effect immediately.
You can also update visibility through the API: 
curl -X PUT https://api.truthlocks.com/v1/consumer/protections/{id}/visibility \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"visibility": "public"}'
Your dashboard shows a Public stat card with the number of protections currently in your portfolio.

​
Fetch a portfolio via the API

Retrieve any user’s public portfolio programmatically. No authentication is required: 
curl https://api.truthlocks.com/v1/consumer/portfolio/{username}
Response
{
  "username": "jdoe",
  "name": "Jane Doe",
  "total_protections": 12,
  "protections": [
    {
      "attestation_id": "b2c3d4e5-...",
      "title": "Sunset at Big Sur",
      "description": "Landscape photograph taken at Pfeiffer Beach",
      "category": "photography",
      "created_at": "2026-03-20T14:30:00Z",
      "verify_url": "https://verify.truthlocks.com/proof/b2c3d4e5-..."
    }
  ]
}

​
Next steps

Embeddable badges

Add verification badges to your website or README.

Content protection

Full guide to protecting your content.

Consumer portal

Manage your inbox, protections, and settings.