Emoji reaction by an actor on a post or comment. Use one record per emoji (stacking supported). Public targets store cleartext emoji. Reactions to encrypted targets store ciphertext plus keyEpochId.
Record Key
tid
Timestamp-based ID
Properties
ciphertext
bytes
Optional
Encrypted reaction payload for private targets. Omit for public targets.
maxLength: 4096createdAt
string
datetime
Required
Client-declared timestamp when this reaction record was created.
emoji
string
Optional
Cleartext emoji reaction for public targets. Omit when ciphertext is set.
maxLength: 32 bytesmaxGraphemes: 1 graphemeskeyEpochId
string
Optional
Trust key epoch used for encrypted reactions. Required when ciphertext is set.
maxLength: 64 bytesminLength: 1 bytessubject
ref
com.atproto.repo.strongRef
Required
AT-URI/CID of the target post or comment.
View raw schema
{
"key": "tid",
"type": "record",
"record": {
"type": "object",
"required": [
"subject",
"createdAt"
],
"properties": {
"emoji": {
"type": "string",
"maxLength": 32,
"description": "Cleartext emoji reaction for public targets. Omit when ciphertext is set.",
"maxGraphemes": 1
},
"subject": {
"ref": "com.atproto.repo.strongRef",
"type": "ref",
"description": "AT-URI/CID of the target post or comment."
},
"createdAt": {
"type": "string",
"format": "datetime",
"description": "Client-declared timestamp when this reaction record was created."
},
"ciphertext": {
"type": "bytes",
"maxLength": 4096,
"description": "Encrypted reaction payload for private targets. Omit for public targets."
},
"keyEpochId": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "Trust key epoch used for encrypted reactions. Required when ciphertext is set."
}
}
},
"description": "Emoji reaction by an actor on a post or comment. Use one record per emoji (stacking supported). Public targets store cleartext emoji. Reactions to encrypted targets store ciphertext plus keyEpochId."
}