network.cosmik.card

cosmik.network

Documentation

A record representing a card with content.

main record

A record representing a card with content.

Record Key tid Timestamp-based ID

Properties

content union Required

The specific content of the card, determined by the card type.

Known types:
createdAt string datetime Optional

Timestamp when this card was created (usually set by PDS).

type string Required

The type of card

Known values: URL, NOTE
url string uri Optional

Optional URL associated with the card. Required for URL cards, optional for NOTE cards.

View raw schema 
{
  "key": "tid",
  "type": "record",
  "record": {
    "type": "object",
    "required": [
      "type",
      "content"
    ],
    "properties": {
      "url": {
        "type": "string",
        "format": "uri",
        "description": "Optional URL associated with the card. Required for URL cards, optional for NOTE cards."
      },
      "type": {
        "type": "string",
        "description": "The type of card",
        "knownValues": [
          "URL",
          "NOTE"
        ]
      },
      "content": {
        "refs": [
          "#urlContent",
          "#noteContent"
        ],
        "type": "union",
        "description": "The specific content of the card, determined by the card type."
      },
      "createdAt": {
        "type": "string",
        "format": "datetime",
        "description": "Timestamp when this card was created (usually set by PDS)."
      },
      "parentCard": {
        "ref": "com.atproto.repo.strongRef",
        "type": "ref",
        "description": "Optional strong reference to a parent card (for NOTE cards)."
      },
      "provenance": {
        "ref": "network.cosmik.defs#provenance",
        "type": "ref",
        "description": "Optional provenance information for this card."
      },
      "originalCard": {
        "ref": "com.atproto.repo.strongRef",
        "type": "ref",
        "description": "Optional strong reference to the original card (for NOTE cards)."
      }
    }
  },
  "description": "A record representing a card with content."
}
noteContent object

Content structure for a note card.

Properties

text string Required

The note text content

maxLength: 10000 bytes
View raw schema 
{
  "type": "object",
  "required": [
    "text"
  ],
  "properties": {
    "text": {
      "type": "string",
      "maxLength": 10000,
      "description": "The note text content"
    }
  },
  "description": "Content structure for a note card."
}
urlContent object

Content structure for a URL card.

Properties

metadata ref #urlMetadata Optional

Optional metadata about the URL

url string uri Required

The URL being saved

View raw schema 
{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "The URL being saved"
    },
    "metadata": {
      "ref": "#urlMetadata",
      "type": "ref",
      "description": "Optional metadata about the URL"
    }
  },
  "description": "Content structure for a URL card."
}
urlMetadata object

Metadata about a URL.

Properties

author string Optional

Author of the content

description string Optional

Description of the page

doi string Optional

Digital Object Identifier (DOI) for academic content

imageUrl string uri Optional

URL of a representative image

isbn string Optional

International Standard Book Number (ISBN) for books

publishedDate string datetime Optional

When the content was published

retrievedAt string datetime Optional

When the metadata was retrieved

siteName string Optional

Name of the site

title string Optional

Title of the page

type string Optional

Type of content (e.g., 'video', 'article')

View raw schema 
{
  "type": "object",
  "properties": {
    "doi": {
      "type": "string",
      "description": "Digital Object Identifier (DOI) for academic content"
    },
    "isbn": {
      "type": "string",
      "description": "International Standard Book Number (ISBN) for books"
    },
    "type": {
      "type": "string",
      "description": "Type of content (e.g., 'video', 'article')"
    },
    "title": {
      "type": "string",
      "description": "Title of the page"
    },
    "author": {
      "type": "string",
      "description": "Author of the content"
    },
    "imageUrl": {
      "type": "string",
      "format": "uri",
      "description": "URL of a representative image"
    },
    "siteName": {
      "type": "string",
      "description": "Name of the site"
    },
    "description": {
      "type": "string",
      "description": "Description of the page"
    },
    "retrievedAt": {
      "type": "string",
      "format": "datetime",
      "description": "When the metadata was retrieved"
    },
    "publishedDate": {
      "type": "string",
      "format": "datetime",
      "description": "When the content was published"
    }
  },
  "description": "Metadata about a URL."
}

Lexicon Garden

@