{"files":{"SKILL.md":"---\nname: twilio-accounts\ndescription: \"Twilio - Accounts API skill. Use when working with Twilio - Accounts for AuthTokens, Consents, Contacts. Covers 20 endpoints.\"\nversion: 1.0.0\ngenerator: lapsh\n---\n\n# Twilio - Accounts\nAPI version: 1.0.0\n\n## Auth\nBearer basic\n\n## Base URL\nhttps://accounts.twilio.com\n\n## Setup\n1. Set Authorization header with Bearer token\n2. GET /v1/Credentials/AWS -- retrieves a collection of aws credentials belonging to the account used to make the request\n3. POST /v1/AuthTokens/Promote -- create first Promote\n\n## Endpoints\n20 endpoints across 6 groups. See references/api-spec.lap for full details.\n\n### AuthTokens\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /v1/AuthTokens/Promote | Promote the secondary Auth Token to primary. After promoting the new token, all requests to Twilio using your old primary Auth Token will result in an error. |\n| POST | /v1/AuthTokens/Secondary | Create a new secondary Auth Token |\n| DELETE | /v1/AuthTokens/Secondary | Delete the secondary Auth Token from your account |\n\n### Consents\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /v1/Consents/Bulk |  |\n\n### Contacts\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /v1/Contacts/Bulk |  |\n\n### Credentials\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /v1/Credentials/AWS | Retrieves a collection of AWS Credentials belonging to the account used to make the request |\n| POST | /v1/Credentials/AWS | Create a new AWS Credential |\n| GET | /v1/Credentials/AWS/{Sid} | Fetch the AWS credentials specified by the provided Credential Sid |\n| POST | /v1/Credentials/AWS/{Sid} | Modify the properties of a given Account |\n| DELETE | /v1/Credentials/AWS/{Sid} | Delete a Credential from your account |\n| GET | /v1/Credentials/PublicKeys | Retrieves a collection of Public Key Credentials belonging to the account used to make the request |\n| POST | /v1/Credentials/PublicKeys | Create a new Public Key Credential |\n| GET | /v1/Credentials/PublicKeys/{Sid} | Fetch the public key specified by the provided Credential Sid |\n| POST | /v1/Credentials/PublicKeys/{Sid} | Modify the properties of a given Account |\n| DELETE | /v1/Credentials/PublicKeys/{Sid} | Delete a Credential from your account |\n\n### Messaging\n| Method | Path | Description |\n|--------|------|-------------|\n| PATCH | /v1/Messaging/GeoPermissions |  |\n| GET | /v1/Messaging/GeoPermissions |  |\n\n### SafeList\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /v1/SafeList/Numbers | Add a new phone number or phone number 1k prefix to SafeList. |\n| GET | /v1/SafeList/Numbers | Check if a phone number or phone number 1k prefix exists in SafeList. |\n| DELETE | /v1/SafeList/Numbers | Remove a phone number or phone number 1k prefix from SafeList. |\n\n## Common Questions\nMatch user requests to endpoints in references/api-spec.lap. Key patterns:\n- \"Create a Promote?\" -> POST /v1/AuthTokens/Promote\n- \"Create a Bulk?\" -> POST /v1/Consents/Bulk\n- \"List all AWS?\" -> GET /v1/Credentials/AWS\n- \"Create a AW?\" -> POST /v1/Credentials/AWS\n- \"Get AW details?\" -> GET /v1/Credentials/AWS/{Sid}\n- \"Delete a AW?\" -> DELETE /v1/Credentials/AWS/{Sid}\n- \"List all PublicKeys?\" -> GET /v1/Credentials/PublicKeys\n- \"Create a PublicKey?\" -> POST /v1/Credentials/PublicKeys\n- \"Get PublicKey details?\" -> GET /v1/Credentials/PublicKeys/{Sid}\n- \"Delete a PublicKey?\" -> DELETE /v1/Credentials/PublicKeys/{Sid}\n- \"List all GeoPermissions?\" -> GET /v1/Messaging/GeoPermissions\n- \"Create a Number?\" -> POST /v1/SafeList/Numbers\n- \"List all Numbers?\" -> GET /v1/SafeList/Numbers\n- \"Create a Secondary?\" -> POST /v1/AuthTokens/Secondary\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- Paginated endpoints accept limit/offset or cursor parameters\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 Twilio - Accounts\n@base https://accounts.twilio.com\n@version 1.0.0\n@auth Bearer basic\n@endpoints 20\n@toc AuthTokens(3), Consents(1), Contacts(1), Credentials(10), Messaging(2), SafeList(3)\n\n@group AuthTokens\n@endpoint POST /v1/AuthTokens/Promote\n@desc Promote the secondary Auth Token to primary. After promoting the new token, all requests to Twilio using your old primary Auth Token will result in an error.\n@returns(200) {account_sid: str?, auth_token: str?, date_created: str(date-time)?, date_updated: str(date-time)?, url: str(uri)?} # OK\n\n@endgroup\n\n@group Consents\n@endpoint POST /v1/Consents/Bulk\n@returns(201) {items: any?} # Created\n\n@endgroup\n\n@group Contacts\n@endpoint POST /v1/Contacts/Bulk\n@returns(201) {items: any?} # Created\n\n@endgroup\n\n@group Credentials\n@endpoint GET /v1/Credentials/AWS\n@desc Retrieves a collection of AWS Credentials belonging to the account used to make the request\n@optional {PageSize: int(int64) # How many resources to return in each list page. The default is 50, and the maximum is 1000., Page: int # The page index. This value is simply for client state., PageToken: str # The page token. This is provided by the API.}\n@returns(200) {credentials: [map], meta: map{first_page_url: str(uri), key: str, next_page_url: str(uri)?, page: int, page_size: int, previous_page_url: str(uri)?, url: str(uri)}} # OK\n\n@endpoint POST /v1/Credentials/AWS\n@desc Create a new AWS Credential\n@returns(201) {sid: str?, account_sid: str?, friendly_name: str?, date_created: str(date-time)?, date_updated: str(date-time)?, url: str(uri)?} # Created\n\n@endpoint GET /v1/Credentials/AWS/{Sid}\n@desc Fetch the AWS credentials specified by the provided Credential Sid\n@required {Sid: str # The Twilio-provided string that uniquely identifies the AWS resource to fetch.}\n@returns(200) {sid: str?, account_sid: str?, friendly_name: str?, date_created: str(date-time)?, date_updated: str(date-time)?, url: str(uri)?} # OK\n\n@endpoint POST /v1/Credentials/AWS/{Sid}\n@desc Modify the properties of a given Account\n@required {Sid: str # The Twilio-provided string that uniquely identifies the AWS resource to update.}\n@returns(200) {sid: str?, account_sid: str?, friendly_name: str?, date_created: str(date-time)?, date_updated: str(date-time)?, url: str(uri)?} # OK\n\n@endpoint DELETE /v1/Credentials/AWS/{Sid}\n@desc Delete a Credential from your account\n@required {Sid: str # The Twilio-provided string that uniquely identifies the AWS resource to delete.}\n@returns(204) The resource was deleted successfully.\n\n@endpoint GET /v1/Credentials/PublicKeys\n@desc Retrieves a collection of Public Key Credentials belonging to the account used to make the request\n@optional {PageSize: int(int64) # How many resources to return in each list page. The default is 50, and the maximum is 1000., Page: int # The page index. This value is simply for client state., PageToken: str # The page token. This is provided by the API.}\n@returns(200) {credentials: [map], meta: map{first_page_url: str(uri), key: str, next_page_url: str(uri)?, page: int, page_size: int, previous_page_url: str(uri)?, url: str(uri)}} # OK\n\n@endpoint POST /v1/Credentials/PublicKeys\n@desc Create a new Public Key Credential\n@returns(201) {sid: str?, account_sid: str?, friendly_name: str?, date_created: str(date-time)?, date_updated: str(date-time)?, url: str(uri)?} # Created\n\n@endpoint GET /v1/Credentials/PublicKeys/{Sid}\n@desc Fetch the public key specified by the provided Credential Sid\n@required {Sid: str # The Twilio-provided string that uniquely identifies the PublicKey resource to fetch.}\n@returns(200) {sid: str?, account_sid: str?, friendly_name: str?, date_created: str(date-time)?, date_updated: str(date-time)?, url: str(uri)?} # OK\n\n@endpoint POST /v1/Credentials/PublicKeys/{Sid}\n@desc Modify the properties of a given Account\n@required {Sid: str # The Twilio-provided string that uniquely identifies the PublicKey resource to update.}\n@returns(200) {sid: str?, account_sid: str?, friendly_name: str?, date_created: str(date-time)?, date_updated: str(date-time)?, url: str(uri)?} # OK\n\n@endpoint DELETE /v1/Credentials/PublicKeys/{Sid}\n@desc Delete a Credential from your account\n@required {Sid: str # The Twilio-provided string that uniquely identifies the PublicKey resource to delete.}\n@returns(204) The resource was deleted successfully.\n\n@endgroup\n\n@group Messaging\n@endpoint PATCH /v1/Messaging/GeoPermissions\n@returns(200) {permissions: any?} # OK\n\n@endpoint GET /v1/Messaging/GeoPermissions\n@optional {CountryCode: str # The country code to filter the geo permissions. If provided, only the geo permission for the specified country will be returned.}\n@returns(200) {permissions: any?} # OK\n\n@endgroup\n\n@group SafeList\n@endpoint POST /v1/SafeList/Numbers\n@desc Add a new phone number or phone number 1k prefix to SafeList.\n@returns(201) {sid: str?, phone_number: str?} # Created\n\n@endpoint GET /v1/SafeList/Numbers\n@desc Check if a phone number or phone number 1k prefix exists in SafeList.\n@optional {PhoneNumber: str # The phone number or phone number 1k prefix to be fetched from SafeList. Phone numbers must be in [E.164 format](https://www.twilio.com/docs/glossary/what-e164).}\n@returns(200) {sid: str?, phone_number: str?} # OK\n\n@endpoint DELETE /v1/SafeList/Numbers\n@desc Remove a phone number or phone number 1k prefix from SafeList.\n@optional {PhoneNumber: str # The phone number or phone number 1k prefix to be removed from SafeList. Phone numbers must be in [E.164 format](https://www.twilio.com/docs/glossary/what-e164).}\n@returns(204) The resource was deleted successfully.\n\n@endgroup\n\n@group AuthTokens\n@endpoint POST /v1/AuthTokens/Secondary\n@desc Create a new secondary Auth Token\n@returns(201) {account_sid: str?, date_created: str(date-time)?, date_updated: str(date-time)?, secondary_auth_token: str?, url: str(uri)?} # Created\n\n@endpoint DELETE /v1/AuthTokens/Secondary\n@desc Delete the secondary Auth Token from your account\n@returns(204) The resource was deleted successfully.\n\n@endgroup\n\n@end\n"}}