{"files":{"SKILL.md":"---\nname: qualtrics-api\ndescription: \"Qualtrics API skill. Use when working with Qualtrics for survey-definitions, distributions, directories. Covers 8 endpoints.\"\nversion: 1.0.0\ngenerator: lapsh\n---\n\n# Qualtrics API\nAPI version: 0.2\n\n## Auth\nApiKey X-API-TOKEN in header\n\n## Base URL\nhttps://fra1.qualtrics.com/API/v3\n\n## Setup\n1. Set your API key in the appropriate header\n2. GET /distributions -- get distributions for survey\n3. POST /distributions -- create first distribution\n\n## Endpoints\n8 endpoints across 4 groups. See references/api-spec.lap for full details.\n\n### Survey-definitions\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /survey-definitions/{SurveyId} | Get survey |\n\n### Distributions\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /distributions | Get distributions for survey |\n| POST | /distributions | Generate distribution links |\n| GET | /distributions/{DistributionId}/links | Retrieve distribution links |\n\n### Directories\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /directories/{DirectoryId}/mailinglists/{MailingListId}/contacts | Create contact in mailing list |\n\n### Eventsubscriptions\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /eventsubscriptions/ | Triggers when a response is submitted to a qualtrics survey |\n| DELETE | /eventsubscriptions/ | Remove subscription to response event |\n| GET | /eventsubscriptions/{SubscriptionId} | Get event subscriptions |\n\n## Common Questions\nMatch user requests to endpoints in references/api-spec.lap. Key patterns:\n- \"Get survey-definition details?\" -> GET /survey-definitions/{SurveyId}\n- \"List all distributions?\" -> GET /distributions\n- \"Create a distribution?\" -> POST /distributions\n- \"List all links?\" -> GET /distributions/{DistributionId}/links\n- \"Create a contact?\" -> POST /directories/{DirectoryId}/mailinglists/{MailingListId}/contacts\n- \"Create a eventsubscription?\" -> POST /eventsubscriptions/\n- \"Get eventsubscription details?\" -> GET /eventsubscriptions/{SubscriptionId}\n- \"How to authenticate?\" -> See Auth section above\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\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 Qualtrics API\n@base https://fra1.qualtrics.com/API/v3\n@version 0.2\n@auth ApiKey X-API-TOKEN in header\n@endpoints 8\n@toc survey-definitions(1), distributions(3), directories(1), eventsubscriptions(3)\n\n@group survey-definitions\n@endpoint GET /survey-definitions/{SurveyId}\n@desc Get survey\n@required {SurveyId: any # ID of survey (eg. SV_123)}\n@returns(200) Survey data\n\n@endgroup\n\n@group distributions\n@endpoint GET /distributions\n@desc Get distributions for survey\n@required {surveyId: any # The survey for which to load the distributions}\n@returns(200) Distributions\n\n@endpoint POST /distributions\n@desc Generate distribution links\n@required {Distribution link generation options: map: any # Parameters for the link generation}\n@returns(200) OK\n\n@endpoint GET /distributions/{DistributionId}/links\n@desc Retrieve distribution links\n@required {surveyId: any # ID of the survey (eg: SV_123), DistributionId: any # ID of the distribution list}\n@returns(200) Generated list of links\n\n@endgroup\n\n@group directories\n@endpoint POST /directories/{DirectoryId}/mailinglists/{MailingListId}/contacts\n@desc Create contact in mailing list\n@required {DirectoryId: any # ID of the qualtrics directory to create the contact to, MailingListId: any # ID of the mailing list, Contact data: map # Contact data}\n@returns(200) OK - Contact created\n\n@endgroup\n\n@group eventsubscriptions\n@endpoint POST /eventsubscriptions/\n@desc Triggers when a response is submitted to a qualtrics survey\n@required {WebHookData: map # This is the request body of the webhook}\n@returns(200) OK - web hook registered\n\n@endpoint DELETE /eventsubscriptions/\n@desc Remove subscription to response event\n@required {WebHookData: map # This is the request body of the webhook}\n@returns(200)\n\n@endpoint GET /eventsubscriptions/{SubscriptionId}\n@desc Get event subscriptions\n@required {SubscriptionId: any # ID of event subscription - can be obtained from web hook response}\n@returns(200) Event subscriptions\n\n@endgroup\n\n@end\n"}}