Identify the key: the project it opens and the label the panel shows. The cheap check before a session starts.
/docs/api/me.txtPOST https://api.pixydesignapp.com/me
Identify the key: which project it opens, and the name it connected under. Not a step of the workflow, pull authenticates by itself, so nothing needs a ping first. This is for the times the question is the identity: an unlabelled key in a config, or a locked answer naming an agent you want to recognise.
Header: X-Pixy-Key carrying the agent key (px_sk_…).
Body: none.
Response:
| field | type | description |
|---|---|---|
name |
string | The label the user sees this agent under, the introduction it connected with. |
project |
object | The project this key opens, and the only one it opens. |
project.id is Main's id as well as the project's, which is what /versions/add takes as from.
{
"ok": true,
"name": "Claude Code, Linguin",
"project": {"id": "0f6a9c31-5d2b-4a77-9c10-8e4b2f5d1a63", "name": "Acme"}
}
Errors: invalid_key, when the key is not one of the project's, or was retired.
Example:
curl -X POST https://api.pixydesignapp.com/me \
-H 'X-Pixy-Key: px_sk_yourkey'