Skip to content
Logo LogoThe AT Protocol SDK
Quickstart Guides Examples Custom lexicons Models Changelog
Logo LogoThe AT Protocol SDK
Quickstart Guides Examples Custom lexicons Models Changelog

🚀 Getting started

  • Installation
  • Quickstart

📚 Guides

  • Guides
    • Concepts
    • Authentication
    • Async
    • Posting
    • Reading
    • Social graph
    • Notifications
    • Direct messages
    • Records and repositories
    • Working with models
    • String formats
    • Resolving identities
    • Firehose
    • Jetstream
    • Error handling
    • Proxies and labelers
    • HTTP and transport
    • Building a feed generator

💡 Examples

  • Examples
    • Basics
    • Advanced usage
    • Firehose
    • Jetstream

🛠 CLI & code generation

  • The atp CLI
    • Custom lexicons
    • Code generator reference

🎛 Clients

  • Client (API)
    • Clients
      • Client
      • Raw Client
      • Base Client
      • Client method mixins
      • HTTP Client
    • Namespace
    • Utils
      • Text Builder (rich text)

📖 Models

  • Lexicons
    • app
      • bsky
        • actor
        • ageassurance
        • bookmark
        • contact
        • draft
        • embed
        • feed
        • graph
        • labeler
        • notification
        • richtext
        • unspecced
        • video
    • chat
      • bsky
        • actor
        • convo
        • embed
        • group
        • moderation
        • notification
    • com
      • atproto
        • admin
        • identity
        • label
        • lexicon
        • moderation
        • repo
        • server
        • sync
        • temp
      • germnetwork
        • declaration
    • internal
      • bsky
        • actor
    • network
      • bsky
        • jetstream
    • place
      • stream
        • badge
        • chat
        • defs
        • livestream
    • site
      • standard
        • graph
        • theme
        • document
        • publication
    • social
      • grain
        • gallery
        • defs
        • favorite
        • gallery
        • photo
    • tools
      • ozone
        • communication
        • hosting
        • inbox
        • moderation
        • queue
        • report
        • safelink
        • server
        • set
        • setting
        • signature
        • team
        • verification
  • Core
    • base
    • blob_ref
    • common
    • dot_dict
    • languages
    • models_loader
    • record_registry
    • string_formats
    • type_conversion
    • unknown_type
    • unknown_union
    • utils

📡 Firehose & Jetstream

  • Firehose (data streaming)
    • Frame models
  • Jetstream (data streaming)
    • Frame models
    • Archive replay
  • Subscription
    • Subscription client
    • Frame models
    • Websocket client

🧱 Advanced

  • Core
    • NSID (NameSpaced ID)
    • CID decoder
    • AT URI Scheme
    • CAR reader
    • DAG-CBOR
    • DID Document
  • Identity (DID and Handle resolvers)
    • ID Resolver
    • Handle Resolver
    • DID Resolver
    • Cache
    • AT Protocol Data
  • Crypto
    • DID
    • Multibase
    • Verify signature
  • Server
    • Auth
  • Lexicon
    • Parser
    • Models
  • Exceptions

🛠 Development

  • Change Log
  • Security Policy
  • Licence

🔗 Project Links

  • GitHub
  • PyPI
  • Author
  • AT Protocol Docs
  • Bluesky Docs
  • Discord Bluesky API
The AT Protocol SDK
/
Lexicons
/
app
/
app.bsky
/
app.bsky.actor
/
app.bsky.actor.link

app.bsky.actor.link

A link shown on the account’s profile. The profile record’s links field sets which links are shown, and in what order.

class atproto_client.models.app.bsky.actor.link.Record

Bases: RecordModelBase

Record model for app.bsky.actor.link.

field created_at: DateTime [Required]

Created at.

field icon: BlobRef | None = None

The destination site’s icon, uploaded when the link is saved.

field title: str | None = None
Constraints:
  • max_length = 320

field url: Uri [Required]

The link destination, an https URL.

class atproto_client.models.app.bsky.actor.link.GetRecordResponse

Bases: SugarResponseModelBase

Get record response for models.AppBskyActorLink.Record.

field cid: str | None = None

The CID of the record.

field uri: str [Required]

The URI of the record.

field value: models.AppBskyActorLink.Record [Required]

The record.

class atproto_client.models.app.bsky.actor.link.ListRecordsResponse

Bases: SugarResponseModelBase

List records response for models.AppBskyActorLink.Record.

field cursor: str | None = None

Next page cursor.

field records: Dict[str, models.AppBskyActorLink.Record] [Required]

Map of URIs to records.

class atproto_client.models.app.bsky.actor.link.CreateRecordResponse

Bases: SugarResponseModelBase

Create record response for models.AppBskyActorLink.Record.

field cid: str [Required]

The CID of the record.

field uri: str [Required]

The URI of the record.

app.bsky.actor.getSuggestions
app.bsky.actor.profile

On this page

  • Record
    • Record.created_at
    • Record.icon
    • Record.title
    • Record.url
  • GetRecordResponse
    • GetRecordResponse.cid
    • GetRecordResponse.uri
    • GetRecordResponse.value
  • ListRecordsResponse
    • ListRecordsResponse.cursor
    • ListRecordsResponse.records
  • CreateRecordResponse
    • CreateRecordResponse.cid
    • CreateRecordResponse.uri

© 2023-2026 Ilya (Marshal) 🦁