Entry for developers · Public API v1

Their identity.
Your canvas.

Bring owner-published people and companies into your website, or give an agent the context to understand them.

One Entry, ready to read
GET /api/v1/people/{handle}

{
  "data": {
    "type": "person",
    "name": "Alex Chen",
    "headline": "Product designer"
  },
  "meta": {
    "requestId": "…"
  }
}

Illustrative excerpt. Read-only. No API key.

01 / Get started

A published Entry.
One GET request.

Use a published handle from an Entry URL. Replace alex with the person you want to read. Search helps when you only have a name.

Terminal
curl 'https://api-entry-fyi.vercel.app/api/v1/people/alex'

Try a published Entry. This sends an anonymous, read-only request.

A successful response wraps the identity in data. Keep its immutable id for future lookups. Every response includes meta.requestId.

02 / Reference

Identity

GET/api/v1/entities/{id}

Read an Entry

Look up an explicit published identity by immutable public ID.

Request
curl 'https://api-entry-fyi.vercel.app/api/v1/entities/ent_0123456789abcdef0123456789abcdef'
Response schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "data": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "pattern": "^ent_[a-f0-9]{32}$"
        },
        "handle": {
          "type": "string"
        },
        "type": {
          "type": "string",
          "enum": [
            "person",
            "company"
          ]
        },
        "name": {
          "type": "string"
        },
        "headline": {
          "type": [
            "string",
            "null"
          ]
        },
        "canonicalUrl": {
          "type": "string"
        },
        "entryUrl": {
          "type": "string"
        },
        "apiUrl": {
          "type": "string"
        },
        "bio": {
          "description": "Owner-written biography. Null when About is hidden.",
          "type": [
            "string",
            "null"
          ]
        },
        "location": {
          "type": [
            "string",
            "null"
          ]
        },
        "avatarUrl": {
          "type": [
            "string",
            "null"
          ]
        },
        "coverUrl": {
          "type": [
            "string",
            "null"
          ]
        },
        "website": {
          "type": [
            "string",
            "null"
          ]
        },
        "availability": {
          "anyOf": [
            {
              "type": "object",
              "properties": {
                "status": {
                  "type": "string",
                  "enum": [
                    "available",
                    "limited",
                    "unavailable"
                  ]
                },
                "note": {
                  "type": [
                    "string",
                    "null"
                  ]
                }
              },
              "required": [
                "status",
                "note"
              ],
              "additionalProperties": false
            },
            {
              "type": "null"
            }
          ]
        },
        "capabilities": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "links": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string"
              },
              "url": {
                "type": "string"
              }
            },
            "required": [
              "label",
              "url"
            ],
            "additionalProperties": false
          }
        },
        "contact": {
          "anyOf": [
            {
              "type": "object",
              "properties": {
                "label": {
                  "type": "string"
                },
                "url": {
                  "type": "string"
                }
              },
              "required": [
                "label",
                "url"
              ],
              "additionalProperties": false
            },
            {
              "type": "null"
            }
          ]
        },
        "sections": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "type": {
                "type": "string"
              }
            },
            "required": [
              "type"
            ],
            "additionalProperties": false
          }
        },
        "profileUpdatedAt": {
          "anyOf": [
            {
              "type": "string",
              "format": "date-time",
              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
            },
            {
              "type": "null"
            }
          ],
          "description": "Profile modification time, not external fact verification."
        }
      },
      "required": [
        "id",
        "handle",
        "type",
        "name",
        "headline",
        "canonicalUrl",
        "entryUrl",
        "apiUrl",
        "bio",
        "location",
        "avatarUrl",
        "coverUrl",
        "website",
        "availability",
        "capabilities",
        "links",
        "contact",
        "sections",
        "profileUpdatedAt"
      ],
      "additionalProperties": false
    },
    "meta": {
      "type": "object",
      "properties": {
        "requestId": {
          "type": "string"
        },
        "nextCursor": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "requestId",
        "nextCursor"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "data",
    "meta"
  ],
  "additionalProperties": false
}
GET/api/v1/people/{handle}

Read a person

Look up a published person by handle. A company at this handle returns 404.

Request
curl 'https://api-entry-fyi.vercel.app/api/v1/people/alex'
Response schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "data": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "pattern": "^ent_[a-f0-9]{32}$"
        },
        "handle": {
          "type": "string"
        },
        "type": {
          "type": "string",
          "enum": [
            "person",
            "company"
          ]
        },
        "name": {
          "type": "string"
        },
        "headline": {
          "type": [
            "string",
            "null"
          ]
        },
        "canonicalUrl": {
          "type": "string"
        },
        "entryUrl": {
          "type": "string"
        },
        "apiUrl": {
          "type": "string"
        },
        "bio": {
          "description": "Owner-written biography. Null when About is hidden.",
          "type": [
            "string",
            "null"
          ]
        },
        "location": {
          "type": [
            "string",
            "null"
          ]
        },
        "avatarUrl": {
          "type": [
            "string",
            "null"
          ]
        },
        "coverUrl": {
          "type": [
            "string",
            "null"
          ]
        },
        "website": {
          "type": [
            "string",
            "null"
          ]
        },
        "availability": {
          "anyOf": [
            {
              "type": "object",
              "properties": {
                "status": {
                  "type": "string",
                  "enum": [
                    "available",
                    "limited",
                    "unavailable"
                  ]
                },
                "note": {
                  "type": [
                    "string",
                    "null"
                  ]
                }
              },
              "required": [
                "status",
                "note"
              ],
              "additionalProperties": false
            },
            {
              "type": "null"
            }
          ]
        },
        "capabilities": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "links": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string"
              },
              "url": {
                "type": "string"
              }
            },
            "required": [
              "label",
              "url"
            ],
            "additionalProperties": false
          }
        },
        "contact": {
          "anyOf": [
            {
              "type": "object",
              "properties": {
                "label": {
                  "type": "string"
                },
                "url": {
                  "type": "string"
                }
              },
              "required": [
                "label",
                "url"
              ],
              "additionalProperties": false
            },
            {
              "type": "null"
            }
          ]
        },
        "sections": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "type": {
                "type": "string"
              }
            },
            "required": [
              "type"
            ],
            "additionalProperties": false
          }
        },
        "profileUpdatedAt": {
          "anyOf": [
            {
              "type": "string",
              "format": "date-time",
              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
            },
            {
              "type": "null"
            }
          ],
          "description": "Profile modification time, not external fact verification."
        }
      },
      "required": [
        "id",
        "handle",
        "type",
        "name",
        "headline",
        "canonicalUrl",
        "entryUrl",
        "apiUrl",
        "bio",
        "location",
        "avatarUrl",
        "coverUrl",
        "website",
        "availability",
        "capabilities",
        "links",
        "contact",
        "sections",
        "profileUpdatedAt"
      ],
      "additionalProperties": false
    },
    "meta": {
      "type": "object",
      "properties": {
        "requestId": {
          "type": "string"
        },
        "nextCursor": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "requestId",
        "nextCursor"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "data",
    "meta"
  ],
  "additionalProperties": false
}
GET/api/v1/companies/{handle}

Read a company

Look up a published company by handle. A person at this handle returns 404.

Request
curl 'https://api-entry-fyi.vercel.app/api/v1/companies/studio'
Response schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "data": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "pattern": "^ent_[a-f0-9]{32}$"
        },
        "handle": {
          "type": "string"
        },
        "type": {
          "type": "string",
          "enum": [
            "person",
            "company"
          ]
        },
        "name": {
          "type": "string"
        },
        "headline": {
          "type": [
            "string",
            "null"
          ]
        },
        "canonicalUrl": {
          "type": "string"
        },
        "entryUrl": {
          "type": "string"
        },
        "apiUrl": {
          "type": "string"
        },
        "bio": {
          "description": "Owner-written biography. Null when About is hidden.",
          "type": [
            "string",
            "null"
          ]
        },
        "location": {
          "type": [
            "string",
            "null"
          ]
        },
        "avatarUrl": {
          "type": [
            "string",
            "null"
          ]
        },
        "coverUrl": {
          "type": [
            "string",
            "null"
          ]
        },
        "website": {
          "type": [
            "string",
            "null"
          ]
        },
        "availability": {
          "anyOf": [
            {
              "type": "object",
              "properties": {
                "status": {
                  "type": "string",
                  "enum": [
                    "available",
                    "limited",
                    "unavailable"
                  ]
                },
                "note": {
                  "type": [
                    "string",
                    "null"
                  ]
                }
              },
              "required": [
                "status",
                "note"
              ],
              "additionalProperties": false
            },
            {
              "type": "null"
            }
          ]
        },
        "capabilities": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "links": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string"
              },
              "url": {
                "type": "string"
              }
            },
            "required": [
              "label",
              "url"
            ],
            "additionalProperties": false
          }
        },
        "contact": {
          "anyOf": [
            {
              "type": "object",
              "properties": {
                "label": {
                  "type": "string"
                },
                "url": {
                  "type": "string"
                }
              },
              "required": [
                "label",
                "url"
              ],
              "additionalProperties": false
            },
            {
              "type": "null"
            }
          ]
        },
        "sections": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "type": {
                "type": "string"
              }
            },
            "required": [
              "type"
            ],
            "additionalProperties": false
          }
        },
        "profileUpdatedAt": {
          "anyOf": [
            {
              "type": "string",
              "format": "date-time",
              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
            },
            {
              "type": "null"
            }
          ],
          "description": "Profile modification time, not external fact verification."
        }
      },
      "required": [
        "id",
        "handle",
        "type",
        "name",
        "headline",
        "canonicalUrl",
        "entryUrl",
        "apiUrl",
        "bio",
        "location",
        "avatarUrl",
        "coverUrl",
        "website",
        "availability",
        "capabilities",
        "links",
        "contact",
        "sections",
        "profileUpdatedAt"
      ],
      "additionalProperties": false
    },
    "meta": {
      "type": "object",
      "properties": {
        "requestId": {
          "type": "string"
        },
        "nextCursor": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "requestId",
        "nextCursor"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "data",
    "meta"
  ],
  "additionalProperties": false
}
03 / Reference

