{"files":{"SKILL.md":"---\nname: identity-api\ndescription: \"Identity API skill. Use when working with Identity for track#create-identity, track#identity-create-alias, import. Covers 3 endpoints.\"\nversion: 1.0.0\ngenerator: lapsh\n---\n\n# Identity API\nAPI version: 1.0.0\n\n## Auth\nNo authentication required.\n\n## Base URL\nhttps://api.mixpanel.com\n\n## Setup\n1. No auth setup needed\n2. Verify API access with a test request\n3. POST /track#create-identity -- create first track#create-identity\n\n## Endpoints\n3 endpoints across 3 groups. See references/api-spec.lap for full details.\n\n### Track#create-identity\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /track#create-identity | Create Identity |\n\n### Track#identity-create-alias\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /track#identity-create-alias | Create Alias |\n\n### Import\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /import | Merge Identities |\n\n## Common Questions\nMatch user requests to endpoints in references/api-spec.lap. Key patterns:\n- \"Create a track#create-identity?\" -> POST /track#create-identity\n- \"Create a track#identity-create-alia?\" -> POST /track#identity-create-alias\n- \"Create a import?\" -> POST /import\n\n## Response Tips\n- Check response schemas in references/api-spec.lap for field details\n- Create/update endpoints return the modified resource on success\n- Error responses include status codes and descriptions in the spec\n\n## References\n- Full spec: See references/api-spec.lap for complete endpoint details, parameter tables, and response schemas\n\n> Generated from the official API spec by [LAP](https://lap.sh)\n","references/api-spec.lap":"@lap v0.3\n# Machine-readable API spec. Each @endpoint block is one API call.\n@api Identity API\n@base https://api.mixpanel.com\n@version 1.0.0\n@endpoints 3\n@toc track#create-identity(1), track#identity-create-alias(1), import(1)\n\n@group track#create-identity\n@endpoint POST /track#create-identity\n@desc Create Identity\n@returns(200) * `1` - All data objects provided are valid. This does not signify a valid project token or secret. * `0` - One or more data objects in the body are invalid.\n@errors {401: Unauthorized, 403: Forbidden}\n\n@endgroup\n\n@group track#identity-create-alias\n@endpoint POST /track#identity-create-alias\n@desc Create Alias\n@returns(200) * `1` - All data objects provided are valid. This does not signify a valid project token or secret. * `0` - One or more data objects in the body are invalid.\n@errors {401: Unauthorized, 403: Forbidden}\n\n@endgroup\n\n@group import\n@endpoint POST /import\n@desc Merge Identities\n@required {strict: str(0/1)=1 # When set to 1 (recommended), Mixpanel will validate the batch and return errors per event that failed.}\n@optional {project_id: str # The Mixpanel project_id, used to authenticate service account credentials (do not provide if using secret auth).}\n@returns(200) {code: int, num_records_imported: int, status: str} # A 200 response indicates all events were successfully ingested.\n@errors {400: A 400 response indicates that some events failed validation., 401: A 401 response indicates invalid service account credentials.}\n\n@endgroup\n\n@end\n"}}