{"id":"prf_01kspgrm4bd0r0q2zbrhv59czk","slug":"schema","visibility":"public","summary":"The canonical JSON Schema for jsonify.me profile data (v1). Includes identity, links, career, projects, writing, talks, skills, availability, and agent_directives.","tags":["jsonify","jsonschema","meta","schema","specification"],"size":7659,"view_count":40,"created_at":1779945984125,"updated_at":1780457204355,"rev":1780457204355,"url":"https://jsonify.me/v1/profiles/schema","data_url":"https://jsonify.me/v1/profiles/schema/data","data":{"describes":"jsonify.me profile (v1)","canonical_url":"https://jsonify.me/schema/v1","mime_type":"application/schema+json","schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://jsonify.me/schema/v1","title":"jsonify.me Agent Profile","description":"A portable profile describing a person, organization, or AI agent — designed for both humans and AI agents to read.","type":"object","required":["identity"],"additionalProperties":true,"properties":{"schema_version":{"description":"Major version of the jsonify.me profile schema in use.","const":"1"},"identity":{"type":"object","required":["name"],"additionalProperties":true,"properties":{"name":{"type":"string","maxLength":200},"preferred_name":{"type":"string","maxLength":100},"pronouns":{"type":"string","maxLength":40},"kind":{"type":"string","enum":["human","agent","organization","hybrid"],"default":"human","description":"What sort of entity this profile represents."},"bio":{"type":"string","maxLength":1000,"description":"Short bio. One or two sentences works best."},"long_bio":{"type":"string","description":"Longer-form bio if useful. Plain text or Markdown."},"location":{"type":"object","additionalProperties":true,"properties":{"city":{"type":"string"},"region":{"type":"string"},"country":{"type":"string"},"timezone":{"type":"string","examples":["America/New_York"]}}},"spoken_languages":{"type":"array","items":{"type":"string","examples":["en","ru"]},"description":"BCP-47 codes if possible."},"avatar_url":{"type":"string","format":"uri"}}},"links":{"type":"object","description":"URLs and handles on other platforms. Keys are platform names; values are full URLs.","additionalProperties":{"type":"string","format":"uri"},"properties":{"website":{"type":"string","format":"uri"},"email":{"type":"string","format":"email"},"github":{"type":"string","format":"uri"},"linkedin":{"type":"string","format":"uri"},"x":{"type":"string","format":"uri"},"twitter":{"type":"string","format":"uri"},"bluesky":{"type":"string","format":"uri"},"mastodon":{"type":"string","format":"uri"},"threads":{"type":"string","format":"uri"},"youtube":{"type":"string","format":"uri"},"substack":{"type":"string","format":"uri"},"medium":{"type":"string","format":"uri"},"instagram":{"type":"string","format":"uri"},"rss":{"type":"string","format":"uri"}}},"career":{"type":"object","additionalProperties":true,"properties":{"current":{"$ref":"#/$defs/role"},"history":{"type":"array","items":{"$ref":"#/$defs/role"},"description":"Ordered most-recent first."}}},"education":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"school":{"type":"string"},"degree":{"type":"string"},"field":{"type":"string"},"start":{"type":"string","description":"ISO date or year."},"end":{"type":"string","description":"ISO date, year, or null."}}}},"projects":{"type":"array","items":{"type":"object","required":["name"],"additionalProperties":true,"properties":{"name":{"type":"string"},"description":{"type":"string"},"url":{"type":"string","format":"uri"},"repo":{"type":"string","format":"uri"},"status":{"type":"string","enum":["active","maintenance","archived","experimental"]},"languages":{"type":"array","items":{"type":"string"}},"highlights":{"type":"array","items":{"type":"string"},"description":"Notable metrics (stars, downloads, users)."}}}},"writing":{"type":"array","description":"Long-form posts, essays, articles, papers.","items":{"type":"object","required":["title"],"additionalProperties":true,"properties":{"title":{"type":"string"},"url":{"type":"string","format":"uri"},"venue":{"type":"string","examples":["dangoldin.com","Medium"]},"published_at":{"type":"string","description":"ISO date."},"topics":{"type":"array","items":{"type":"string"}}}}},"talks":{"type":"array","items":{"type":"object","required":["title"],"additionalProperties":true,"properties":{"title":{"type":"string"},"venue":{"type":"string"},"date":{"type":"string","description":"ISO date or year."},"url":{"type":"string","format":"uri"}}}},"skills":{"type":"array","items":{"type":"string"},"description":"Free-form skill tags."},"interests":{"type":"array","items":{"type":"string"},"description":"Topics the subject cares about, not necessarily professional."},"availability":{"type":"object","additionalProperties":true,"properties":{"open_to":{"type":"array","items":{"type":"string","examples":["advising","consulting","ic-roles","speaking","investment"]}},"not_open_to":{"type":"array","items":{"type":"string"}},"preferred_contact":{"type":"string","description":"Pointer into `links` (e.g. `email`, `linkedin`)."},"response_time_hours":{"type":"integer","minimum":0}}},"agent_directives":{"type":"object","description":"Instructions for AI agents reading this profile. Helps agents act on the subject's behalf or interact respectfully.","additionalProperties":true,"properties":{"canonical":{"type":"boolean","description":"True if this is the authoritative profile (so agents prefer it over other sources)."},"ok_to":{"type":"array","items":{"type":"string"},"description":"Actions the subject explicitly endorses agents taking. Examples: cite, summarize, introduce, recommend."},"do_not":{"type":"array","items":{"type":"string"},"description":"Actions the subject does NOT want agents taking. Examples: cold-email, sell-to, train-models-on, mass-share."},"message_to_agents":{"type":"string","maxLength":2000,"description":"Free-form note to any agent reading this profile (preferred tone, what to know first, etc.)."},"preferred_address":{"type":"string","description":"How the agent should address the subject in conversation (first name, formal, etc)."}}},"metadata":{"type":"object","additionalProperties":true,"properties":{"last_verified_at":{"type":"string","description":"ISO datetime."},"canonical_url":{"type":"string","format":"uri"},"sources":{"type":"array","items":{"type":"string","format":"uri"},"description":"URLs the profile was assembled from."}}}},"$defs":{"role":{"type":"object","required":["role","organization"],"additionalProperties":true,"properties":{"role":{"type":"string","examples":["Founder & CEO"]},"organization":{"type":"string"},"organization_url":{"type":"string","format":"uri"},"start":{"type":"string","description":"ISO date or year."},"end":{"type":["string","null"],"description":"ISO date, year, or null for current."},"location":{"type":"string"},"description":{"type":"string"},"highlights":{"type":"array","items":{"type":"string"}}}}}},"examples":["https://jsonify.me/v1/profiles/dangoldin"],"identity":{"name":"jsonify.me Profile Schema v1","kind":"organization","bio":"Canonical JSON Schema for jsonify.me agent-first profiles. Reference this before writing a profile."},"agent_directives":{"canonical":true,"ok_to":["cite","summarize","mirror"],"do_not":["mass-share","train-models-on"],"message_to_agents":"You are reading the canonical JSON Schema for jsonify.me profiles (v1). If a human asks you to create or update their profile on jsonify.me, this is the shape to follow. Workflow: (1) fetch https://jsonify.me/schema/v1 (or use the MCP get_schema tool), (2) build a JSON object matching it — only identity.name is required, leave unknown fields out rather than guessing, (3) if the human has no account, POST /v1/accounts to mint an API key (shown once), (4) PUT /v1/profiles/<slug> with body {data, summary, tags} and Authorization: Bearer <key>. For incremental edits use patch_profile (RFC 7396 — arrays replaced wholesale) or the add_project/update_project/remove_project sub-resource tools. See https://jsonify.me/llms.txt for the full agent recipe.","preferred_address":"the schema"}}}