{"id":24383874,"url":"https://github.com/cpluspatch/pronouns-wellknown","last_synced_at":"2026-04-04T00:02:53.076Z","repository":{"id":228307365,"uuid":"773621038","full_name":"CPlusPatch/pronouns-wellknown","owner":"CPlusPatch","description":"Protocol draft for a well-known pronouns API","archived":false,"fork":false,"pushed_at":"2024-03-18T05:07:51.000Z","size":8,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-12-30T08:57:18.907Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/CPlusPatch.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2024-03-18T05:00:52.000Z","updated_at":"2025-02-02T20:24:42.000Z","dependencies_parsed_at":"2024-03-18T06:25:55.250Z","dependency_job_id":"4976bfff-525b-4e9e-b422-664927efacb0","html_url":"https://github.com/CPlusPatch/pronouns-wellknown","commit_stats":null,"previous_names":["cpluspatch/pronouns-wellknown"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/CPlusPatch/pronouns-wellknown","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CPlusPatch%2Fpronouns-wellknown","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CPlusPatch%2Fpronouns-wellknown/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CPlusPatch%2Fpronouns-wellknown/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CPlusPatch%2Fpronouns-wellknown/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/CPlusPatch","download_url":"https://codeload.github.com/CPlusPatch/pronouns-wellknown/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CPlusPatch%2Fpronouns-wellknown/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31382355,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-03T23:20:52.058Z","status":"ssl_error","status_checked_at":"2026-04-03T23:20:51.675Z","response_time":107,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-01-19T10:16:23.779Z","updated_at":"2026-04-04T00:02:51.016Z","avatar_url":"https://github.com/CPlusPatch.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# Pronouns in /.well-known Protocol\n\n## 1. Introduction\n\nThe Pronouns in /.well-known protocol provides a standardized way for clients to retrieve pronoun information for users or resources. This protocol allows clients to request pronouns for a specific user or retrieve a default set of pronouns.\n\n## 2. Protocol Specification\n\n### 2.1 Request\n\nClients can send a GET request to the `/.well-known/pronouns` endpoint to retrieve pronoun information. The request can include an optional query parameter `resource` to specify a specific user or resource.\n\nExample request:\n\n```\nGET /.well-known/pronouns HTTP/1.1\nHost: example.com\n```\n\nFor sites of multiple users, you can use an arbitrary string in the params to request a specific one. For example:\n\n```\nGET /.well-known/pronouns?resource=astrid%40example.com HTTP/1.1\nHost: example.com\n```\n\n### 2.2 Response\n\nThe server responds with a JSON object containing pronoun information. The keys of the object are language codes and the values are arrays of pronouns.\n\nISO-639-1 language codes are used to specify the language of the pronouns. For example, the language code for English is `en`. The language code can be further refined with a region code, such as `en-us` for American English.\n\nExample response:\n\n```\nHTTP/1.1 200 OK\nContent-Type: application/json\n\n{\n    \"en-us\": [\"she/her\", \"they/them\", \"it/its\"]\n}\n```\n\nFor English pronouns outside of the usual set (which the protocol might include, but not be limited to: he/him, she/her, they/them, it/its), you can specify every position:\n\n```\nHTTP/1.1 200 OK\nContent-Type: application/json\n\n{\n    \"en-us\": [\n        {\n            \"subject\": \"they\",\n            \"object\": \"them\",\n            \"dependent_possessive\": \"their\",\n            \"independent_possessive\": \"theirs\",\n            \"reflexive\": \"themself\"\n        },\n        {\n            \"subject\": \"xe\",\n            \"object\": \"xem\",\n            \"dependent_possessive\": \"xir\",\n            \"independent_possessive\": \"xirs\",\n            \"reflexive\": \"xirself\"\n        }\n    ]\n}\n```\n\n### 2.3 Error Handling\n\nServers are allowed to respond with a 403 Forbidden status code for this endpoint if the client is not authorized to access the requested resource.\n\n```\nHTTP/1.1 403 Forbidden\nContent-Type: application/json\n\n{\n    \"error\": \"Forbidden\"\n}\n```\n\n## 3. Security Considerations\n\nAs with any protocol that exposes user information, care must be taken to ensure that privacy is maintained. Servers should only provide pronoun information for users who have explicitly opted in to this feature. Additionally, servers should implement appropriate access controls to prevent unauthorized access to user information.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcpluspatch%2Fpronouns-wellknown","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcpluspatch%2Fpronouns-wellknown","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcpluspatch%2Fpronouns-wellknown/lists"}