Collections

GET/api/v1/entities/{id}/work

Read work

Read visible work in owner-defined order. Hidden or unsupported sections return an empty array. An inaccessible parent returns 404.

Request
curl 'https://api-entry-fyi.vercel.app/api/v1/entities/ent_0123456789abcdef0123456789abcdef/work?limit=20'
Response schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "data": {
      "type": "array",
      "items": {
        "oneOf": [
          {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "pattern": "^itm_[a-f0-9]{32}$"
              },
              "description": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "url": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "imageUrl": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "updatedAt": {
                "anyOf": [
                  {
                    "type": "string",
                    "format": "date-time",
                    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "ISO 8601 UTC timestamp, or null when unknown."
              },
              "kind": {
                "type": "string",
                "const": "work"
              },
              "title": {
                "type": "string"
              },
              "organization": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "startDate": {
                "description": "ISO 8601 reduced precision date: YYYY, YYYY-MM, or YYYY-MM-DD. Null when unknown.",
                "type": [
                  "string",
                  "null"
                ]
              },
              "endDate": {
                "description": "ISO 8601 reduced precision date: YYYY, YYYY-MM, or YYYY-MM-DD. Null when unknown.",
                "type": [
                  "string",
                  "null"
                ]
              },
              "current": {
                "type": "boolean"
              }
            },
            "required": [
              "id",
              "description",
              "url",
              "imageUrl",
              "updatedAt",
              "kind",
              "title",
              "organization",
              "startDate",
              "endDate",
              "current"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "pattern": "^itm_[a-f0-9]{32}$"
              },
              "description": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "url": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "imageUrl": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "updatedAt": {
                "anyOf": [
                  {
                    "type": "string",
                    "format": "date-time",
                    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "ISO 8601 UTC timestamp, or null when unknown."
              },
              "kind": {
                "type": "string",
                "const": "project"
              },
              "name": {
                "type": "string"
              },
              "role": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "date": {
                "description": "ISO 8601 reduced precision date: YYYY, YYYY-MM, or YYYY-MM-DD. Null when unknown.",
                "type": [
                  "string",
                  "null"
                ]
              }
            },
            "required": [
              "id",
              "description",
              "url",
              "imageUrl",
              "updatedAt",
              "kind",
              "name",
              "role",
              "date"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "pattern": "^itm_[a-f0-9]{32}$"
              },
              "description": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "url": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "imageUrl": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "updatedAt": {
                "anyOf": [
                  {
                    "type": "string",
                    "format": "date-time",
                    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "ISO 8601 UTC timestamp, or null when unknown."
              },
              "kind": {
                "type": "string",
                "const": "product"
              },
              "name": {
                "type": "string"
              },
              "status": {
                "type": [
                  "string",
                  "null"
                ]
              }
            },
            "required": [
              "id",
              "description",
              "url",
              "imageUrl",
              "updatedAt",
              "kind",
              "name",
              "status"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "pattern": "^itm_[a-f0-9]{32}$"
              },
              "description": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "url": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "imageUrl": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "updatedAt": {
                "anyOf": [
                  {
                    "type": "string",
                    "format": "date-time",
                    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "ISO 8601 UTC timestamp, or null when unknown."
              },
              "kind": {
                "type": "string",
                "const": "person"
              },
              "name": {
                "type": "string"
              },
              "role": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "place": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "entryUsername": {
                "description": "Owner-published reference, not evidence of affiliation.",
                "type": [
                  "string",
                  "null"
                ]
              },
              "entryUrl": {
                "type": [
                  "string",
                  "null"
                ]
              }
            },
            "required": [
              "id",
              "description",
              "url",
              "imageUrl",
              "updatedAt",
              "kind",
              "name",
              "role",
              "place",
              "entryUsername",
              "entryUrl"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "pattern": "^itm_[a-f0-9]{32}$"
              },
              "description": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "url": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "imageUrl": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "updatedAt": {
                "anyOf": [
                  {
                    "type": "string",
                    "format": "date-time",
                    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "ISO 8601 UTC timestamp, or null when unknown."
              },
              "kind": {
                "type": "string",
                "const": "highlight"
              },
              "title": {
                "type": "string"
              },
              "type": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "date": {
                "description": "ISO 8601 reduced precision date: YYYY, YYYY-MM, or YYYY-MM-DD. Null when unknown.",
                "type": [
                  "string",
                  "null"
                ]
              },
              "place": {
                "type": [
                  "string",
                  "null"
                ]
              }
            },
            "required": [
              "id",
              "description",
              "url",
              "imageUrl",
              "updatedAt",
              "kind",
              "title",
              "type",
              "date",
              "place"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "pattern": "^itm_[a-f0-9]{32}$"
              },
              "description": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "url": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "imageUrl": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "updatedAt": {
                "anyOf": [
                  {
                    "type": "string",
                    "format": "date-time",
                    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "ISO 8601 UTC timestamp, or null when unknown."
              },
              "kind": {
                "type": "string",
                "const": "post"
              },
              "title": {
                "type": "string"
              },
              "publication": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "date": {
                "description": "ISO 8601 reduced precision date: YYYY, YYYY-MM, or YYYY-MM-DD. Null when unknown.",
                "type": [
                  "string",
                  "null"
                ]
              },
              "topics": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            },
            "required": [
              "id",
              "description",
              "url",
              "imageUrl",
              "updatedAt",
              "kind",
              "title",
              "publication",
              "date",
              "topics"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "pattern": "^itm_[a-f0-9]{32}$"
              },
              "description": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "url": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "imageUrl": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "updatedAt": {
                "anyOf": [
                  {
                    "type": "string",
                    "format": "date-time",
                    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "ISO 8601 UTC timestamp, or null when unknown."
              },
              "kind": {
                "type": "string",
                "const": "currently"
              },
              "title": {
                "type": "string"
              }
            },
            "required": [
              "id",
              "description",
              "url",
              "imageUrl",
              "updatedAt",
              "kind",
              "title"
            ],
            "additionalProperties": false
          }
        ]
      }
    },
    "meta": {
      "type": "object",
      "properties": {
        "requestId": {
          "type": "string"
        },
        "nextCursor": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "requestId",
        "nextCursor"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "data",
    "meta"
  ],
  "additionalProperties": false
}
GET/api/v1/entities/{id}/projects

Read projects

Read visible projects in owner-defined order. Hidden or unsupported sections return an empty array. An inaccessible parent returns 404.

Request
curl 'https://api-entry-fyi.vercel.app/api/v1/entities/ent_0123456789abcdef0123456789abcdef/projects?limit=20'
Response schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "data": {
      "type": "array",
      "items": {
        "oneOf": [
          {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "pattern": "^itm_[a-f0-9]{32}$"
              },
              "description": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "url": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "imageUrl": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "updatedAt": {
                "anyOf": [
                  {
                    "type": "string",
                    "format": "date-time",
                    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "ISO 8601 UTC timestamp, or null when unknown."
              },
              "kind": {
                "type": "string",
                "const": "work"
              },
              "title": {
                "type": "string"
              },
              "organization": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "startDate": {
                "description": "ISO 8601 reduced precision date: YYYY, YYYY-MM, or YYYY-MM-DD. Null when unknown.",
                "type": [
                  "string",
                  "null"
                ]
              },
              "endDate": {
                "description": "ISO 8601 reduced precision date: YYYY, YYYY-MM, or YYYY-MM-DD. Null when unknown.",
                "type": [
                  "string",
                  "null"
                ]
              },
              "current": {
                "type": "boolean"
              }
            },
            "required": [
              "id",
              "description",
              "url",
              "imageUrl",
              "updatedAt",
              "kind",
              "title",
              "organization",
              "startDate",
              "endDate",
              "current"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "pattern": "^itm_[a-f0-9]{32}$"
              },
              "description": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "url": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "imageUrl": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "updatedAt": {
                "anyOf": [
                  {
                    "type": "string",
                    "format": "date-time",
                    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "ISO 8601 UTC timestamp, or null when unknown."
              },
              "kind": {
                "type": "string",
                "const": "project"
              },
              "name": {
                "type": "string"
              },
              "role": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "date": {
                "description": "ISO 8601 reduced precision date: YYYY, YYYY-MM, or YYYY-MM-DD. Null when unknown.",
                "type": [
                  "string",
                  "null"
                ]
              }
            },
            "required": [
              "id",
              "description",
              "url",
              "imageUrl",
              "updatedAt",
              "kind",
              "name",
              "role",
              "date"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "pattern": "^itm_[a-f0-9]{32}$"
              },
              "description": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "url": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "imageUrl": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "updatedAt": {
                "anyOf": [
                  {
                    "type": "string",
                    "format": "date-time",
                    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "ISO 8601 UTC timestamp, or null when unknown."
              },
              "kind": {
                "type": "string",
                "const": "product"
              },
              "name": {
                "type": "string"
              },
              "status": {
                "type": [
                  "string",
                  "null"
                ]
              }
            },
            "required": [
              "id",
              "description",
              "url",
              "imageUrl",
              "updatedAt",
              "kind",
              "name",
              "status"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "pattern": "^itm_[a-f0-9]{32}$"
              },
              "description": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "url": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "imageUrl": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "updatedAt": {
                "anyOf": [
                  {
                    "type": "string",
                    "format": "date-time",
                    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "ISO 8601 UTC timestamp, or null when unknown."
              },
              "kind": {
                "type": "string",
                "const": "person"
              },
              "name": {
                "type": "string"
              },
              "role": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "place": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "entryUsername": {
                "description": "Owner-published reference, not evidence of affiliation.",
                "type": [
                  "string",
                  "null"
                ]
              },
              "entryUrl": {
                "type": [
                  "string",
                  "null"
                ]
              }
            },
            "required": [
              "id",
              "description",
              "url",
              "imageUrl",
              "updatedAt",
              "kind",
              "name",
              "role",
              "place",
              "entryUsername",
              "entryUrl"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "pattern": "^itm_[a-f0-9]{32}$"
              },
              "description": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "url": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "imageUrl": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "updatedAt": {
                "anyOf": [
                  {
                    "type": "string",
                    "format": "date-time",
                    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "ISO 8601 UTC timestamp, or null when unknown."
              },
              "kind": {
                "type": "string",
                "const": "highlight"
              },
              "title": {
                "type": "string"
              },
              "type": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "date": {
                "description": "ISO 8601 reduced precision date: YYYY, YYYY-MM, or YYYY-MM-DD. Null when unknown.",
                "type": [
                  "string",
                  "null"
                ]
              },
              "place": {
                "type": [
                  "string",
                  "null"
                ]
              }
            },
            "required": [
              "id",
              "description",
              "url",
              "imageUrl",
              "updatedAt",
              "kind",
              "title",
              "type",
              "date",
              "place"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "pattern": "^itm_[a-f0-9]{32}$"
              },
              "description": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "url": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "imageUrl": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "updatedAt": {
                "anyOf": [
                  {
                    "type": "string",
                    "format": "date-time",
                    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "ISO 8601 UTC timestamp, or null when unknown."
              },
              "kind": {
                "type": "string",
                "const": "post"
              },
              "title": {
                "type": "string"
              },
              "publication": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "date": {
                "description": "ISO 8601 reduced precision date: YYYY, YYYY-MM, or YYYY-MM-DD. Null when unknown.",
                "type": [
                  "string",
                  "null"
                ]
              },
              "topics": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            },
            "required": [
              "id",
              "description",
              "url",
              "imageUrl",
              "updatedAt",
              "kind",
              "title",
              "publication",
              "date",
              "topics"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "pattern": "^itm_[a-f0-9]{32}$"
              },
              "description": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "url": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "imageUrl": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "updatedAt": {
                "anyOf": [
                  {
                    "type": "string",
                    "format": "date-time",
                    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "ISO 8601 UTC timestamp, or null when unknown."
              },
              "kind": {
                "type": "string",
                "const": "currently"
              },
              "title": {
                "type": "string"
              }
            },
            "required": [
              "id",
              "description",
              "url",
              "imageUrl",
              "updatedAt",
              "kind",
              "title"
            ],
            "additionalProperties": false
          }
        ]
      }
    },
    "meta": {
      "type": "object",
      "properties": {
        "requestId": {
          "type": "string"
        },
        "nextCursor": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "requestId",
        "nextCursor"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "data",
    "meta"
  ],
  "additionalProperties": false
}
GET/api/v1/entities/{id}/products

Read products

Read visible products in owner-defined order. Hidden or unsupported sections return an empty array. An inaccessible parent returns 404.

Request
curl 'https://api-entry-fyi.vercel.app/api/v1/entities/ent_0123456789abcdef0123456789abcdef/products?limit=20'
Response schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "data": {
      "type": "array",
      "items": {
        "oneOf": [
          {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "pattern": "^itm_[a-f0-9]{32}$"
              },
              "description": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "url": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "imageUrl": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "updatedAt": {
                "anyOf": [
                  {
                    "type": "string",
                    "format": "date-time",
                    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "ISO 8601 UTC timestamp, or null when unknown."
              },
              "kind": {
                "type": "string",
                "const": "work"
              },
              "title": {
                "type": "string"
              },
              "organization": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "startDate": {
                "description": "ISO 8601 reduced precision date: YYYY, YYYY-MM, or YYYY-MM-DD. Null when unknown.",
                "type": [
                  "string",
                  "null"
                ]
              },
              "endDate": {
                "description": "ISO 8601 reduced precision date: YYYY, YYYY-MM, or YYYY-MM-DD. Null when unknown.",
                "type": [
                  "string",
                  "null"
                ]
              },
              "current": {
                "type": "boolean"
              }
            },
            "required": [
              "id",
              "description",
              "url",
              "imageUrl",
              "updatedAt",
              "kind",
              "title",
              "organization",
              "startDate",
              "endDate",
              "current"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "pattern": "^itm_[a-f0-9]{32}$"
              },
              "description": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "url": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "imageUrl": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "updatedAt": {
                "anyOf": [
                  {
                    "type": "string",
                    "format": "date-time",
                    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "ISO 8601 UTC timestamp, or null when unknown."
              },
              "kind": {
                "type": "string",
                "const": "project"
              },
              "name": {
                "type": "string"
              },
              "role": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "date": {
                "description": "ISO 8601 reduced precision date: YYYY, YYYY-MM, or YYYY-MM-DD. Null when unknown.",
                "type": [
                  "string",
                  "null"
                ]
              }
            },
            "required": [
              "id",
              "description",
              "url",
              "imageUrl",
              "updatedAt",
              "kind",
              "name",
              "role",
              "date"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "pattern": "^itm_[a-f0-9]{32}$"
              },
              "description": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "url": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "imageUrl": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "updatedAt": {
                "anyOf": [
                  {
                    "type": "string",
                    "format": "date-time",
                    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "ISO 8601 UTC timestamp, or null when unknown."
              },
              "kind": {
                "type": "string",
                "const": "product"
              },
              "name": {
                "type": "string"
              },
              "status": {
                "type": [
                  "string",
                  "null"
                ]
              }
            },
            "required": [
              "id",
              "description",
              "url",
              "imageUrl",
              "updatedAt",
              "kind",
              "name",
              "status"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "pattern": "^itm_[a-f0-9]{32}$"
              },
              "description": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "url": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "imageUrl": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "updatedAt": {
                "anyOf": [
                  {
                    "type": "string",
                    "format": "date-time",
                    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "ISO 8601 UTC timestamp, or null when unknown."
              },
              "kind": {
                "type": "string",
                "const": "person"
              },
              "name": {
                "type": "string"
              },
              "role": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "place": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "entryUsername": {
                "description": "Owner-published reference, not evidence of affiliation.",
                "type": [
                  "string",
                  "null"
                ]
              },
              "entryUrl": {
                "type": [
                  "string",
                  "null"
                ]
              }
            },
            "required": [
              "id",
              "description",
              "url",
              "imageUrl",
              "updatedAt",
              "kind",
              "name",
              "role",
              "place",
              "entryUsername",
              "entryUrl"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "pattern": "^itm_[a-f0-9]{32}$"
              },
              "description": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "url": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "imageUrl": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "updatedAt": {
                "anyOf": [
                  {
                    "type": "string",
                    "format": "date-time",
                    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "ISO 8601 UTC timestamp, or null when unknown."
              },
              "kind": {
                "type": "string",
                "const": "highlight"
              },
              "title": {
                "type": "string"
              },
              "type": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "date": {
                "description": "ISO 8601 reduced precision date: YYYY, YYYY-MM, or YYYY-MM-DD. Null when unknown.",
                "type": [
                  "string",
                  "null"
                ]
              },
              "place": {
                "type": [
                  "string",
                  "null"
                ]
              }
            },
            "required": [
              "id",
              "description",
              "url",
              "imageUrl",
              "updatedAt",
              "kind",
              "title",
              "type",
              "date",
              "place"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "pattern": "^itm_[a-f0-9]{32}$"
              },
              "description": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "url": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "imageUrl": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "updatedAt": {
                "anyOf": [
                  {
                    "type": "string",
                    "format": "date-time",
                    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "ISO 8601 UTC timestamp, or null when unknown."
              },
              "kind": {
                "type": "string",
                "const": "post"
              },
              "title": {
                "type": "string"
              },
              "publication": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "date": {
                "description": "ISO 8601 reduced precision date: YYYY, YYYY-MM, or YYYY-MM-DD. Null when unknown.",
                "type": [
                  "string",
                  "null"
                ]
              },
              "topics": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            },
            "required": [
              "id",
              "description",
              "url",
              "imageUrl",
              "updatedAt",
              "kind",
              "title",
              "publication",
              "date",
              "topics"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "pattern": "^itm_[a-f0-9]{32}$"
              },
              "description": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "url": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "imageUrl": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "updatedAt": {
                "anyOf": [
                  {
                    "type": "string",
                    "format": "date-time",
                    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "ISO 8601 UTC timestamp, or null when unknown."
              },
              "kind": {
                "type": "string",
                "const": "currently"
              },
              "title": {
                "type": "string"
              }
            },
            "required": [
              "id",
              "description",
              "url",
              "imageUrl",
              "updatedAt",
              "kind",
              "title"
            ],
            "additionalProperties": false
          }
        ]
      }
    },
    "meta": {
      "type": "object",
      "properties": {
        "requestId": {
          "type": "string"
        },
        "nextCursor": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "requestId",
        "nextCursor"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "data",
    "meta"
  ],
  "additionalProperties": false
}
GET/api/v1/entities/{id}/people

Read people

Read visible people in owner-defined order. Hidden or unsupported sections return an empty array. An inaccessible parent returns 404.

Request
curl 'https://api-entry-fyi.vercel.app/api/v1/entities/ent_0123456789abcdef0123456789abcdef/people?limit=20'
Response schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "data": {
      "type": "array",
      "items": {
        "oneOf": [
          {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "pattern": "^itm_[a-f0-9]{32}$"
              },
              "description": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "url": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "imageUrl": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "updatedAt": {
                "anyOf": [
                  {
                    "type": "string",
                    "format": "date-time",
                    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "ISO 8601 UTC timestamp, or null when unknown."
              },
              "kind": {
                "type": "string",
                "const": "work"
              },
              "title": {
                "type": "string"
              },
              "organization": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "startDate": {
                "description": "ISO 8601 reduced precision date: YYYY, YYYY-MM, or YYYY-MM-DD. Null when unknown.",
                "type": [
                  "string",
                  "null"
                ]
              },
              "endDate": {
                "description": "ISO 8601 reduced precision date: YYYY, YYYY-MM, or YYYY-MM-DD. Null when unknown.",
                "type": [
                  "string",
                  "null"
                ]
              },
              "current": {
                "type": "boolean"
              }
            },
            "required": [
              "id",
              "description",
              "url",
              "imageUrl",
              "updatedAt",
              "kind",
              "title",
              "organization",
              "startDate",
              "endDate",
              "current"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "pattern": "^itm_[a-f0-9]{32}$"
              },
              "description": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "url": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "imageUrl": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "updatedAt": {
                "anyOf": [
                  {
                    "type": "string",
                    "format": "date-time",
                    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "ISO 8601 UTC timestamp, or null when unknown."
              },
              "kind": {
                "type": "string",
                "const": "project"
              },
              "name": {
                "type": "string"
              },
              "role": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "date": {
                "description": "ISO 8601 reduced precision date: YYYY, YYYY-MM, or YYYY-MM-DD. Null when unknown.",
                "type": [
                  "string",
                  "null"
                ]
              }
            },
            "required": [
              "id",
              "description",
              "url",
              "imageUrl",
              "updatedAt",
              "kind",
              "name",
              "role",
              "date"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "pattern": "^itm_[a-f0-9]{32}$"
              },
              "description": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "url": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "imageUrl": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "updatedAt": {
                "anyOf": [
                  {
                    "type": "string",
                    "format": "date-time",
                    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "ISO 8601 UTC timestamp, or null when unknown."
              },
              "kind": {
                "type": "string",
                "const": "product"
              },
              "name": {
                "type": "string"
              },
              "status": {
                "type": [
                  "string",
                  "null"
                ]
              }
            },
            "required": [
              "id",
              "description",
              "url",
              "imageUrl",
              "updatedAt",
              "kind",
              "name",
              "status"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "pattern": "^itm_[a-f0-9]{32}$"
              },
              "description": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "url": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "imageUrl": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "updatedAt": {
                "anyOf": [
                  {
                    "type": "string",
                    "format": "date-time",
                    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "ISO 8601 UTC timestamp, or null when unknown."
              },
              "kind": {
                "type": "string",
                "const": "person"
              },
              "name": {
                "type": "string"
              },
              "role": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "place": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "entryUsername": {
                "description": "Owner-published reference, not evidence of affiliation.",
                "type": [
                  "string",
                  "null"
                ]
              },
              "entryUrl": {
                "type": [
                  "string",
                  "null"
                ]
              }
            },
            "required": [
              "id",
              "description",
              "url",
              "imageUrl",
              "updatedAt",
              "kind",
              "name",
              "role",
              "place",
              "entryUsername",
              "entryUrl"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "pattern": "^itm_[a-f0-9]{32}$"
              },
              "description": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "url": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "imageUrl": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "updatedAt": {
                "anyOf": [
                  {
                    "type": "string",
                    "format": "date-time",
                    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "ISO 8601 UTC timestamp, or null when unknown."
              },
              "kind": {
                "type": "string",
                "const": "highlight"
              },
              "title": {
                "type": "string"
              },
              "type": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "date": {
                "description": "ISO 8601 reduced precision date: YYYY, YYYY-MM, or YYYY-MM-DD. Null when unknown.",
                "type": [
                  "string",
                  "null"
                ]
              },
              "place": {
                "type": [
                  "string",
                  "null"
                ]
              }
            },
            "required": [
              "id",
              "description",
              "url",
              "imageUrl",
              "updatedAt",
              "kind",
              "title",
              "type",
              "date",
              "place"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "pattern": "^itm_[a-f0-9]{32}$"
              },
              "description": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "url": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "imageUrl": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "updatedAt": {
                "anyOf": [
                  {
                    "type": "string",
                    "format": "date-time",
                    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "ISO 8601 UTC timestamp, or null when unknown."
              },
              "kind": {
                "type": "string",
                "const": "post"
              },
              "title": {
                "type": "string"
              },
              "publication": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "date": {
                "description": "ISO 8601 reduced precision date: YYYY, YYYY-MM, or YYYY-MM-DD. Null when unknown.",
                "type": [
                  "string",
                  "null"
                ]
              },
              "topics": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            },
            "required": [
              "id",
              "description",
              "url",
              "imageUrl",
              "updatedAt",
              "kind",
              "title",
              "publication",
              "date",
              "topics"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "pattern": "^itm_[a-f0-9]{32}$"
              },
              "description": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "url": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "imageUrl": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "updatedAt": {
                "anyOf": [
                  {
                    "type": "string",
                    "format": "date-time",
                    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "ISO 8601 UTC timestamp, or null when unknown."
              },
              "kind": {
                "type": "string",
                "const": "currently"
              },
              "title": {
                "type": "string"
              }
            },
            "required": [
              "id",
              "description",
              "url",
              "imageUrl",
              "updatedAt",
              "kind",
              "title"
            ],
            "additionalProperties": false
          }
        ]
      }
    },
    "meta": {
      "type": "object",
      "properties": {
        "requestId": {
          "type": "string"
        },
        "nextCursor": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "requestId",
        "nextCursor"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "data",
    "meta"
  ],
  "additionalProperties": false
}
GET/api/v1/entities/{id}/highlights

Read highlights

Read visible highlights in owner-defined order. Hidden or unsupported sections return an empty array. An inaccessible parent returns 404.

Request
curl 'https://api-entry-fyi.vercel.app/api/v1/entities/ent_0123456789abcdef0123456789abcdef/highlights?limit=20'
Response schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "data": {
      "type": "array",
      "items": {
        "oneOf": [
          {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "pattern": "^itm_[a-f0-9]{32}$"
              },
              "description": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "url": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "imageUrl": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "updatedAt": {
                "anyOf": [
                  {
                    "type": "string",
                    "format": "date-time",
                    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "ISO 8601 UTC timestamp, or null when unknown."
              },
              "kind": {
                "type": "string",
                "const": "work"
              },
              "title": {
                "type": "string"
              },
              "organization": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "startDate": {
                "description": "ISO 8601 reduced precision date: YYYY, YYYY-MM, or YYYY-MM-DD. Null when unknown.",
                "type": [
                  "string",
                  "null"
                ]
              },
              "endDate": {
                "description": "ISO 8601 reduced precision date: YYYY, YYYY-MM, or YYYY-MM-DD. Null when unknown.",
                "type": [
                  "string",
                  "null"
                ]
              },
              "current": {
                "type": "boolean"
              }
            },
            "required": [
              "id",
              "description",
              "url",
              "imageUrl",
              "updatedAt",
              "kind",
              "title",
              "organization",
              "startDate",
              "endDate",
              "current"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "pattern": "^itm_[a-f0-9]{32}$"
              },
              "description": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "url": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "imageUrl": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "updatedAt": {
                "anyOf": [
                  {
                    "type": "string",
                    "format": "date-time",
                    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "ISO 8601 UTC timestamp, or null when unknown."
              },
              "kind": {
                "type": "string",
                "const": "project"
              },
              "name": {
                "type": "string"
              },
              "role": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "date": {
                "description": "ISO 8601 reduced precision date: YYYY, YYYY-MM, or YYYY-MM-DD. Null when unknown.",
                "type": [
                  "string",
                  "null"
                ]
              }
            },
            "required": [
              "id",
              "description",
              "url",
              "imageUrl",
              "updatedAt",
              "kind",
              "name",
              "role",
              "date"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "pattern": "^itm_[a-f0-9]{32}$"
              },
              "description": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "url": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "imageUrl": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "updatedAt": {
                "anyOf": [
                  {
                    "type": "string",
                    "format": "date-time",
                    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "ISO 8601 UTC timestamp, or null when unknown."
              },
              "kind": {
                "type": "string",
                "const": "product"
              },
              "name": {
                "type": "string"
              },
              "status": {
                "type": [
                  "string",
                  "null"
                ]
              }
            },
            "required": [
              "id",
              "description",
              "url",
              "imageUrl",
              "updatedAt",
              "kind",
              "name",
              "status"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "pattern": "^itm_[a-f0-9]{32}$"
              },
              "description": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "url": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "imageUrl": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "updatedAt": {
                "anyOf": [
                  {
                    "type": "string",
                    "format": "date-time",
                    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "ISO 8601 UTC timestamp, or null when unknown."
              },
              "kind": {
                "type": "string",
                "const": "person"
              },
              "name": {
                "type": "string"
              },
              "role": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "place": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "entryUsername": {
                "description": "Owner-published reference, not evidence of affiliation.",
                "type": [
                  "string",
                  "null"
                ]
              },
              "entryUrl": {
                "type": [
                  "string",
                  "null"
                ]
              }
            },
            "required": [
              "id",
              "description",
              "url",
              "imageUrl",
              "updatedAt",
              "kind",
              "name",
              "role",
              "place",
              "entryUsername",
              "entryUrl"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "pattern": "^itm_[a-f0-9]{32}$"
              },
              "description": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "url": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "imageUrl": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "updatedAt": {
                "anyOf": [
                  {
                    "type": "string",
                    "format": "date-time",
                    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "ISO 8601 UTC timestamp, or null when unknown."
              },
              "kind": {
                "type": "string",
                "const": "highlight"
              },
              "title": {
                "type": "string"
              },
              "type": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "date": {
                "description": "ISO 8601 reduced precision date: YYYY, YYYY-MM, or YYYY-MM-DD. Null when unknown.",
                "type": [
                  "string",
                  "null"
                ]
              },
              "place": {
                "type": [
                  "string",
                  "null"
                ]
              }
            },
            "required": [
              "id",
              "description",
              "url",
              "imageUrl",
              "updatedAt",
              "kind",
              "title",
              "type",
              "date",
              "place"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "pattern": "^itm_[a-f0-9]{32}$"
              },
              "description": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "url": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "imageUrl": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "updatedAt": {
                "anyOf": [
                  {
                    "type": "string",
                    "format": "date-time",
                    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "ISO 8601 UTC timestamp, or null when unknown."
              },
              "kind": {
                "type": "string",
                "const": "post"
              },
              "title": {
                "type": "string"
              },
              "publication": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "date": {
                "description": "ISO 8601 reduced precision date: YYYY, YYYY-MM, or YYYY-MM-DD. Null when unknown.",
                "type": [
                  "string",
                  "null"
                ]
              },
              "topics": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            },
            "required": [
              "id",
              "description",
              "url",
              "imageUrl",
              "updatedAt",
              "kind",
              "title",
              "publication",
              "date",
              "topics"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "pattern": "^itm_[a-f0-9]{32}$"
              },
              "description": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "url": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "imageUrl": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "updatedAt": {
                "anyOf": [
                  {
                    "type": "string",
                    "format": "date-time",
                    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "ISO 8601 UTC timestamp, or null when unknown."
              },
              "kind": {
                "type": "string",
                "const": "currently"
              },
              "title": {
                "type": "string"
              }
            },
            "required": [
              "id",
              "description",
              "url",
              "imageUrl",
              "updatedAt",
              "kind",
              "title"
            ],
            "additionalProperties": false
          }
        ]
      }
    },
    "meta": {
      "type": "object",
      "properties": {
        "requestId": {
          "type": "string"
        },
        "nextCursor": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "requestId",
        "nextCursor"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "data",
    "meta"
  ],
  "additionalProperties": false
}
GET/api/v1/entities/{id}/writing

Read writing

Read visible writing in owner-defined order. Hidden or unsupported sections return an empty array. An inaccessible parent returns 404.

Request
curl 'https://api-entry-fyi.vercel.app/api/v1/entities/ent_0123456789abcdef0123456789abcdef/writing?limit=20'
Response schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "data": {
      "type": "array",
      "items": {
        "oneOf": [
          {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "pattern": "^itm_[a-f0-9]{32}$"
              },
              "description": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "url": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "imageUrl": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "updatedAt": {
                "anyOf": [
                  {
                    "type": "string",
                    "format": "date-time",
                    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "ISO 8601 UTC timestamp, or null when unknown."
              },
              "kind": {
                "type": "string",
                "const": "work"
              },
              "title": {
                "type": "string"
              },
              "organization": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "startDate": {
                "description": "ISO 8601 reduced precision date: YYYY, YYYY-MM, or YYYY-MM-DD. Null when unknown.",
                "type": [
                  "string",
                  "null"
                ]
              },
              "endDate": {
                "description": "ISO 8601 reduced precision date: YYYY, YYYY-MM, or YYYY-MM-DD. Null when unknown.",
                "type": [
                  "string",
                  "null"
                ]
              },
              "current": {
                "type": "boolean"
              }
            },
            "required": [
              "id",
              "description",
              "url",
              "imageUrl",
              "updatedAt",
              "kind",
              "title",
              "organization",
              "startDate",
              "endDate",
              "current"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "pattern": "^itm_[a-f0-9]{32}$"
              },
              "description": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "url": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "imageUrl": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "updatedAt": {
                "anyOf": [
                  {
                    "type": "string",
                    "format": "date-time",
                    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "ISO 8601 UTC timestamp, or null when unknown."
              },
              "kind": {
                "type": "string",
                "const": "project"
              },
              "name": {
                "type": "string"
              },
              "role": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "date": {
                "description": "ISO 8601 reduced precision date: YYYY, YYYY-MM, or YYYY-MM-DD. Null when unknown.",
                "type": [
                  "string",
                  "null"
                ]
              }
            },
            "required": [
              "id",
              "description",
              "url",
              "imageUrl",
              "updatedAt",
              "kind",
              "name",
              "role",
              "date"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "pattern": "^itm_[a-f0-9]{32}$"
              },
              "description": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "url": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "imageUrl": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "updatedAt": {
                "anyOf": [
                  {
                    "type": "string",
                    "format": "date-time",
                    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "ISO 8601 UTC timestamp, or null when unknown."
              },
              "kind": {
                "type": "string",
                "const": "product"
              },
              "name": {
                "type": "string"
              },
              "status": {
                "type": [
                  "string",
                  "null"
                ]
              }
            },
            "required": [
              "id",
              "description",
              "url",
              "imageUrl",
              "updatedAt",
              "kind",
              "name",
              "status"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "pattern": "^itm_[a-f0-9]{32}$"
              },
              "description": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "url": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "imageUrl": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "updatedAt": {
                "anyOf": [
                  {
                    "type": "string",
                    "format": "date-time",
                    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "ISO 8601 UTC timestamp, or null when unknown."
              },
              "kind": {
                "type": "string",
                "const": "person"
              },
              "name": {
                "type": "string"
              },
              "role": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "place": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "entryUsername": {
                "description": "Owner-published reference, not evidence of affiliation.",
                "type": [
                  "string",
                  "null"
                ]
              },
              "entryUrl": {
                "type": [
                  "string",
                  "null"
                ]
              }
            },
            "required": [
              "id",
              "description",
              "url",
              "imageUrl",
              "updatedAt",
              "kind",
              "name",
              "role",
              "place",
              "entryUsername",
              "entryUrl"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "pattern": "^itm_[a-f0-9]{32}$"
              },
              "description": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "url": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "imageUrl": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "updatedAt": {
                "anyOf": [
                  {
                    "type": "string",
                    "format": "date-time",
                    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "ISO 8601 UTC timestamp, or null when unknown."
              },
              "kind": {
                "type": "string",
                "const": "highlight"
              },
              "title": {
                "type": "string"
              },
              "type": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "date": {
                "description": "ISO 8601 reduced precision date: YYYY, YYYY-MM, or YYYY-MM-DD. Null when unknown.",
                "type": [
                  "string",
                  "null"
                ]
              },
              "place": {
                "type": [
                  "string",
                  "null"
                ]
              }
            },
            "required": [
              "id",
              "description",
              "url",
              "imageUrl",
              "updatedAt",
              "kind",
              "title",
              "type",
              "date",
              "place"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "pattern": "^itm_[a-f0-9]{32}$"
              },
              "description": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "url": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "imageUrl": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "updatedAt": {
                "anyOf": [
                  {
                    "type": "string",
                    "format": "date-time",
                    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "ISO 8601 UTC timestamp, or null when unknown."
              },
              "kind": {
                "type": "string",
                "const": "post"
              },
              "title": {
                "type": "string"
              },
              "publication": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "date": {
                "description": "ISO 8601 reduced precision date: YYYY, YYYY-MM, or YYYY-MM-DD. Null when unknown.",
                "type": [
                  "string",
                  "null"
                ]
              },
              "topics": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            },
            "required": [
              "id",
              "description",
              "url",
              "imageUrl",
              "updatedAt",
              "kind",
              "title",
              "publication",
              "date",
              "topics"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "pattern": "^itm_[a-f0-9]{32}$"
              },
              "description": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "url": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "imageUrl": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "updatedAt": {
                "anyOf": [
                  {
                    "type": "string",
                    "format": "date-time",
                    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "ISO 8601 UTC timestamp, or null when unknown."
              },
              "kind": {
                "type": "string",
                "const": "currently"
              },
              "title": {
                "type": "string"
              }
            },
            "required": [
              "id",
              "description",
              "url",
              "imageUrl",
              "updatedAt",
              "kind",
              "title"
            ],
            "additionalProperties": false
          }
        ]
      }
    },
    "meta": {
      "type": "object",
      "properties": {
        "requestId": {
          "type": "string"
        },
        "nextCursor": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "requestId",
        "nextCursor"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "data",
    "meta"
  ],
  "additionalProperties": false
}
GET/api/v1/entities/{id}/currently

Read currently

Read visible currently in owner-defined order. Hidden or unsupported sections return an empty array. An inaccessible parent returns 404.

Request
curl 'https://api-entry-fyi.vercel.app/api/v1/entities/ent_0123456789abcdef0123456789abcdef/currently?limit=20'
Response schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "data": {
      "type": "array",
      "items": {
        "oneOf": [
          {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "pattern": "^itm_[a-f0-9]{32}$"
              },
              "description": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "url": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "imageUrl": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "updatedAt": {
                "anyOf": [
                  {
                    "type": "string",
                    "format": "date-time",
                    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "ISO 8601 UTC timestamp, or null when unknown."
              },
              "kind": {
                "type": "string",
                "const": "work"
              },
              "title": {
                "type": "string"
              },
              "organization": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "startDate": {
                "description": "ISO 8601 reduced precision date: YYYY, YYYY-MM, or YYYY-MM-DD. Null when unknown.",
                "type": [
                  "string",
                  "null"
                ]
              },
              "endDate": {
                "description": "ISO 8601 reduced precision date: YYYY, YYYY-MM, or YYYY-MM-DD. Null when unknown.",
                "type": [
                  "string",
                  "null"
                ]
              },
              "current": {
                "type": "boolean"
              }
            },
            "required": [
              "id",
              "description",
              "url",
              "imageUrl",
              "updatedAt",
              "kind",
              "title",
              "organization",
              "startDate",
              "endDate",
              "current"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "pattern": "^itm_[a-f0-9]{32}$"
              },
              "description": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "url": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "imageUrl": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "updatedAt": {
                "anyOf": [
                  {
                    "type": "string",
                    "format": "date-time",
                    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "ISO 8601 UTC timestamp, or null when unknown."
              },
              "kind": {
                "type": "string",
                "const": "project"
              },
              "name": {
                "type": "string"
              },
              "role": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "date": {
                "description": "ISO 8601 reduced precision date: YYYY, YYYY-MM, or YYYY-MM-DD. Null when unknown.",
                "type": [
                  "string",
                  "null"
                ]
              }
            },
            "required": [
              "id",
              "description",
              "url",
              "imageUrl",
              "updatedAt",
              "kind",
              "name",
              "role",
              "date"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "pattern": "^itm_[a-f0-9]{32}$"
              },
              "description": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "url": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "imageUrl": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "updatedAt": {
                "anyOf": [
                  {
                    "type": "string",
                    "format": "date-time",
                    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "ISO 8601 UTC timestamp, or null when unknown."
              },
              "kind": {
                "type": "string",
                "const": "product"
              },
              "name": {
                "type": "string"
              },
              "status": {
                "type": [
                  "string",
                  "null"
                ]
              }
            },
            "required": [
              "id",
              "description",
              "url",
              "imageUrl",
              "updatedAt",
              "kind",
              "name",
              "status"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "pattern": "^itm_[a-f0-9]{32}$"
              },
              "description": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "url": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "imageUrl": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "updatedAt": {
                "anyOf": [
                  {
                    "type": "string",
                    "format": "date-time",
                    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "ISO 8601 UTC timestamp, or null when unknown."
              },
              "kind": {
                "type": "string",
                "const": "person"
              },
              "name": {
                "type": "string"
              },
              "role": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "place": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "entryUsername": {
                "description": "Owner-published reference, not evidence of affiliation.",
                "type": [
                  "string",
                  "null"
                ]
              },
              "entryUrl": {
                "type": [
                  "string",
                  "null"
                ]
              }
            },
            "required": [
              "id",
              "description",
              "url",
              "imageUrl",
              "updatedAt",
              "kind",
              "name",
              "role",
              "place",
              "entryUsername",
              "entryUrl"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "pattern": "^itm_[a-f0-9]{32}$"
              },
              "description": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "url": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "imageUrl": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "updatedAt": {
                "anyOf": [
                  {
                    "type": "string",
                    "format": "date-time",
                    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "ISO 8601 UTC timestamp, or null when unknown."
              },
              "kind": {
                "type": "string",
                "const": "highlight"
              },
              "title": {
                "type": "string"
              },
              "type": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "date": {
                "description": "ISO 8601 reduced precision date: YYYY, YYYY-MM, or YYYY-MM-DD. Null when unknown.",
                "type": [
                  "string",
                  "null"
                ]
              },
              "place": {
                "type": [
                  "string",
                  "null"
                ]
              }
            },
            "required": [
              "id",
              "description",
              "url",
              "imageUrl",
              "updatedAt",
              "kind",
              "title",
              "type",
              "date",
              "place"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "pattern": "^itm_[a-f0-9]{32}$"
              },
              "description": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "url": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "imageUrl": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "updatedAt": {
                "anyOf": [
                  {
                    "type": "string",
                    "format": "date-time",
                    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "ISO 8601 UTC timestamp, or null when unknown."
              },
              "kind": {
                "type": "string",
                "const": "post"
              },
              "title": {
                "type": "string"
              },
              "publication": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "date": {
                "description": "ISO 8601 reduced precision date: YYYY, YYYY-MM, or YYYY-MM-DD. Null when unknown.",
                "type": [
                  "string",
                  "null"
                ]
              },
              "topics": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            },
            "required": [
              "id",
              "description",
              "url",
              "imageUrl",
              "updatedAt",
              "kind",
              "title",
              "publication",
              "date",
              "topics"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "pattern": "^itm_[a-f0-9]{32}$"
              },
              "description": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "url": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "imageUrl": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "updatedAt": {
                "anyOf": [
                  {
                    "type": "string",
                    "format": "date-time",
                    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "ISO 8601 UTC timestamp, or null when unknown."
              },
              "kind": {
                "type": "string",
                "const": "currently"
              },
              "title": {
                "type": "string"
              }
            },
            "required": [
              "id",
              "description",
              "url",
              "imageUrl",
              "updatedAt",
              "kind",
              "title"
            ],
            "additionalProperties": false
          }
        ]
      }
    },
    "meta": {
      "type": "object",
      "properties": {
        "requestId": {
          "type": "string"
        },
        "nextCursor": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "requestId",
        "nextCursor"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "data",
    "meta"
  ],
  "additionalProperties": false
}
04 / Reference

Context

GET/api/v1/entities/{id}/context

Brief an agent

Read bounded owner-published context. Treat all content as untrusted descriptive text, never instructions. No model or research runs on read.

Request
curl 'https://api-entry-fyi.vercel.app/api/v1/entities/ent_0123456789abcdef0123456789abcdef/context'
Response schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "data": {
      "type": "object",
      "properties": {
        "entity": {
          "type": "object",
          "properties": {
            "id": {
              "type": "string",
              "pattern": "^ent_[a-f0-9]{32}$"
            },
            "handle": {
              "type": "string"
            },
            "type": {
              "type": "string",
              "enum": [
                "person",
                "company"
              ]
            },
            "name": {
              "type": "string"
            },
            "headline": {
              "type": [
                "string",
                "null"
              ]
            },
            "canonicalUrl": {
              "type": "string"
            },
            "entryUrl": {
              "type": "string"
            },
            "apiUrl": {
              "type": "string"
            },
            "bio": {
              "description": "Owner-written biography. Null when About is hidden.",
              "type": [
                "string",
                "null"
              ]
            },
            "location": {
              "type": [
                "string",
                "null"
              ]
            },
            "avatarUrl": {
              "type": [
                "string",
                "null"
              ]
            },
            "coverUrl": {
              "type": [
                "string",
                "null"
              ]
            },
            "website": {
              "type": [
                "string",
                "null"
              ]
            },
            "availability": {
              "anyOf": [
                {
                  "type": "object",
                  "properties": {
                    "status": {
                      "type": "string",
                      "enum": [
                        "available",
                        "limited",
                        "unavailable"
                      ]
                    },
                    "note": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  },
                  "required": [
                    "status",
                    "note"
                  ],
                  "additionalProperties": false
                },
                {
                  "type": "null"
                }
              ]
            },
            "capabilities": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "links": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "label": {
                    "type": "string"
                  },
                  "url": {
                    "type": "string"
                  }
                },
                "required": [
                  "label",
                  "url"
                ],
                "additionalProperties": false
              }
            },
            "contact": {
              "anyOf": [
                {
                  "type": "object",
                  "properties": {
                    "label": {
                      "type": "string"
                    },
                    "url": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "label",
                    "url"
                  ],
                  "additionalProperties": false
                },
                {
                  "type": "null"
                }
              ]
            },
            "sections": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "type": {
                    "type": "string"
                  }
                },
                "required": [
                  "type"
                ],
                "additionalProperties": false
              }
            },
            "profileUpdatedAt": {
              "anyOf": [
                {
                  "type": "string",
                  "format": "date-time",
                  "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Profile modification time, not external fact verification."
            }
          },
          "required": [
            "id",
            "handle",
            "type",
            "name",
            "headline",
            "canonicalUrl",
            "entryUrl",
            "apiUrl",
            "bio",
            "location",
            "avatarUrl",
            "coverUrl",
            "website",
            "availability",
            "capabilities",
            "links",
            "contact",
            "sections",
            "profileUpdatedAt"
          ],
          "additionalProperties": false
        },
        "collections": {
          "type": "object",
          "propertyNames": {
            "type": "string",
            "enum": [
              "work",
              "projects",
              "products",
              "people",
              "highlights",
              "writing",
              "currently"
            ]
          },
          "additionalProperties": {
            "type": "object",
            "properties": {
              "items": {
                "type": "array",
                "items": {
                  "oneOf": [
                    {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "pattern": "^itm_[a-f0-9]{32}$"
                        },
                        "description": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "url": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "imageUrl": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "updatedAt": {
                          "anyOf": [
                            {
                              "type": "string",
                              "format": "date-time",
                              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "ISO 8601 UTC timestamp, or null when unknown."
                        },
                        "kind": {
                          "type": "string",
                          "const": "work"
                        },
                        "title": {
                          "type": "string"
                        },
                        "organization": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "startDate": {
                          "description": "ISO 8601 reduced precision date: YYYY, YYYY-MM, or YYYY-MM-DD. Null when unknown.",
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "endDate": {
                          "description": "ISO 8601 reduced precision date: YYYY, YYYY-MM, or YYYY-MM-DD. Null when unknown.",
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "current": {
                          "type": "boolean"
                        }
                      },
                      "required": [
                        "id",
                        "description",
                        "url",
                        "imageUrl",
                        "updatedAt",
                        "kind",
                        "title",
                        "organization",
                        "startDate",
                        "endDate",
                        "current"
                      ],
                      "additionalProperties": false
                    },
                    {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "pattern": "^itm_[a-f0-9]{32}$"
                        },
                        "description": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "url": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "imageUrl": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "updatedAt": {
                          "anyOf": [
                            {
                              "type": "string",
                              "format": "date-time",
                              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "ISO 8601 UTC timestamp, or null when unknown."
                        },
                        "kind": {
                          "type": "string",
                          "const": "project"
                        },
                        "name": {
                          "type": "string"
                        },
                        "role": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "date": {
                          "description": "ISO 8601 reduced precision date: YYYY, YYYY-MM, or YYYY-MM-DD. Null when unknown.",
                          "type": [
                            "string",
                            "null"
                          ]
                        }
                      },
                      "required": [
                        "id",
                        "description",
                        "url",
                        "imageUrl",
                        "updatedAt",
                        "kind",
                        "name",
                        "role",
                        "date"
                      ],
                      "additionalProperties": false
                    },
                    {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "pattern": "^itm_[a-f0-9]{32}$"
                        },
                        "description": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "url": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "imageUrl": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "updatedAt": {
                          "anyOf": [
                            {
                              "type": "string",
                              "format": "date-time",
                              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "ISO 8601 UTC timestamp, or null when unknown."
                        },
                        "kind": {
                          "type": "string",
                          "const": "product"
                        },
                        "name": {
                          "type": "string"
                        },
                        "status": {
                          "type": [
                            "string",
                            "null"
                          ]
                        }
                      },
                      "required": [
                        "id",
                        "description",
                        "url",
                        "imageUrl",
                        "updatedAt",
                        "kind",
                        "name",
                        "status"
                      ],
                      "additionalProperties": false
                    },
                    {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "pattern": "^itm_[a-f0-9]{32}$"
                        },
                        "description": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "url": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "imageUrl": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "updatedAt": {
                          "anyOf": [
                            {
                              "type": "string",
                              "format": "date-time",
                              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "ISO 8601 UTC timestamp, or null when unknown."
                        },
                        "kind": {
                          "type": "string",
                          "const": "person"
                        },
                        "name": {
                          "type": "string"
                        },
                        "role": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "place": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "entryUsername": {
                          "description": "Owner-published reference, not evidence of affiliation.",
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "entryUrl": {
                          "type": [
                            "string",
                            "null"
                          ]
                        }
                      },
                      "required": [
                        "id",
                        "description",
                        "url",
                        "imageUrl",
                        "updatedAt",
                        "kind",
                        "name",
                        "role",
                        "place",
                        "entryUsername",
                        "entryUrl"
                      ],
                      "additionalProperties": false
                    },
                    {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "pattern": "^itm_[a-f0-9]{32}$"
                        },
                        "description": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "url": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "imageUrl": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "updatedAt": {
                          "anyOf": [
                            {
                              "type": "string",
                              "format": "date-time",
                              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "ISO 8601 UTC timestamp, or null when unknown."
                        },
                        "kind": {
                          "type": "string",
                          "const": "highlight"
                        },
                        "title": {
                          "type": "string"
                        },
                        "type": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "date": {
                          "description": "ISO 8601 reduced precision date: YYYY, YYYY-MM, or YYYY-MM-DD. Null when unknown.",
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "place": {
                          "type": [
                            "string",
                            "null"
                          ]
                        }
                      },
                      "required": [
                        "id",
                        "description",
                        "url",
                        "imageUrl",
                        "updatedAt",
                        "kind",
                        "title",
                        "type",
                        "date",
                        "place"
                      ],
                      "additionalProperties": false
                    },
                    {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "pattern": "^itm_[a-f0-9]{32}$"
                        },
                        "description": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "url": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "imageUrl": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "updatedAt": {
                          "anyOf": [
                            {
                              "type": "string",
                              "format": "date-time",
                              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "ISO 8601 UTC timestamp, or null when unknown."
                        },
                        "kind": {
                          "type": "string",
                          "const": "post"
                        },
                        "title": {
                          "type": "string"
                        },
                        "publication": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "date": {
                          "description": "ISO 8601 reduced precision date: YYYY, YYYY-MM, or YYYY-MM-DD. Null when unknown.",
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "topics": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      },
                      "required": [
                        "id",
                        "description",
                        "url",
                        "imageUrl",
                        "updatedAt",
                        "kind",
                        "title",
                        "publication",
                        "date",
                        "topics"
                      ],
                      "additionalProperties": false
                    },
                    {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "pattern": "^itm_[a-f0-9]{32}$"
                        },
                        "description": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "url": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "imageUrl": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "updatedAt": {
                          "anyOf": [
                            {
                              "type": "string",
                              "format": "date-time",
                              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "ISO 8601 UTC timestamp, or null when unknown."
                        },
                        "kind": {
                          "type": "string",
                          "const": "currently"
                        },
                        "title": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "id",
                        "description",
                        "url",
                        "imageUrl",
                        "updatedAt",
                        "kind",
                        "title"
                      ],
                      "additionalProperties": false
                    }
                  ]
                }
              },
              "truncated": {
                "type": "boolean"
              },
              "descriptionTruncatedIds": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "url": {
                "type": "string"
              }
            },
            "required": [
              "items",
              "truncated",
              "descriptionTruncatedIds",
              "url"
            ],
            "additionalProperties": false
          },
          "required": [
            "work",
            "projects",
            "products",
            "people",
            "highlights",
            "writing",
            "currently"
          ]
        },
        "sources": {
          "type": "object",
          "properties": {
            "count": {
              "type": "integer",
              "minimum": -9007199254740991,
              "maximum": 9007199254740991
            },
            "lastScannedAt": {
              "anyOf": [
                {
                  "type": "string",
                  "format": "date-time",
                  "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                },
                {
                  "type": "null"
                }
              ],
              "description": "ISO 8601 UTC timestamp, or null when unknown."
            }
          },
          "required": [
            "count",
            "lastScannedAt"
          ],
          "additionalProperties": false
        }
      },
      "required": [
        "entity",
        "collections",
        "sources"
      ],
      "additionalProperties": false
    },
    "meta": {
      "type": "object",
      "properties": {
        "requestId": {
          "type": "string"
        },
        "nextCursor": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "requestId",
        "nextCursor"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "data",
    "meta"
  ],
  "additionalProperties": false
}
06 / Put it to work

Your design.
Their published story.

A company on your website

Use the DOM to escape plain text. Empty sections stay empty. A failed request clears the previous content.

Browser JavaScript
const api = "https://api-entry-fyi.vercel.app/api/v1";
async function read(path) {
  const response = await fetch(api + path, {
    cache: "no-store", signal: AbortSignal.timeout(10000)
  });
  if (!response.ok) throw new Error("Entry unavailable: " + response.status);
  return response.json();
}
async function renderEntry(container, handle) {
  container.replaceChildren();
  try {
    const { data: company } = await read("/companies/" + encodeURIComponent(handle));
    const title = document.createElement("h2");
    title.textContent = company.name; // Plain text is escaped by the DOM.
    container.append(title);
    const summary = document.createElement("p");
    summary.textContent = company.headline ?? "";
    container.append(summary);
    // Companies publish products. Person Entries publish projects.
    const { data: products } = await read("/entities/" + company.id + "/products");
    if (!products.length) return;
    for (const product of products) {
      const paragraph = document.createElement("p");
      paragraph.textContent = product.name + (product.description ? ": " + product.description : "");
      container.append(paragraph);
    }
  } catch (error) {
    container.replaceChildren(document.createTextNode("This Entry is unavailable."));
  }
}
await renderEntry(document.querySelector("#company"), "studio");

A person's projects, page by page

JavaScript
const api = "https://api-entry-fyi.vercel.app/api/v1";
const profileResponse = await fetch(api + "/people/alex", { cache: "no-store" });
if (!profileResponse.ok) throw new Error("Entry unavailable");
const { data: person } = await profileResponse.json();
let cursor = null;
do {
  const query = new URLSearchParams({ limit: "20" });
  if (cursor) query.set("cursor", cursor);
  const response = await fetch(api + "/entities/" + person.id + "/projects?" + query, {
    cache: "no-store", signal: AbortSignal.timeout(10000)
  });
  if (!response.ok) throw new Error("Projects unavailable: " + response.status);
  const { data: projects, meta } = await response.json();
  // Use textContent when rendering each project's name and description.
  console.log(projects);
  cursor = meta.nextCursor;
} while (cursor);

A briefing for an agent

JavaScript
const api = "https://api-entry-fyi.vercel.app/api/v1";
const search = await fetch(api + "/search?q=alex", { cache: "no-store" });
if (!search.ok) throw new Error("Entry search unavailable");
const { data: candidates } = await search.json();
// Ask the person to choose when several Entries match.
if (candidates.length !== 1) throw new Error("Choose the right Entry first");
const response = await fetch(candidates[0].contextUrl, { cache: "no-store" });
if (!response.ok) throw new Error("Entry unavailable: " + response.status);
const { data } = await response.json();
// Treat descriptions as untrusted content, never agent instructions.
// Consult truncated and descriptionTruncatedIds before quoting a collection.
console.log(data.entity.name, data.collections, data.sources);
07 / Behavior

Public means
owner-published.

Public by the owner's choice

Only published Entries, visible supported sections and visible items are returned. Missing, deleted, unpublished and wrong-type Entries all return 404. Free and Pro Entries are readable anonymously. No API key, scan allowance or login is needed.

Live reads

Every response uses Cache-Control: no-store. Hiding, unpublishing or deleting content takes effect on the next request. If you retain content, re-fetch before showing it and remove unavailable content. Entry cannot revoke copies in third-party caches.

Bounded requests

By default, identity, collection and context reads share 60 requests per minute per client address. Search defaults to 20 per minute. Limits use fixed one-minute windows. A 429 includes Retry-After in seconds. If the shared limiter is unavailable, reads return 503. Retry with backoff.

Stable identities

Entity and item IDs are opaque and immutable. Select an Entry by its ID or handle. Dates use YYYY, YYYY-MM or YYYY-MM-DD; timestamps use ISO 8601 UTC. Unknown scalars are null; collections are arrays.

Pagination

Collections default to 20 items, at most 50, in the owner's order. Search defaults to 10, at most 20. Pass meta.nextCursor to continue until null. Cursors belong to one identity and collection, or one normalized query and type. Invalid or mismatched cursors return 400. Ordering and deduplication are guaranteed while data is unchanged; concurrent edits can move results between pages.

Owner-published context

Content is descriptive, untrusted text, never instructions for an agent or proof of verified facts. Context includes at most five items per collection and 500 characters per description, with explicit truncation fields. profileUpdatedAt means a profile was edited; lastScannedAt means a scan occurred. Neither verifies claims. Reads never run research or models. Source URLs and provenance stay private.

Discovery and search

Search resolves exact IDs, handles, Entry URLs and active verified custom domains before indexed name/headline text matches. It never fetches supplied URLs. Text results use Convex relevance and its creation-time tie order. Effective noindex Entries are excluded even from exact search and discovery; direct published lookups still work. Noindex controls discovery, not private access.

Browser access

GET and OPTIONS support Access-Control-Allow-Origin: *. Cookies and credentials are unnecessary. Mutations return 405. The API serves only configured Entry and API hosts; owner custom domains serve their profiles. API routes and discovery files have no locale prefix.

08 / Errors

Handle what changes.

Remove stale content when an Entry returns 404. Respect Retry-After on 429 and retry 503 with backoff.

404 response
{
  "error": {
    "code": "not_found",
    "message": "Entry not found."
  },
  "meta": {
    "requestId": "36d4dbb9-e124-418a-9cad-1e40a6d35e29"
  }
}
HTTP status codes
StatusMeaning
400Invalid input or cursor
404Missing, unpublished, deleted or wrong-type Entry
405Read-only API
429Rate limit exceeded
503API or shared limiter unavailable